Telegram#
Você quer oferecer um segundo caminho ao cliente, sem risco de bloqueio e sem custo por mensagem. O Telegram é o canal que se liga em minutos e não depende de aprovação de ninguém.
Antes de começar#
Você precisa de um bot do Telegram e do token dele. Bots são criados pelo BotFather, dentro do próprio Telegram — não pelo Doot.
Como fazer#
- No Telegram, converse com o BotFather e crie um bot. Ele devolve um token.
- No Doot, vá em Configurações → Canais e crie um canal do provedor Telegram Bot API.
- Cole o token.
- Escolha o modo de conexão: polling (padrão) ou webhook.
- Ative o canal.
- Mande uma mensagem ao bot de outra conta e confirme que ela cai na fila.
Polling ou webhook#
Esta é a única decisão técnica do canal, e ela depende inteiramente da sua rede.
| Polling | Webhook | |
|---|---|---|
| Quem procura quem | O Doot pergunta ao Telegram se há mensagem nova | O Telegram entrega a mensagem no seu servidor |
| Precisa de porta aberta? | Não | Sim, com HTTPS válido |
| Funciona atrás de NAT/firewall? | Sim | Só com o endereço publicado |
| Latência | Um pouco maior | Menor |
Use polling quando o servidor não tem endereço público, quando você não quer abrir porta, ou só para começar. É o padrão porque funciona em praticamente qualquer rede.
Use webhook quando o servidor já está publicado com certificado válido e você quer a entrega mais rápida. O Telegram exige HTTPS com certificado confiável — certificado autoassinado é recusado.
O que cada campo significa#
| Campo | O que faz | Quando mudar |
|---|---|---|
| Token | Autentica o bot junto ao Telegram | Se o token vazar; gere outro no BotFather |
| Polling | Liga o modo em que o Doot busca as mensagens | Desligue ao usar webhook |
| URL do webhook | Endereço público que o Telegram vai chamar | Ao trocar de domínio ou certificado |
| Porta do webhook | Porta em que o servidor escuta | Conforme a publicação do seu servidor |
O que o Telegram consegue fazer#
Comandos, mídia e localização. Com fluxo configurado, o bot conduz o menu e transfere para atendente quando o cliente pede — igual aos outros canais. Veja O que é um fluxo.
Se algo der errado#
Nada chega, e o canal aparece ativo. Se estiver em webhook, o Telegram precisa alcançar o seu servidor: confira o certificado e se a porta está publicada. Volte para polling para isolar o problema — se voltar a funcionar, o problema é a publicação.
"Conflito" ou mensagens intermitentes. Dois processos usando o mesmo token ao mesmo tempo. O Telegram entrega a mensagem a um só. Confira se o mesmo token não está cadastrado em outro canal ou em outra instalação.
O bot não responde a quem escreve pela primeira vez. No Telegram, o usuário precisa iniciar a conversa com o bot. O bot não fala primeiro com quem nunca falou com ele.
Token inválido depois de funcionar. Alguém gerou outro token no BotFather; o anterior é revogado na hora.