Integración con Telegram

La integración de Telegram permite que los chatbots y agentes de IA de Botpress se comuniquen con los usuarios en Telegram a través de la API oficial de bots de Telegram. Facilita la mensajería bidireccional en tiempo real, admitiendo texto, archivos multimedia, botones y comandos interactivos tanto en chats privados como en grupos.

En su funcionamiento interno, la integración utiliza Telegraf, un sólido framework de Node.js, para gestionar el enrutamiento de mensajes, comandos y eventos provenientes de Telegram. Los mensajes enviados por tu agente de IA se formatean automáticamente de Markdown al formato HTML compatible con Telegram, garantizando una visualización perfecta de texto, enlaces y estilos.

Con utilidades integradas para sanear mensajes e indicadores de escritura, esta integración asegura una comunicación limpia, segura y ágil para los usuarios finales. Los desarrolladores pueden usarla para automatizar actualizaciones, gestionar tickets o ampliar sus chatbots a comunidades de Telegram con una configuración mínima.

The Telegram integration allows your AI-powered chatbot to seamlessly interact with Telegram, a popular messaging platform with a large user base. Connect your chatbot to Telegram and engage with your audience in real-time conversations. With this integration, you can automate customer support, provide personalized recommendations, send notifications, and handle inquiries directly within Telegram. Leverage Telegram's rich features, including text messages, inline buttons, media files, and more, to create dynamic and interactive chatbot experiences. Empower your chatbot to deliver exceptional user experiences on Telegram with the Telegram Integration for Botpress.

## Migrating from version `0.x.x` to `1.x.x`

### Removal of proactive conversations (and proactive users)

- Telegram does not currently support proactive conversations, so any bots using this feature will need to be updated to use the normal conversation flow.

### Removal of dedicated Markdown messages type

- The `markdown` channel message type is being deprecated in favor of integrating this behavior into the base `text` message type.
- This new Markdown behavior (commonmark spec) will allow image Markdown. However, since Telegram does not support mixed message types, it will split the message into multiple messages with images sent in between text messages.

### Addition of message limits

- Telegram has a message length limit of 4096 characters, so that limit has been added to the text parameter in the `text` message payload. Going over this limit will result in the message being rejected.

Preguntas frecuentes

¿Qué es la integración de Telegram en Botpress y cómo funciona?

La integración de Telegram en Botpress conecta un chatbot o agente de IA de Botpress con la API oficial de bots de Telegram, permitiendo que las conversaciones se desarrollen directamente en los chats de Telegram. Internamente, la integración utiliza el SDK de Botpress junto con el framework Telegraf para recibir actualizaciones de Telegram y enviar respuestas en tiempo real. Los mensajes entrantes de Telegram se normalizan como eventos de Botpress, de modo que el agente puede aplicar políticas, recuperación de conocimiento y flujos de trabajo igual que en cualquier otro canal. Los mensajes salientes se convierten del formato interno de Botpress a cargas compatibles con Telegram, incluyendo soporte para texto, botones en línea y archivos multimedia cuando corresponde. Una vez configurada con un token de bot y una URL de webhook, la integración gestiona las llamadas a la API y los reintentos, permitiendo que los equipos se concentren en diseñar conversaciones en lugar de preocuparse por las solicitudes HTTP.

¿Cómo se configura la integración de Telegram en Botpress de principio a fin?

La configuración de la integración comienza en Telegram, creando un bot a través de BotFather, que genera un token de bot para acceder a la API de Telegram. En Botpress Studio, la integración de Telegram se instala desde el Hub y luego se configura con este token en los ajustes de la integración. La pantalla de configuración ofrece opciones sencillas como Habilitado (para activar o desactivar la comunicación), URL de webhook (donde Telegram envía las actualizaciones) y el campo del token que autoriza la integración. Una vez guardado, Botpress registra el webhook y comienza a escuchar nuevas actualizaciones, por lo que cualquier mensaje enviado al bot de Telegram aparece como un evento de conversación en el proyecto de Botpress. A partir de ahí, los flujos, políticas y agentes de IA funcionan en las conversaciones de Telegram igual que en webchat u otros canales, proporcionando una arquitectura coherente en toda la plataforma.

¿Qué funciones y tipos de mensajes admite la integración de Telegram para chatbots y agentes de IA?

La integración de Telegram admite mensajes de texto estándar junto con muchas de las funciones avanzadas por las que Telegram es conocido, como botones en línea y archivos multimedia adjuntos. Los mensajes generados por un agente de IA de Botpress se adaptan a los tipos de mensajes de Telegram, permitiendo incluir botones interactivos, flujos tipo respuesta rápida y enlaces que siguen las reglas de formato de Telegram. Los indicadores de escritura están disponibles mediante tarjetas específicas de la integración, permitiendo que el bot muestre que está escribiendo una respuesta y creando una experiencia de chat más natural para los usuarios. Además, la integración expone etiquetas en conversaciones y usuarios, como el ID de conversación o de usuario de Telegram, para que los desarrolladores avanzados puedan relacionar identidades de Telegram con registros de CRM o sistemas internos. Estas capacidades hacen que la integración de Telegram sea adecuada para soporte al cliente, notificaciones proactivas (dentro de las limitaciones de Telegram), gestión de comunidades y escenarios de recuperación automatizada de información.

¿Cómo gestiona la integración de Telegram en Botpress el formato Markdown, HTML y el formateo de mensajes de forma segura?

Telegram admite modos de formato específicos como HTML y Markdown, pero es estricto con las etiquetas y caracteres permitidos. Para garantizar un contenido bien formateado, la integración utiliza un proceso basado en markdown-it para transformar el contenido de Botpress en HTML compatible con Telegram, y emplea sanitize-html para eliminar o escapar etiquetas y atributos no seguros antes de enviar. Este enfoque asegura que títulos, texto en negrita, enlaces y listas se muestren correctamente sin romper los mensajes ni exponer a los usuarios a HTML no confiable. Además, la integración respeta las restricciones de Telegram sobre contenido mixto y longitud de mensajes, dividiendo texto e imágenes en varios mensajes cuando es necesario, para que el contenido complejo de un agente de IA se vea limpio en el cliente de Telegram. Así, los equipos pueden diseñar contenido enriquecido en Markdown en Botpress mientras la integración se encarga de los detalles específicos de formato de Telegram en segundo plano.

¿Cuáles son los casos de uso más comunes para ejecutar un chatbot o agente de IA de Botpress en Telegram?

Un agente de IA conectado a Telegram suele utilizarse para soporte al cliente, interacción con comunidades o mensajería transaccional en canales donde Telegram ya tiene una base de usuarios importante. Muchos equipos emplean la integración para ofrecer soporte instantáneo de autoservicio, automatización de preguntas frecuentes y gestión de tickets directamente en los chats de Telegram, reduciendo la necesidad de portales web o aplicaciones móviles adicionales. Otros la usan para enviar actualizaciones de pedidos, notificaciones de cuentas o anuncios de productos a suscriptores que prefieren Telegram como canal principal de comunicación. Como Telegram admite grupos y supergrupos, la integración también es útil para moderar comunidades, derivar preguntas complejas a agentes humanos mediante políticas de Botpress y recopilar comentarios de usuarios avanzados en tiempo real. Combinada con funciones de Botpress como recuperación de conocimiento, políticas y supervisión humana, la integración de Telegram se convierte en un punto de entrada flexible para cualquier organización que quiera llevar su chatbot o agente de IA a una audiencia ya existente en Telegram.

Mantenido por

Equipo de Botpress

etiquetas

Agente de IA

Chatbot

Chat en vivo

Social

SMS

Notificaciones

Mensajería

Telegram

Preguntas frecuentes

Explora integraciones populares