Saltar al contenido principal

Telegram

TelegramEquipo y comunidad

Poner tu agente en Telegram es como darle su propio contacto en la app: las personas lo buscan, inician un chat y tu agente responde cada mensaje automáticamente. Esta página te guía para crear el bot en Telegram y conectarlo a tu agente de Nirvai.

Exportación del canal de Telegram mostrando un bot conectadoImage: Exportación del canal de Telegram mostrando un bot conectado

Antes de comenzar​

  • Un agente guardado en el Panel de Control de Agentes (al menos el paso de Perfil completado).
  • Una cuenta de Telegram en tu teléfono o computadora.
  • Un token del bot: un pase de acceso seguro que le permite a Nirvai controlar tu bot. Lo obtendrás de Telegram en el siguiente paso.

Paso a paso​

1. Crea el bot en Telegram​

Telegram tiene un ayudante incorporado llamado BotFather que crea bots por ti.

  1. Abre Telegram y busca @BotFather.
  2. Inicia un chat con BotFather y envía el comando /newbot.
  3. Sigue las indicaciones de BotFather:
    • Elige un nombre para mostrar para tu bot (por ejemplo, "Mi Agente de Soporte").
    • Elige un nombre de usuario que termine en bot (por ejemplo, mi_agente_soporte_bot).
  4. BotFather te responde con tu token del bot: un pase de acceso seguro y largo. Cópialo.

Creando un bot de Telegram con BotFatherImage: Creando un bot de Telegram con BotFather

aviso

Mantén tu token del bot en privado. Cualquiera que lo tenga puede controlar tu bot: trátalo como una contraseña.

2. Conecta el bot a Nirvai​

  1. Abre tu agente en el Panel de Control de Agentes.
  2. Haz clic en el nodo Canales.
  3. Selecciona Telegram en la sección de Equipo y comunidad.
  4. Pega tu token del bot en el campo.
  5. Haz clic en Conectar.

Tu bot de Telegram ahora funciona con tu agente de Nirvai. Cualquiera puede encontrarlo buscando el nombre de usuario del bot en Telegram y empezar a chatear de inmediato.

Ingresando el token del bot de Telegram en NirvaiImage: Ingresando el token del bot de Telegram en Nirvai

3. Pruébalo​

Abre Telegram, busca el nombre de usuario de tu bot, envía un breve "hola" y observa cómo tu agente responde.

Qué pasa después de conectarlo​

  • Cada mensaje enviado a tu bot llega a tu agente y obtiene una respuesta automática.
  • El agente atiende un mensaje por chat a la vez: si alguien envía una ráfaga de mensajes mientras todavía está pensando, se ponen en fila y se procesan en orden.
  • Si un usuario envía una foto, un documento o una nota de voz, el agente simplemente responde: no hay un mensaje aparte de confirmación de "subido".

Lo que tu agente puede hacer en Telegram​

CapacidadCompatible
Responder mensajes✓
Enviar mensajes de texto✓
Enviar imágenes✓
Enviar archivos y documentos✓
Enviar audio✓
Enviar botones táctiles✓

Gestionar tu conexión​

  • Eliminar desconecta el bot de Telegram de tu agente. El bot sigue existiendo en Telegram, pero deja de responder hasta que lo reconectes.
  • Para rotar el token del bot, genera uno nuevo en BotFather y pégalo en Nirvai: el anterior deja de funcionar en cuanto lo regeneras.

Solución de problemas​

ProblemaSolución
El bot no respondeVerifica que el token del bot sea correcto y que no se haya regenerado en BotFather. Un token nuevo reemplaza al anterior: pega el más reciente en Nirvai.
"El token del bot ya está en uso"Cada token del bot solo puede activar un agente. Desconéctalo primero del otro agente, o crea un bot nuevo en BotFather.
La gente no encuentra el botPídeles que busquen el nombre de usuario exacto, incluida la terminación bot, en Telegram.
El bot responde pero se salta mensajesPuede haber una respuesta larga aún en curso: el siguiente mensaje se tomará en cuanto el agente termine.

Qué sigue​

  • Conoce todos los lugares donde puede aparecer tu agente en el Resumen de Canales.
  • Configura un asistente estilo compañero de equipo en Slack o un bot comunitario en Discord.