![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.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbkVRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--07ab0947f08591f7d390b519156bb5b38b04c013/1715708407-como-configurar-um-canal-do-telegram.png)

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**](https://telegram.me/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.