Telegram
Conecta un bot de Telegram con validación de credenciales y registro automático del webhook.
Conecta un bot de Telegram con validación de credenciales y registro automático del webhook.
Configuración rápida#
Si Crear con QR está disponible en el conector de Telegram, selecciónalo, escanea el código QR o elige Abrir Telegram, y toca Crear bot en el bot de configuración. Vuelve a Make Agent Fast, revisa el nombre de usuario del bot y selecciona Conectar este bot. No necesitas copiar ningún token. La configuración caduca a los 15 minutos; puedes cancelarla y reiniciarla.
Si la configuración rápida no está disponible, usa Conectar con un token de bot más abajo. Ambos métodos usan las mismas comprobaciones de conexión y la misma confirmación de reemplazo.
El formulario de creación sugiere el nombre visible de tu agente y un nombre de usuario con el formato maf_<agent>_<random>_bot. Ambos son editables; la parte aleatoria reduce las colisiones de nombres, pero Telegram realiza la comprobación final de disponibilidad. Los bots existentes no se renombran.
Tras la creación, el bot de configuración envía un botón Conectar este bot que abre la revisión de conexión autenticada de tu agente. Crear el bot por sí solo no lo conecta. Cuando la confirmación se completa correctamente, Abrir bot te lleva a la conversación para probarlo. /start o /help restablece una configuración activa o muestra botones del panel y de la guía.
Crear y preparar un bot manualmente#
Sigue la Introducción a los bots y la guía de BotFather oficiales de Telegram:
- Abre la cuenta verificada @BotFather en Telegram.
- Ejecuta
/newbot, elige un nombre visible y elige un nombre de usuario único que termine enbot. - Copia el token del bot. Cualquiera que tenga este token controla el bot.
- Opcionalmente, configura en BotFather la foto, la descripción, el texto "Acerca de" y la ayuda de comandos localizada antes del lanzamiento.
El token es para la API de Bot de Telegram; no es un código de inicio de sesión de Telegram, ni un API ID, ni un API hash.
Conectar en Make Agent Fast#
Abre la página Canales del agente, elige Telegram, pega el Token del bot, decide si las respuestas compatibles también deben enviarse por voz y selecciona Conectar.
Make Agent Fast llama a getMe de Telegram para validar el token y mostrar el nombre de usuario del bot. Después llama a setWebhook con la URL HTTPS pública del conector, un token secreto de verificación y message, callback_query y my_chat_member como tipos de actualización aceptados. Las actualizaciones pendientes existentes no se descartan.
Normalmente no se requiere ningún paso manual para el webhook. Detén cualquier servicio de polling antes de conectar. Si el bot tiene otro receptor de webhook, revisa y confirma su reemplazo; Make Agent Fast no lo toma de forma silenciosa. Un agente puede responder en hasta cinco bots de Telegram a la vez; cada bot es su propia conexión. Guardar un bot distinto añade una nueva conexión en lugar de reemplazar la actual. Un bot que ya esté asociado a otro agente debe desconectarse primero allí.
Probar la conversación#
- Abre el enlace
t.medel bot desde una cuenta de Telegram que no sea la del propietario. - Selecciona Iniciar; los bots no pueden iniciar una conversación con un usuario.
- Envía una pregunta de texto basada en el conocimiento.
- Envía una nota de voz si la voz está activada.
- Confirma que llegan las respuestas, que Último mensaje cambia y que el hilo aparece en Conversaciones.
Los mensajes privados son públicos por defecto: los visitantes no necesitan la aprobación del propietario. Las respuestas en grupos están desactivadas hasta que el propietario active Responder en grupos cuando se mencione o se responda al bot. El modo de privacidad de Telegram y los permisos del grupo siguen aplicándose. Prueba primero los mensajes directos.
Comportamiento de la voz#
Telegram admite voz entrante y voz saliente en este conector. La voz entrante se descarga y se transcribe antes del turno del agente. Con Responder con voz activado y un proveedor de voz disponible, Make Agent Fast envía una respuesta de voz o audio además del texto. Si falla la transcripción o la síntesis de voz, pide al usuario que lo intente de nuevo por texto y revisa el error del conector.
Rotar, desactivar o eliminar#
Si el token queda expuesto, genéralo o revócalo de inmediato en BotFather, actualiza el conector con el nuevo token y vuelve a probar. Actualizar las credenciales del mismo bot conserva sus ajustes y su estado de pausa. Reemplazarlo por un bot distinto requiere confirmación y mantiene separado el historial del bot anterior.
Desactivar detiene las respuestas localmente; eliminar archiva la conexión y conserva su historial. Ninguna de las dos acciones borra el bot de Telegram ni llama a deleteWebhook, lo que podría interrumpir un receptor más reciente. Las conexiones archivadas ignoran los mensajes entrantes. Los bots creados con la configuración rápida pueden actualizar sus credenciales tras eventos del ciclo de vida del gestor, pero un bot en pausa permanece en pausa y un cambio de propiedad desactiva la conexión para su revisión.
Solución de problemas#
| Síntoma | Solución |
|---|---|
| El token se rechaza al guardar | Copia el token actual de BotFather; elimina los espacios en blanco y asegúrate de que pertenece a este bot |
| Los mensajes llegan a un servicio anterior | Detén allí el polling, vuelve a conectar aquí y confirma de forma explícita cualquier reemplazo de receptor |
| Los mensajes directos funcionan pero los de grupo no | Activa las respuestas en grupos, menciona al bot o responde a su mensaje, y revisa el modo de privacidad de Telegram y los permisos del grupo |
| El bot no escribe primero a un usuario nuevo | Es el comportamiento esperado de Telegram; pide al usuario que abra el bot y seleccione Iniciar |
| El texto funciona pero la voz falla | Revisa las claves del modelo, de transcripción y de voz, y vuelve a intentarlo con una nota de voz de Telegram compatible |
Nunca pegues un token activo en documentación, código fuente, analítica ni capturas de pantalla de soporte.