Canales
Telegram
Convierte tu agente de IA en un bot de Telegram que la gente pueda encontrar, escribir y con el que pueda chatear, todo de forma automática.
Equipo y comunidadPoner 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.
Antes de comenzar
- Un agente guardado (al menos la sección Perfil guardada en el constructor de agentes).
- 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.
- Abre Telegram y busca @BotFather.
- Inicia un chat con BotFather y envía el comando
/newbot. - 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).
- BotFather te responde con tu token del bot: un pase de acceso seguro y largo. Cópialo.
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
- Abre tu agente en el constructor (Editar en el centro de Agentes).
- Elige Canales en el menú de la izquierda.
- Selecciona Telegram en el grupo Equipo o Comunidad.
- Pega tu token del bot en el campo.
- 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.
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
| Capacidad | Compatible |
|---|---|
| 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
| Problema | Solución |
|---|---|
| El bot no responde | Verifica 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 bot | Pídeles que busquen el nombre de usuario exacto, incluida la terminación bot, en Telegram. |
| El bot responde pero se salta mensajes | Puede haber una respuesta larga aún en curso: el siguiente mensaje se tomará en cuanto el agente termine. |