Telegram
Seu assistente pode responder no Telegram usando a mesma base de conhecimento, voz e SmartFlows que utiliza em outros lugares. Você cria um bot com o @BotFather oficial do Telegram, cola seu token no AI SmartTalk e está ao vivo — nós registramos o webhook para você, sem configuração de servidor.
Conecte-o
Passo 1 — Crie um bot com @BotFather
- Abra @BotFather no Telegram.
- Envie
/newbote siga as instruções para nomear seu bot e escolher um nome de usuário. - O BotFather responde com um token de API HTTP que se parece com
123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.
Trate este token como uma senha — qualquer pessoa que o tiver pode controlar seu bot.
Passo 2 — Cole o token no AI SmartTalk
- No admin, abra seu assistente e vá para Integrações → Telegram.
- Cole o token no campo Bot Token e salve.
É isso. Nós verificamos o token com o Telegram, registramos o webhook automaticamente e seu bot fica ao vivo instantaneamente. O cartão conectado mostra o @username do seu bot com um selo Ao vivo e um link Abrir chat.
Envie uma mensagem para seu bot no Telegram — ele responde sozinho.
O que o assistente pode fazer no Telegram
- Responder a qualquer mensagem de texto, no idioma do cliente (detectado automaticamente)
- Entender fotos que os clientes enviam — elas são analisadas por visão e o assistente responde sobre o que está na imagem (uma legenda enviada com a foto é levada em consideração)
- Transcrever notas de voz e mensagens de áudio — o assistente responde ao pedido falado como se tivesse sido digitado
- Responder a perguntas frequentes e gerenciar sua base de conhecimento como em qualquer outro canal
As conversas aparecem na Caixa de entrada unificada, marcadas com o ícone do Telegram. Fotos e mensagens de voz também são armazenadas lá, para que você possa revisitá-las.
O que não é lido: documentos que não são imagens (PDF, planilhas…), adesivos, locais e vídeos. O assistente simplesmente ignora esses e espera por uma mensagem que possa agir.
Chats em grupo: o bot funciona em grupos, mas o modo de privacidade padrão do Telegram significa que ele só recebe mensagens onde é @mencionado ou respondido. Desative o modo de privacidade no @BotFather (
/setprivacy) se você quiser que ele veja todas as mensagens.
As respostas do Telegram são texto simples — sem formatação markdown. O assistente se adapta automaticamente. Respostas mais longas que o limite de 4096 caracteres do Telegram são cortadas para caber.
Personalize o fluxo
O fluxo padrão — AI lê, AI responde — funciona imediatamente. Para um controle mais fino (regras de escalonamento, comportamento fora do horário, respostas diferentes por bot), envolva-o em um SmartFlow com o gatilho Chat Service.
→ Gatilho Chat Service · Introdução ao SmartFlow
O que você precisa do seu lado
- Uma conta do Telegram para conversar com o @BotFather
- Um token de bot (gratuito, criado em menos de um minuto)
- Nada mais — sem conta de desenvolvedor, sem URL de webhook para copiar, sem servidor para configurar.
Pausar ou desconectar
Desconecte-se da página de integração do Telegram a qualquer momento. Removemos o webhook do seu bot para que ele pare de receber mensagens; o histórico de conversas permanece na sua Caixa de entrada. O bot em si continua existindo no Telegram — reconecte-se a qualquer momento colando o token novamente.
Solução de problemas
| Sintoma | Causa provável |
|---|---|
| "Este token de bot foi rejeitado" ao salvar | O token está digitado incorretamente ou foi redefinido no @BotFather — copie-o novamente |
| O bot não responde | A integração está pausada ou o bot foi conectado a outro assistente — um token de bot serve para um assistente |
| Respostas parecem cortadas | A resposta excedeu o limite de 4096 caracteres do Telegram e foi cortada |
Relacionados
- Discord — outro canal baseado em bot
- WhatsApp — para clientes no Meta
- Caixa de entrada — leia e responda em todos os canais
- Biografia — a voz da IA