> Conecte um bot do Telegram pelo BotFather e atenda pelo mesmo motor do WhatsApp: tools, transferência para especialista, mídia e perfil do bot. # 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. > **Atenção.** > **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. 1. No Telegram, abra uma conversa com **@BotFather**. 2. Envie `/newbot`, escolha o nome que o cliente vai ver e um usuário terminado em `bot` (ex.: `suaempresa_bot`). 3. 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. 4. **Conectar bot** salva e já deixa o bot respondendo no Telegram. 5. Depois de conectado, ajuste nome, descrição e comandos na aba **Perfil do bot**. > **Nota.** > 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**. > **Importante.** > **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. > **Atenção.** > 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](/assinantes/perfis#documento-informado-no-telegram). ## Veja também - [Status e diagnóstico](/configuracoes/integracoes/status) - [Atendimento](/comunicacao/atendimento): onde as conversas acontecem