Telegram Webhook
Telegram Webhook conecta tu flujo con un bot de Telegram. Cada vez que alguien escribe al bot, el flujo se ejecuta y recibe el mensaje: el texto, los datos completos del mensaje y, si lo hay, el archivo que se ha enviado (una foto, una nota de voz, un documento, un vídeo…).
Es el punto de partida de un flujo que atiende conversaciones por Telegram, por ejemplo un asistente que responde a tus clientes.
Cuándo usarlo
- Crear un asistente en Telegram que responda las preguntas frecuentes de tus clientes.
- Recibir por Telegram notas de voz de los comerciales y convertirlas en informes.
- Permitir que el equipo envíe fotos de tickets o albaranes al bot para registrarlos.
- Recoger pedidos o solicitudes que llegan por un canal de Telegram de la empresa.
Configuración
El componente necesita una credencial Telegram bot API con el token de tu bot, el que te da Telegram al crearlo con BotFather. Ver Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial del bot de Telegram. |
| Data | Sirve para probar el flujo en el editor: pega aquí un mensaje de ejemplo con el formato en que lo envía Telegram. En producción lo rellena el propio mensaje recibido. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Store Messages | Guarda cada mensaje recibido en el historial de la conversación, para que el flujo recuerde lo que se ha hablado. Activado por defecto. |
Conectar el bot con el flujo
Para que los mensajes del bot lleguen al flujo:
- Despliega una versión del flujo. Ver Versiones y publicación.
- Abre la ventana Acceso a API y ve a la pestaña Telegram.
- En Credencial Telegram, elige la credencial del bot y pulsa Publicar.
A partir de ese momento, los mensajes que reciba el bot ejecutan la versión desplegada del flujo. La pestaña indica Consumido cuando el bot está conectado a este flujo. Con Eliminar lo desconectas.
Resultado
| Salida | Qué entrega |
|---|---|
| Message | El texto que ha escrito la persona; en una foto, un vídeo o un documento, el texto que lo acompaña. También llegan los mensajes editados y las publicaciones de un canal del que el bot forma parte. Cada chat de Telegram se trata como una conversación propia, así que la memoria del flujo no mezcla a unos usuarios con otros. Conéctalo a un agente para responder. |
| Data | Todos los datos del mensaje tal como los envía Telegram: quién lo escribe, en qué chat, la fecha y el contenido. Útil para sacar un dato concreto, como el identificador del chat. |
| Media | El archivo que acompaña al mensaje, si lo hay: foto, nota de voz, audio, documento, vídeo, vídeo redondo, sticker o animación. Conéctalo a un componente que transcriba audio o lea imágenes. |
Ejemplo
Una clínica quiere atender por Telegram las preguntas sobre horarios y servicios:
- Añade Telegram Webhook y elige la credencial del bot de la clínica.
- Conecta Message a un agente con las instrucciones y la información de la clínica.
- Envía la respuesta del agente con Telegram Message, al mismo chat del que llegó el mensaje.
- Despliega el flujo y publícalo en la pestaña Telegram de Acceso a API.
Buenas prácticas
- Cada bot de Telegram solo puede estar conectado a un flujo a la vez. Si lo publicas en otro flujo, deja de enviar mensajes al anterior.
- Prueba primero en el editor con un mensaje de ejemplo en Data antes de publicar.
Componentes relacionados
- Telegram Message: envía mensajes de vuelta al chat de Telegram.
- Webhook Input: recibe datos de cualquier otra aplicación.