Guia do usuário | Chatwoot

Como configurar um canal do Telegram

Abrir em
Ver como Markdown Abrir no ChatGPT Abrir no Claude
A

Antonio Milesi

Última atualização em Jul 10, 2026

Fluxo para configurar o canal do Telegram: adicionar a caixa de entrada, criar o bot no BotFather e obter o token, inserir o token para criar o canal, adicionar agentes e testar enviando uma mensagem ao bot.

Com o canal do Telegram, você atende as conversas do seu bot do Telegram diretamente no Chatwoot. A conexão é feita com um bot criado pelo BotFather e o respectivo token de API.

Antes de começar

  • Tenha o aplicativo do Telegram instalado para conversar com o BotFather.
  • Você precisa ser Administrador para criar caixas de entrada.

Como criar uma caixa de entrada do Telegram

Passo 1. Vá para Configurações → Caixas de Entrada → Adicionar caixa de entrada.

Passo 2. Clique no ícone Telegram.

Passo 3. Crie um novo bot do Telegram usando o BotFather. Ao concluir, o BotFather fornece um token de API para o bot.

Passo 4. Insira o token de API do bot do Telegram e clique em Criar canal do Telegram.

Passo 5. Adicione agentes à sua caixa de entrada do Telegram.

A configuração da caixa de entrada está concluída.

Passo 6. Abra a página de configurações da caixa de entrada e confirme que o nome da caixa corresponde ao nome de usuário do bot criado no BotFather.

Passo 7. Envie uma mensagem para o bot do Telegram e verifique se ela aparece na caixa de entrada do Telegram no Chatwoot.

Perguntas frequentes

O Chatwoot oferece suporte a bots do Telegram no modo comercial (Business Bot)?

Sim. O suporte a bots no modo comercial (Business Mode) do Telegram está disponível a partir do Chatwoot v4.3.0.

Como habilitar o modo comercial?

  1. No @BotFather, execute /business_mode, escolha seu bot e confirme.
  2. Crie uma nova caixa de entrada do Telegram no Chatwoot (Configurações → Caixas de Entrada → Adicionar caixa de entrada → Telegram) e cole o mesmo token do bot.
  3. O Chatwoot detecta automaticamente o modo comercial e registra o webhook correto.
  4. Para melhores resultados, mantenha esse bot comercial em uma caixa de entrada própria, separada de qualquer bot padrão que você já utilize.

Problemas conhecidos com o Business Bot

  • Janela de resposta de 24 horas — o Telegram só permite que o bot (e o Chatwoot) responda dentro de 24 horas após a última mensagem do cliente.
  • Se o usuário já conversou com o mesmo bot fora do modo comercial, as respostas podem parecer vir do bot, e não da conta comercial. Criar um bot e uma caixa de entrada comerciais dedicados evita essa confusão.
  • A API comercial do Telegram é atualmente menos completa que a API de Bot padrão (por exemplo, sem indicadores de digitação e com tipos de mensagem limitados). Ajuste as expectativas de acordo.