Intégration Telegram | Botpress Hub

L’intégration Telegram permet aux chatbots et agents IA de Botpress de communiquer avec les utilisateurs sur Telegram via l’API officielle Telegram Bot. Elle offre une messagerie bidirectionnelle en temps réel, prenant en charge le texte, les médias, les boutons et les commandes interactives dans les discussions privées ou de groupe.

En coulisses, l’intégration utilise Telegraf — un framework Node.js robuste — pour gérer l’acheminement des messages, les commandes et les événements provenant de Telegram. Les messages envoyés par votre agent IA sont automatiquement convertis du format Markdown vers la syntaxe HTML acceptée par Telegram, garantissant un affichage parfait du texte, des liens et de la mise en forme.

Grâce à des outils intégrés pour la sécurisation des messages et l’indication de saisie, cette intégration assure une communication propre, sécurisée et réactive pour les utilisateurs finaux. Les développeurs peuvent l’utiliser pour automatiser des notifications, gérer des tickets ou étendre leurs chatbots aux communautés Telegram avec une configuration minimale.

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.

FAQ

Qu’est-ce que l’intégration Telegram de Botpress et comment fonctionne-t-elle ?

L’intégration Telegram de Botpress connecte un chatbot ou agent IA Botpress à l’API officielle Telegram Bot afin que les conversations se déroulent directement dans les discussions Telegram. En arrière-plan, l’intégration utilise le SDK Botpress avec le framework Telegraf pour recevoir les mises à jour de Telegram et envoyer des réponses en temps réel. Les messages entrants sont convertis en événements Botpress, permettant à l’agent d’appliquer des politiques, de récupérer des connaissances et de gérer des workflows comme sur n’importe quel autre canal. Les messages sortants sont transformés du format interne Botpress vers des messages compatibles avec Telegram, incluant le texte, les boutons et les médias si besoin. Une fois le Bot Token et l’URL du webhook configurés, l’intégration gère les appels API et les éventuelles relances, permettant aux équipes de se concentrer sur la conception des conversations plutôt que sur la gestion technique des requêtes HTTP.

Comment l’intégration Telegram est-elle configurée de bout en bout dans Botpress ?

La configuration commence sur Telegram en créant un bot via BotFather, qui génère un Bot Token pour accéder à l’API Telegram Bot. Dans Botpress Studio, l’intégration Telegram s’installe depuis le Hub, puis se configure avec ce Bot Token dans les paramètres de l’intégration. L’écran de configuration propose des options simples comme Activer (pour autoriser la communication), l’URL du webhook (où Telegram envoie les mises à jour) et le champ du token qui autorise l’intégration. Une fois enregistrée, Botpress enregistre le webhook et commence à écouter les nouvelles mises à jour : tout message envoyé au bot Telegram apparaît alors comme un événement de conversation dans le projet Botpress. Dès lors, les flows, politiques et agents IA fonctionnent sur les conversations Telegram exactement comme sur le webchat ou d’autres canaux, assurant une architecture cohérente sur toute la plateforme.

Quelles fonctionnalités et types de messages l’intégration Telegram prend-elle en charge pour les chatbots et agents IA ?

L’intégration Telegram prend en charge les messages texte standards ainsi que de nombreuses fonctionnalités avancées propres à Telegram, comme les boutons intégrés et les pièces jointes média. Les messages générés par un agent IA Botpress sont adaptés aux types de messages Telegram, ce qui permet d’inclure des boutons interactifs, des flows de type réponse rapide et des liens respectant la mise en forme Telegram. Les indicateurs de saisie sont disponibles via des Cartes spécifiques à l’intégration, permettant au bot d’indiquer qu’il rédige une réponse et d’offrir une expérience de chat plus naturelle. L’intégration expose aussi des tags sur les conversations et utilisateurs, comme l’ID de conversation ou d’utilisateur Telegram, pour que les utilisateurs avancés puissent relier les identités Telegram à des fiches CRM ou à des systèmes internes. L’ensemble de ces fonctionnalités rend l’intégration Telegram adaptée au support client, aux notifications proactives (dans les limites de Telegram), à la gestion de communautés et à la récupération automatisée d’informations.

Comment l’intégration Telegram de Botpress gère-t-elle le Markdown, le HTML et la mise en forme des messages en toute sécurité ?

Telegram prend en charge certains modes de mise en forme comme HTML et Markdown, mais impose des restrictions sur les balises et caractères autorisés. Pour garantir un affichage fiable, l’intégration utilise une chaîne de traitement Markdown basée sur markdown-it pour transformer le contenu Botpress en HTML compatible Telegram, et s’appuie sur sanitize-html pour supprimer ou échapper les balises et attributs non sûrs avant l’envoi. Cette méthode assure que les titres, textes en gras, liens et listes s’affichent correctement sans casser les messages ni exposer les utilisateurs à du HTML non fiable. De plus, l’intégration respecte les contraintes de Telegram sur le contenu mixte et la longueur des messages, en divisant le texte et les images en plusieurs messages si nécessaire pour que le contenu complexe d’un agent IA reste lisible dans le client Telegram. Ainsi, les équipes peuvent concevoir du contenu riche en Markdown dans Botpress, tandis que l’intégration gère automatiquement tous les cas particuliers liés à Telegram.

Quels sont les cas d’usage courants pour un chatbot ou agent IA Botpress sur Telegram ?

Un agent IA connecté à Telegram est généralement utilisé pour le support client, l’animation de communauté ou la messagerie transactionnelle dans des canaux où Telegram dispose déjà d’une large audience. De nombreuses équipes utilisent l’intégration pour offrir un support instantané en libre-service, automatiser les FAQ et trier les tickets directement dans les discussions Telegram, réduisant ainsi le besoin de portails web ou d’applications mobiles séparés. D’autres s’en servent pour envoyer des mises à jour de commandes, des notifications de compte ou des annonces produits à des abonnés qui préfèrent Telegram comme canal principal. Comme Telegram prend en charge les groupes et supergroupes, l’intégration est aussi efficace pour modérer des communautés, rediriger les questions complexes vers des agents humains via les politiques Botpress, et recueillir des retours d’utilisateurs avancés en temps réel. Associée aux fonctionnalités Botpress comme la récupération de connaissances, les politiques et l’humain dans la boucle, l’intégration Telegram devient un point d’entrée flexible pour toute organisation souhaitant proposer son chatbot ou agent IA à une audience Telegram existante.

Maintenu par

Équipe Botpress

étiquettes

Agent IA

Chatbot

Chat en direct

Social

SMS

Notifications

Messagerie

Telegram

FAQ

Découvrez les intégrations populaires