Integração com o Telegram

A integração com o Telegram permite que chatbots e agentes de IA da Botpress se comuniquem com usuários no Telegram por meio da API oficial do Telegram Bot. Ela possibilita mensagens em tempo real nos dois sentidos, com suporte a texto, mídia, botões e comandos interativos em conversas privadas ou em grupos.

Por trás dos bastidores, a integração utiliza o Telegraf—um framework robusto em Node.js—para gerenciar o roteamento de mensagens, comandos e eventos vindos do Telegram. As mensagens enviadas pelo seu agente de IA são automaticamente formatadas do Markdown para a sintaxe HTML suportada pelo Telegram, garantindo a renderização perfeita de textos, links e formatações.

Com utilitários integrados para sanitização de mensagens e indicadores de digitação, essa integração garante uma comunicação limpa, segura e responsiva para os usuários finais. Os desenvolvedores podem utilizá-la para automatizar atualizações, gerenciar tickets ou expandir seus chatbots para comunidades no Telegram com configuração 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.

Perguntas Frequentes

O que é a integração do Telegram da Botpress e como ela funciona?

A integração do Telegram na Botpress conecta um chatbot ou agente de IA da Botpress à API oficial do Telegram Bot, permitindo que as conversas ocorram diretamente dentro dos chats do Telegram. Nos bastidores, a integração utiliza o SDK da Botpress junto com o framework Telegraf para receber atualizações do Telegram e enviar respostas em tempo real. As mensagens recebidas do Telegram são normalizadas em eventos da Botpress, permitindo que o agente aplique políticas, recuperação de conhecimento e fluxos de trabalho como em qualquer outro canal. As mensagens enviadas são convertidas do formato interno da Botpress para payloads compatíveis com o Telegram, incluindo suporte a texto, botões inline e mídia quando necessário. Após configurar o Bot Token e a URL do Webhook, a integração gerencia as chamadas de API e tentativas automáticas, permitindo que as equipes foquem no design das conversas, sem se preocupar com requisições HTTP.

Como a integração do Telegram é configurada na Botpress do início ao fim?

A configuração da integração começa no próprio Telegram, criando um bot pelo BotFather, que gera um Bot Token para acessar a API do Telegram Bot. No Botpress Studio, a integração do Telegram é instalada pelo Hub e configurada com esse Bot Token nas configurações da integração. A tela de configuração apresenta opções simples como Ativado (para alternar a comunicação), URL do Webhook (para onde o Telegram envia as atualizações) e o campo do token que autoriza a integração. Após salvar, a Botpress registra o webhook e começa a escutar novas atualizações, fazendo com que qualquer mensagem enviada ao bot do Telegram apareça como um evento de conversa no projeto da Botpress. A partir daí, fluxos, políticas e agentes de IA operam nas conversas do Telegram exatamente como no webchat ou em outros canais, garantindo uma arquitetura consistente em toda a plataforma.

Quais recursos e tipos de mensagens a integração do Telegram da Botpress suporta para chatbots e agentes de IA?

A integração do Telegram suporta mensagens de texto padrão e muitos dos recursos avançados conhecidos do Telegram, como botões inline e anexos de mídia. As mensagens geradas por um agente de IA da Botpress são mapeadas para os tipos de mensagem do Telegram, podendo incluir botões interativos, fluxos no estilo de respostas rápidas e links conforme as regras de formatação do Telegram. Indicadores de digitação estão disponíveis por meio de Cards específicos da integração, permitindo que o bot sinalize que está digitando uma resposta e criando uma experiência de chat mais natural para o usuário. A integração também disponibiliza tags em conversas e usuários, como o ID da conversa ou do usuário no Telegram, permitindo que desenvolvedores avancem na correlação de identidades do Telegram com registros de CRM ou sistemas internos. Juntos, esses recursos tornam a integração adequada para suporte ao cliente, notificações proativas (dentro das limitações do Telegram), gestão de comunidades e cenários de busca automatizada de informações.

Como a integração do Telegram da Botpress lida com Markdown, HTML e formatação de mensagens de forma segura?

O Telegram suporta modos específicos de formatação como HTML e Markdown, mas é rigoroso quanto às tags e caracteres permitidos. Para garantir o envio de conteúdo formatado corretamente, a integração utiliza um pipeline de processamento de Markdown baseado no markdown-it para transformar o conteúdo da Botpress em HTML compatível com o Telegram, e utiliza o sanitize-html para remover ou escapar tags e atributos inseguros antes do envio. Essa abordagem garante que títulos, textos em negrito, links e listas sejam exibidos corretamente, sem quebrar mensagens ou expor usuários a HTML não confiável. Além disso, a integração segue as restrições do Telegram quanto a conteúdo misto e tamanho de mensagens, dividindo textos e imagens em várias mensagens quando necessário, para que conteúdos complexos de um agente de IA ainda apareçam de forma limpa no cliente do Telegram. Assim, as equipes podem criar conteúdos ricos em Markdown na Botpress enquanto a integração cuida de todos os detalhes específicos do Telegram em segundo plano.

Quais são os casos de uso mais comuns para rodar um chatbot ou agente de IA da Botpress no Telegram?

Um agente de IA conectado ao Telegram é normalmente utilizado para suporte ao cliente, engajamento de comunidades ou mensagens transacionais em canais onde o Telegram já possui uma base forte de usuários. Muitas equipes usam a integração para oferecer suporte instantâneo de autoatendimento, automação de FAQs e triagem de tickets diretamente nos chats do Telegram, reduzindo a necessidade de portais web ou aplicativos móveis separados. Outras equipes utilizam para enviar atualizações de pedidos, notificações de conta ou anúncios de produtos para assinantes que preferem o Telegram como canal principal de comunicação. Como o Telegram suporta grupos e supergrupos, a integração também é eficaz para moderar comunidades, encaminhar perguntas complexas para agentes humanos via políticas da Botpress e coletar feedback de usuários avançados em tempo real. Combinada com recursos da Botpress como recuperação de conhecimento, políticas e humanos no loop, a integração com o Telegram se torna um ponto de entrada flexível para qualquer organização que queira levar seu chatbot ou agente de IA para o público já existente no Telegram.

Mantido por

Equipe Botpress

Telegram

Perguntas Frequentes

Explorar integrações populares