Telegram
Um canal de atendimento por bot do Telegram. Desde que entrou no mesmo motor do WhatsApp, o Telegram atende com as mesmas capacidades do canal oficial: a IA usa as ferramentas do agente, transfere para um especialista, escala para gente e manda boleto, PIX e arquivo.
Só conversa privada. O bot não atende grupos do Telegram: cada cliente fala com ele 1 a 1, como na maioria dos apps de atendimento.
Onde fica
Menu Loja › Telegram, rota /config/integracoes/telegram. A página tem 4 abas: Visão geral, Credenciais, Perfil do bot e Saúde do bot.
Criar e conectar o bot
O bot é criado no próprio Telegram, pelo @BotFather, e não há nada para registrar em outro lugar.
- No Telegram, abra uma conversa com @BotFather.
- Envie
/newbot, escolha o nome que o cliente vai ver e um usuário terminado embot(ex.:suaempresa_bot). - Copie o token que o BotFather responde (algo como
123456789:AAH…) e cole na aba Credenciais. Verificar token confirma o bot antes de conectar, sem gravar nada. - Conectar bot salva e já deixa o bot respondendo no Telegram.
- Depois de conectado, ajuste nome, descrição e comandos na aba Perfil do bot.
O segredo do webhook é gerado por nós: não há nada para configurar no BotFather além do token.
Aba Visão geral
A aba abre com uma frase: quantas conversas os bots tiveram nos últimos 30 dias e hoje e, quando há, quantos bots precisam de atenção. Ao lado, o link Conectar outro bot leva às Credenciais. Abaixo vem cada bot conectado, separados por uma linha, com:
- Estado ao vivo: lido do Telegram agora, não o carimbo da última configuração: Recebendo mensagens, Precisa de atenção, Token inválido, Sem leitura agora ou Desativado. Um bot com o webhook apontando para outro lugar aparece com o aviso, mesmo que pareça “conectado”.
- @usuário do bot com link para abrir no Telegram e um botão para copiar o link.
- Conversas hoje / 7 dias / 30 dias, última mensagem do cliente e falhas de envio nas últimas 24h.
- Quem abre o atendimento neste bot: escolha qual agente recebe a primeira mensagem de quem escreve ali. Sem escolha, é o agente principal da empresa.
Ações por bot: Testar e reparar (refaz a ligação com o Telegram quando ela está apontando para outro lugar), Trocar token / rótulo, Ativar / Desativar e Remover.
Remover faz o Telegram parar de nos entregar as mensagens do bot e a IA deixa de responder. As conversas que já aconteceram continuam no histórico. Para só pausar sem perder a configuração, use Desativar.
Aba Perfil do bot
O que o cliente vê antes de falar com o bot. Grava direto no Telegram, nada fica só no nosso banco:
| Campo | Limite | Onde aparece |
|---|---|---|
| Nome do bot | 64 caracteres | Nome exibido na conversa |
| ”O que este bot pode fazer?“ | 512 caracteres | Na conversa vazia, antes do cliente tocar em Iniciar |
| Descrição curta | 120 caracteres | No perfil do bot e quando alguém compartilha o link |
| Menu de comandos | até 100 comandos | Atalhos no botão “Menu” do Telegram |
Um comando usa só letras minúsculas, números e _ (até 32 caracteres), com uma descrição obrigatória (até 256 caracteres). O texto que o cliente manda ao tocar num comando chega à IA como uma mensagem normal.
O Telegram limita quantas vezes o nome do bot pode mudar por dia: não fique trocando à toa.
Aba Saúde do bot
Cruza dois pontos de vista, o que o Telegram vê do webhook e o que o nosso atendimento vê:
- No Telegram: se o webhook aponta para nós, quantas atualizações estão esperando entrega, o último erro de entrega e quais tipos de mensagem o bot está recebendo.
- No atendimento: última mensagem do cliente, conversas em 30 dias, falhas de envio nas últimas 24h e a lista das últimas falhas com o motivo.
É a aba que responde “o cliente disse que mandou mensagem e ninguém viu”.
O que a IA entende no Telegram
O mesmo motor do WhatsApp atende aqui: a IA usa as ferramentas do agente, transfere para um especialista, escala para a equipe e manda PIX, boleto e arquivo. Mensagens rápidas em sequência são agrupadas antes de a IA responder, como no WhatsApp. E, diferente do WhatsApp oficial, o Telegram não tem janela de 24 horas: você pode escrever para o cliente a qualquer momento, sem template.
A IA recebe foto, áudio (transcrito), documento, vídeo, sticker, localização, contato, legenda e resposta a mensagem citada. Mensagem com botões é do WhatsApp oficial; no Telegram ela chega como uma lista numerada, e o cliente responde com o número da opção (ex.: 2).
O documento informado não liga a pessoa ao cadastro. Quando o cliente informa CPF ou CNPJ, a IA o atende como titular naquela conversa, e a ficha do contato sugere o cadastro para a equipe confirmar com Vincular. Veja Documento informado no Telegram.
Veja também
- Status e diagnóstico
- Atendimento: onde as conversas acontecem