[ajuda] conexões

Telegram de atendimento do zero: bot do negócio, robô 24h e respostas para clientes

Crie no @BotFather um bot novo, só para clientes, com o nome do negócio. Não use o bot dos seus avisos. Cole o token no cartão Telegram — atendimento automático, clique em Salvar conexão e em Testar, e depois em Ligar no robô agora. A partir daí, o robô 24h na sua Cloudflare responde quem escrever para o bot, com as Respostas automáticas e o Atendente IA, mesmo com o computador desligado. É grátis.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

Palavra-chave no Telegram. A pessoa manda AGENDA, PREÇO ou EBOOK para o bot e recebe a resposta, o link ou o material na hora. É a mesma regra que você criou para o WhatsApp e o Direct.
Atendente IA. Quando nenhuma regra casa e o Atendente IA está ligado para o Telegram, a IA responde com o que está na base do seu negócio, qualifica e passa para você na hora certa.
Lead no CRM. A resposta a uma regra do tipo uma pergunta (a resposta vira lead) entra no CRM. Quem a IA qualifica como quente ou morno, ou pede um humano, também.
Aviso para você. Quando a IA passa a conversa para um humano, o aviso chega no seu bot de avisos (Bot do Telegram para avisos no celular), não neste.

Como o robô trata o Telegram:

Responde só conversa privada com o bot. Mensagem em grupo é ignorada.
O Começar do Telegram conta como a primeira mensagem. Uma regra do tipo for a 1ª mensagem responde já nesse toque.
Áudio só é entendido com a transcrição de áudio ligada, que usa a chave da Groq (Chave da Groq (rápida e grátis para começar)) ou da OpenAI (Chave de API da OpenAI (ChatGPT), com crédito pré-pago).
O bot nunca inicia conversa. É regra do Telegram: o bot só fala com quem escreveu antes. Por isso o Telegram não aparece em Campanhas.

Como criar um bot no @BotFather, passo a passo, está em Bot do Telegram para avisos no celular. Aqui fica só o que é do bot de atendimento.

Antes: grátis ou pago

Peça	Custo	Observação
Bot do Telegram	Grátis	A plataforma de bots do Telegram é grátis para quem usa e para quem cria.
Robô 24h na Cloudflare	Grátis	O plano grátis da Cloudflare atende. Veja Cloudflare do zero: conta, 2FA, token do robô 24 horas e o seu domínio.
Atendente IA	Pago à parte, por uso	A IA usa a chave da IA que você escolheu, com o teto de gasto do AFK.

Por que dois bots. O bot de avisos fala com você: lead quente, resumo do dia, quem chamar. O de atendimento fala com cliente. Se fossem o mesmo, o cliente veria os seus avisos, e o Telegram não deixa o mesmo bot receber pelo robô e ser lido pelo painel ao mesmo tempo. O Testar recusa o token do bot de avisos.

Risco. É a API oficial de bots do Telegram: não há risco de bloqueio por automação. O limite do Telegram é de cerca de uma mensagem por segundo na mesma conversa, bem acima do ritmo de um atendimento.

Parte 1: criar o bot de atendimento

No Telegram, abra o @BotFather, confira o selo de verificado e mande /newbot.
Nome: use o nome do negócio, que é o que o cliente vê. Exemplo: Minha Empresa.
Usuário: tem que terminar em bot. Use algo fácil de divulgar, por exemplo minhaempresa_bot. Ele vira o link t.me/minhaempresa_bot.
Copie o token que o BotFather responde, no formato 1234567890:AAH....
Deixe o bot com cara de negócio. Ainda no BotFather:
- /setuserpic: a foto do bot. Use o logo.
- /setdescription: o texto que o cliente vê antes de apertar Começar (até 512 caracteres). Exemplo: Atendimento da Minha Empresa. Mande AGENDA para marcar horário.
- /setabouttext: a frase curta do perfil (até 120 caracteres).

Parte 2: publicar o robô 24h

O bot de atendimento só responde pelo robô 24h na sua Cloudflare.

Se ainda não publicou o robô, siga Cloudflare do zero: conta, 2FA, token do robô 24 horas e o seu domínio. Em Respostas automáticas, o cartão Robô 24h tem que estar no ar.
Crie ao menos uma regra: em Respostas automáticas → Regras, crie a regra e, em Onde, escolha Telegram ou Todos os canais.
Clique em Publicar regras no robô.

Parte 3: colar no AFK e ligar ao robô

No painel do AFK, abra Conexões, clique no cartão Telegram — atendimento automático, cole em Token do bot de atendimento, clique em Salvar conexão e depois em Testar.
O teste responde Bot @minhaempresa_bot aceito. e explica que nada chega para você agora. É normal: este bot fala com clientes.
Clique em Ligar no robô agora, que aparece depois do teste. O AFK leva o token para o robô e manda o Telegram entregar as mensagens do bot para ele. O mesmo botão existe em Respostas automáticas → Ligar canais, com o nome Ligar o Telegram.
Abra o seu bot no Telegram, aperte Começar e mande a palavra de uma regra. A resposta tem que chegar em segundos.
Para a IA responder o que as regras não cobrem: em Respostas automáticas → Atendente IA, marque Telegram em Onde ele atende e clique em Publicar no robô 24h.

Onde o token fica. No .env da pasta do AFK e no robô 24h, que precisa dele para responder. Ele não aparece na conversa. Quem tem o token responde no lugar do seu negócio. Nunca cole em chat, print ou WhatsApp.

No dia a dia

Você quer	Como
Divulgar o bot	Use o link `t.me/minhaempresa_bot` na bio, no site e no cartão.
Criar uma resposta nova	Respostas automáticas → Regras, com Onde em Telegram ou Todos os canais, e Publicar regras no robô.
Ligar a IA no Telegram	Diga ao AFK "quero a IA respondendo no Telegram também". Ou marque Telegram em Atendente IA e publique.
Trazer os leads agora	Respostas automáticas → cartão Robô 24h → Trazer leads pro CRM. Com o painel aberto, isso também acontece sozinho.
Ver se o Telegram está chegando	Respostas automáticas → Ligar canais: o passo de mandar um "oi" mostra a hora da última mensagem do Telegram.
Trocar o token	No BotFather, `/token` gera um token novo. Cole o novo no cartão, salve, clique em Testar e em Ligar no robô agora.
Desligar o atendimento no Telegram	No cartão, clique em Desconectar e confirme. O AFK apaga o token do `.env`, mas o robô 24h ainda guarda uma cópia. Para o bot parar na hora, gere um token novo no BotFather com `/token` e não cole em lugar nenhum.

Se o token vazar: no BotFather, mande /token, escolha o bot e copie o token novo. Cole no AFK, salve e clique em Ligar no robô agora.

Erros e soluções

O que aparece	O que fazer
`Token com formato inválido.`	Faltou um pedaço. Copie de novo a linha inteira do BotFather, no formato `1234567890:AAH...`.
`Esse é o bot dos seus ALERTAS. Crie outro bot no @BotFather pra atender clientes — senão o cliente recebe seus avisos.`	Crie outro bot (Parte 1) e cole o token dele.
`O serviço recusou a chave (inválida, revogada ou sem permissão).`	O token foi trocado no BotFather. Pegue o atual com `/token` e cole por cima.
`Publique o robô 24h primeiro (botão acima).`	Siga Cloudflare do zero: conta, 2FA, token do robô 24 horas e o seu domínio e publique o robô.
`Cole o token do bot de atendimento em Conexões → Telegram — atendimento automático.`	Faça o passo 1 da Parte 3 antes de Ligar o Telegram.
`Senha de verificação ausente ou inválida — republique o robô.`	Publique o robô de novo (Cloudflare do zero: conta, 2FA, token do robô 24 horas e o seu domínio) e clique em Ligar no robô agora.
`O Telegram recusou: ...`	Leia o motivo depois dos dois pontos. Se fala de token, troque o token. Se fala do endereço, republique o robô.
`Não consegui falar com o Telegram agora.`	Internet ou Telegram fora. Tente de novo em alguns minutos.
O bot não responde nada	Confira, nesta ordem: clicou em Ligar no robô agora; a regra está ligada, com Onde em Telegram ou Todos os canais; clicou em Publicar regras no robô.
Responde a palavra, mas não responde pergunta livre	O Atendente IA não está marcado para o Telegram, ou não foi publicado. Faça o passo 5 da Parte 3.
Trocou o token e o bot ficou mudo	O robô ainda tem o token antigo. Clique em Ligar no robô agora.
Ninguém responde no grupo	O robô só atende conversa privada com o bot.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o token.

Fontes oficiais (conferido em 30/10/2026): core.telegram.org/bots (plataforma grátis para usuários e desenvolvedores; bot não inicia conversa, o usuário escreve antes) · core.telegram.org/bots/features (/setdescription até 512 caracteres, /setabouttext até 120, /setuserpic, /token gera token novo) · core.telegram.org/bots/faq (envio grátis; cerca de uma mensagem por segundo por conversa; getUpdates não funciona com webhook ativo) · core.telegram.org/bots/api#setwebhook (secret_token no cabeçalho X-Telegram-Bot-Api-Secret-Token; allowed_updates).

trilha Atender clientes sozinho · passo 6 de 6

último passoVer a trilha e marcar o que já fez

ainda não tem o AFK?

Com o bot de atendimento ligado, o robô 24h do AFK responde no Telegram com as mesmas regras e o mesmo Atendente IA do WhatsApp, com o computador desligado.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.