Telegram-integratie | Botpress Hub

De Telegram-integratie maakt het mogelijk voor Botpress-chatbots en AI-agenten om te communiceren met gebruikers op Telegram via de officiële Telegram Bot API. Dit zorgt voor tweerichtingsverkeer in real-time, met ondersteuning voor tekst, media, knoppen en interactieve commando’s binnen privéchats of groepen.

Onder de motorkap gebruikt de integratie Telegraf—een krachtig Node.js-framework—om het routeren van berichten, commando’s en gebeurtenissen van Telegram te beheren. Berichten die door je AI-agent worden verstuurd, worden automatisch omgezet van Markdown naar de door Telegram ondersteunde HTML-syntaxis, zodat tekst, links en opmaak altijd correct worden weergegeven.

Met ingebouwde hulpmiddelen voor berichtsanitatie en typindicatoren zorgt deze integratie voor een schone, veilige en responsieve communicatie-ervaring voor eindgebruikers. Ontwikkelaars kunnen hiermee updates automatiseren, tickets afhandelen of hun chatbots eenvoudig uitbreiden naar Telegram-gemeenschappen.

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.

Veelgestelde vragen

Wat is de Botpress Telegram-integratie en hoe werkt het?

De Botpress Telegram-integratie verbindt een Botpress-chatbot of AI-agent met de officiële Telegram Bot API, zodat gesprekken direct binnen Telegram-chats kunnen plaatsvinden. Op de achtergrond gebruikt de integratie de Botpress SDK samen met het Telegraf-framework om updates van Telegram te ontvangen en direct antwoorden terug te sturen. Binnenkomende Telegram-berichten worden omgezet naar Botpress-events, zodat de agent beleid, kennisopvraging en workflows kan toepassen zoals op elk ander kanaal. Uitgaande berichten worden omgezet van het interne Botpress-berichtformaat naar Telegram-compatibele berichten, met ondersteuning voor tekst, inline knoppen en media waar nodig. Na configuratie met een Bot Token en Webhook-URL verzorgt de integratie de technische API-aanroepen en herhalingen, zodat teams zich kunnen richten op het ontwerpen van gesprekken in plaats van het koppelen van HTTP-verzoeken.

Hoe stel je de Telegram-integratie van begin tot eind in binnen Botpress?

Het instellen van de integratie begint in Telegram zelf door een bot aan te maken via BotFather, die een Bot Token genereert voor toegang tot de Telegram Bot API. In Botpress Studio wordt de Telegram-integratie geïnstalleerd vanuit de Hub en vervolgens geconfigureerd met dit Bot Token in de integratie-instellingen. Het configuratiescherm biedt eenvoudige opties zoals Ingeschakeld (om communicatie aan of uit te zetten), Webhook-URL (waar Telegram updates naartoe stuurt) en het tokenveld dat de integratie autoriseert. Na het opslaan registreert Botpress de webhook en begint nieuwe updates te ontvangen, zodat elk bericht aan de Telegram-bot als een gespreksevenement in het Botpress-project verschijnt. Vanaf dat moment werken flows, beleidsregels en AI-agenten op Telegram-gesprekken net zoals op webchat of andere kanalen, wat zorgt voor een consistente architectuur in de hele stack.

Welke functies en berichttypen ondersteunt de Telegram-integratie voor chatbots en AI-agenten?

De Telegram-integratie ondersteunt standaard tekstberichten en veel van de uitgebreide functies waar Telegram om bekend staat, zoals inline knoppen en mediabijlagen. Berichten van een Botpress AI-agent worden omgezet naar Telegram-berichttypen, zodat ze interactieve knoppen, snelle antwoorden en links volgens de Telegram-opmaakregels kunnen bevatten. Typindicatoren zijn beschikbaar via integratie-specifieke Cards, waarmee een bot kan aangeven dat hij een antwoord aan het typen is en zo een natuurlijkere chatervaring biedt. De integratie voegt ook tags toe aan gesprekken en gebruikers, zoals een Telegram-gespreks-ID of gebruikers-ID, zodat geavanceerde gebruikers Telegram-identiteiten kunnen koppelen aan CRM-gegevens of interne systemen. Samen maken deze mogelijkheden de Telegram-integratie geschikt voor klantenservice, proactieve meldingen (binnen de beperkingen van Telegram), communitybeheer en geautomatiseerde informatieopvraging.

Hoe zorgt de Botpress Telegram-integratie voor veilige verwerking van Markdown, HTML en berichtopmaak?

Telegram ondersteunt specifieke opmaakmodi zoals HTML en Markdown, maar is streng in welke tags en tekens zijn toegestaan. Om betrouwbaar opgemaakte inhoud te leveren, gebruikt de integratie een Markdown-verwerkingspipeline op basis van markdown-it om Botpress-inhoud om te zetten naar Telegram-compatibele HTML, en vertrouwt op sanitize-html om onveilige tags en attributen te verwijderen of te ontsnappen voor verzending. Zo worden koppen, vetgedrukte tekst, links en lijsten correct weergegeven zonder berichten te breken of gebruikers bloot te stellen aan onveilige HTML. Daarnaast volgt de integratie de beperkingen van Telegram rond gemengde inhoud en berichtlengte, waarbij tekst en afbeeldingen zo nodig worden opgesplitst in meerdere berichten zodat complexe inhoud van een AI-agent toch netjes in de Telegram-client verschijnt. Hierdoor kunnen teams rijke, op Markdown gebaseerde inhoud ontwerpen in Botpress, terwijl de integratie alle Telegram-specifieke opmaakdetails automatisch afhandelt.

Wat zijn veelvoorkomende toepassingen voor een Botpress-chatbot of AI-agent op Telegram?

Een AI-agent gekoppeld aan Telegram wordt meestal ingezet voor klantenservice, community-engagement of transactionele berichten in kanalen waar Telegram al een groot gebruikersbestand heeft. Veel teams gebruiken de integratie om directe selfservice, FAQ-automatisering en ticketafhandeling rechtstreeks in Telegram-chats te bieden, waardoor aparte webportalen of mobiele apps minder nodig zijn. Anderen gebruiken het om bestellingsupdates, accountmeldingen of productaankondigingen te sturen naar abonnees die Telegram als hun belangrijkste communicatiekanaal verkiezen. Omdat Telegram groepen en supergroepen ondersteunt, is de integratie ook effectief voor communitybeheer, het doorsturen van complexe vragen naar menselijke medewerkers via Botpress-beleidsregels en het in realtime verzamelen van feedback van actieve gebruikers. In combinatie met Botpress-functies zoals kennisopvraging, beleidsregels en human-in-the-loop, is de Telegram-integratie een flexibel startpunt voor elke organisatie die haar chatbot of AI-agent wil inzetten bij een bestaand Telegram-publiek.

Onderhouden door

Botpress Team

Telegram

Veelgestelde vragen

Ontdek populaire integraties