Cómo conectar Telegram a Flowti

Conecta Telegram a Flowti para recibir mensajes mediante un bot y gestionar las conversaciones con tus flujos y agentes de IA.

En esta guía crearás un bot utilizando el BotFather oficial de Telegram, copiarás su token y lo usarás para habilitar una nueva conexión de Telegram en Flowti.

Antes de comenzar

Asegúrate de tener:

• Acceso a tu cuenta de Flowti.
• La aplicación de Telegram instalada o acceso a Telegram Web.
• Una cuenta de Telegram con la que puedas crear y administrar bots.
• Un flujo y un agente activos en Flowti si deseas que el bot responda automáticamente durante la prueba final.

Importante: El token de tu bot de Telegram es una credencial privada. Cualquier persona que tenga acceso a este token podría controlar el bot. Nunca lo publiques, lo incluyas en capturas de pantalla ni lo compartas con personas no autorizadas.

1. Abre el módulo Conexiones en Flowti

Desde el panel principal de Flowti, abre el módulo Conexiones desde la barra lateral izquierda. En esta página encontrarás todos los canales de comunicación conectados actualmente a tu cuenta.

Haz clic en New connection (Nueva conexión), en la esquina superior derecha.

2. Selecciona Telegram

En la página Create connection (Crear conexión), busca y selecciona Telegram. La tarjeta de Telegram aparecerá resaltada cuando esté seleccionada.

Haz clic en Next (Siguiente) para continuar.

3. Revisa el formulario de conexión de Telegram

Flowti mostrará la información necesaria para conectar tu bot de Telegram:

• Bot token (Token del bot): El token privado generado por BotFather.
• Visible name (Nombre visible): El nombre que identificará esta conexión dentro de Flowti. Este campo es opcional; si lo dejas vacío, Flowti utilizará el nombre del bot.

En el lado derecho también encontrarás un resumen con las instrucciones de configuración. Mantén abierta esta página de Flowti mientras creas el bot en Telegram.

4. Busca el BotFather oficial en Telegram

Abre Telegram y busca BotFather.

Selecciona la cuenta oficial verificada cuyo nombre de usuario es @BotFather. Revisa cuidadosamente el nombre de usuario y la insignia de verificación, ya que pueden existir otras cuentas con nombres similares.

Abre la conversación o la pantalla de administración de BotFather.

5. Crea un nuevo bot de Telegram

Dentro de BotFather, selecciona Create a New Bot (Crear un nuevo bot). Si Telegram muestra la conversación tradicional de BotFather, envía el comando /newbot.

BotFather te solicitará dos datos:

1. Nombre del bot: Escribe el nombre público que tendrá el bot, por ejemplo, Soporte Flowti.
2. Nombre de usuario: Escribe un nombre de usuario único. Debe terminar en bot, por ejemplo, flowti_soporte_bot.

Cuando el nombre de usuario sea aceptado, BotFather creará el bot y pondrá a tu disposición su token de API.

6. Copia el token del bot

Abre en BotFather el bot que acabas de crear. Busca su token de API y pulsa Copy (Copiar).

El token normalmente tiene un formato similar al siguiente:

123456789:AAEjemploDelToken

No copies espacios antes o después del token y no lo compartas públicamente.

7. Conecta el bot a Flowti

Regresa al formulario de conexión de Telegram en Flowti y completa los siguientes campos:

1. Pega el token en Bot token (Token del bot).
2. Escribe un Visible name (Nombre visible) para identificar la conexión dentro de Flowti. Puedes dejarlo vacío si prefieres utilizar el nombre del bot de Telegram.
3. Haz clic en Connect Telegram (Conectar Telegram).

Flowti validará el token y configurará automáticamente el webhook. No necesitas configurar manualmente ningún webhook en Telegram.

8. Verifica la conexión y prueba el bot

Una vez creada la conexión, Flowti te llevará nuevamente a la página Conexiones. Tu conexión de Telegram deberá aparecer con el estado verde Connected (Conectado).

Para probarla:

1. Abre Telegram desde una cuenta diferente a la que utilizaste para crear el bot.
2. Busca el bot mediante el nombre de usuario que configuraste en BotFather.
3. Abre el bot y pulsa Start (Iniciar) si es la primera vez que conversas con él.
4. Envía un mensaje de prueba.
5. Confirma que la conversación aparezca en Flowti y, si asignaste un flujo y un agente activos a esta conexión, verifica que el bot responda correctamente.

Solución de problemas

Flowti indica que el token no es válido

Copia nuevamente el token directamente desde BotFather y verifica que no tenga espacios ni caracteres faltantes. Si el token fue revocado, genera uno nuevo en BotFather y utiliza el nuevo token en Flowti.

El bot no responde

Asegúrate de haber pulsado Start (Iniciar) antes de enviar el primer mensaje. También verifica que la conexión de Telegram esté asignada a un flujo activo de Flowti y que tenga un agente configurado para responder.

El nombre de usuario del bot no está disponible

Los nombres de usuario de los bots de Telegram deben ser únicos y terminar en bot. Prueba una opción más específica, como el nombre de tu empresa seguido de _soporte_bot.

El token quedó expuesto

Revoca inmediatamente el token expuesto desde BotFather, genera uno nuevo y actualiza o vuelve a conectar el canal de Telegram en Flowti.

Siguiente paso

Tu canal de Telegram ya está conectado. Ahora puedes utilizarlo dentro de un flujo de Flowti para que tu agente de IA reciba y responda las conversaciones provenientes de Telegram.