Telegram

Setting up the integration starts in Telegram itself by creating a bot through BotFather, which generates a Bot Token for accessing the Telegram Bot API. In Botpress Studio, the Telegram integration is installed from the Hub, then configured with this Bot Token in the integration settings. The configuration screen exposes a simple set of options such as Enabled (to toggle communication), Webhook URL (where Telegram sends updates), and the token field that authorizes the integration. Once saved, Botpress registers the webhook and begins listening for new updates so any message sent to the Telegram bot appears as a conversation event in the Botpress project. From that point forward, flows, policies, and AI agents operate on Telegram conversations exactly as they do on webchat or other channels, giving a consistent architecture across the stack.

The Telegram integration supports standard text messages along with many of the rich features Telegram is known for, such as inline buttons and media attachments. Messages produced by a Botpress AI agent are mapped into Telegram’s message types so they can include interactive buttons, quick reply–style flows, and links that follow Telegram’s formatting rules. Typing indicators are available through integration-specific Cards, allowing a bot to signal that it is composing a response and create a more natural chat experience for end users. The integration also exposes tags on conversations and users, such as a Telegram conversation ID or user ID, so advanced builders can correlate Telegram identities with CRM records or internal systems. Together, these capabilities make the Telegram integration suitable for customer support, proactive-style notifications (within Telegram’s limitations), community management, and automated information retrieval scenarios.

Telegram supports specific formatting modes such as HTML and Markdown, but it is strict about which tags and characters are allowed. To deliver reliably formatted content, the integration uses a Markdown processing pipeline based on markdown-it to transform Botpress content into Telegram-compatible HTML, and relies on sanitize-html to strip or escape unsafe tags and attributes before sending. This approach ensures that headings, bold text, links, and lists render correctly without breaking messages or exposing users to untrusted HTML. On top of that, the integration follows Telegram’s constraints around mixed content and message length, splitting text and images into multiple messages where necessary so complex content from an AI agent still appears cleanly in the Telegram client. As a result, teams can design rich, Markdown-based content in Botpress while the integration takes care of all the Telegram-specific formatting edge cases in the background.

A Telegram-connected AI agent is typically used for customer support, community engagement, or transactional messaging in channels where Telegram already has a strong user base. Many teams use the integration to provide instant self-service support, FAQ automation, and ticket triage directly in Telegram chats, reducing the need for separate web portals or mobile apps. Others rely on it to send order updates, account notifications, or product announcements to subscribers who prefer Telegram as a primary communication channel. Because Telegram supports groups and supergroups, the integration is also effective for moderating communities, routing complex questions to human agents via Botpress policies, and capturing feedback from power users in real time. Combined with Botpress features like knowledge retrieval, policies, and human-in-the-loop, the Telegram integration becomes a flexible entry point for any organization that wants to bring its chatbot or AI agent into an existing Telegram audience.