Você cria um bot do Telegram em duas etapas: primeiro registra a conta com o BotFather e recebe um token; depois conecta esse token a um programa ou a uma ferramenta de automação, como o n8n. O comando /newbot, sozinho, não cria respostas automáticas.
Neste guia, mostro o caminho mais simples para sair do zero, testar o bot e montar uma resposta automática sem escrever código. Também explico quando vale usar a API diretamente, o que muda em grupos e quais cuidados evitam que o token vire um problema de segurança.
O que é um bot do Telegram?
Um bot é uma conta controlada por software. Em vez de uma pessoa tocar na tela para responder, um programa recebe uma atualização do Telegram, toma uma decisão e chama a API para enviar a próxima mensagem. É como um atendente muito rápido, mas que só faz o que você ensinou.
O Telegram Bot Platform permite criar bots para atendimento, notificações, formulários, consulta de dados, pagamentos e integração com outros serviços. O ponto importante é não confundir registro com automação: o BotFather cria a identidade do bot; um backend, script ou plataforma como n8n dá a ele uma função.
O que você precisa antes de começar
- uma conta ativa no Telegram;
- acesso ao usuário oficial @BotFather;
- um objetivo pequeno para o primeiro teste, como responder “olá”;
- um ambiente para executar a automação: n8n hospedado, servidor próprio ou código local.
Se você só quer criar a conta para reservar o nome, os três primeiros itens bastam. Para ter um bot funcional, o próprio FAQ oficial do Telegram explica que é necessário conectá-lo a um servidor ou serviço por meio da API.
Como criar o bot no Telegram pelo BotFather
1. Abra o BotFather e envie /newbot
No aplicativo do Telegram, procure por @BotFather e confirme que está falando com o perfil oficial. Envie /newbot. O assistente pedirá duas informações:
- Nome: o texto exibido nos detalhes do contato. Ele pode ser alterado depois.
- Username: o identificador usado em buscas, menções e links
t.me. Ele deve ter entre 5 e 32 caracteres, usar letras latinas, números ou sublinhado e terminar embot, comoatendimento_jsms_bot.
O username não pode ser alterado depois, de acordo com a documentação de credenciais do n8n. Portanto, escolha algo que não dependa de uma campanha passageira ou de um produto que pode mudar de nome.
2. Copie e proteja o token
Ao finalizar, o BotFather entregará um token parecido com 123456789:AA.... Ele autentica o bot na API — não é a senha da sua conta pessoal, mas deve ser tratado como uma senha. Não publique a chave em tutorial, repositório, planilha compartilhada ou captura de tela.
Se o token escapar, use o BotFather para revogá-lo e gerar outro. Depois, troque a credencial no n8n ou no seu código. Um atacante com essa chave pode agir como o seu bot dentro das permissões disponíveis.
3. Configure comandos úteis
Para melhorar a navegação, use o recurso de comandos do BotFather e cadastre opções como start, ajuda e horarios. Os comandos devem ser curtos e previsíveis. Uma lista enorme não transforma um bot ruim em um bom atendimento; apenas esconde a função principal.
Como automatizar respostas sem programar usando n8n
O n8n é uma opção visual: você conecta blocos em um fluxo e configura as ações em formulários. Ainda é preciso ter uma instância do n8n funcionando e entender a lógica do atendimento, mas não é necessário começar escrevendo um servidor em Python ou JavaScript.
1. Crie a credencial do Telegram
No n8n, crie uma credencial do tipo Telegram API e cole o token gerado pelo BotFather no campo Access Token. A documentação do n8n confirma que a mesma credencial pode autenticar os nós Telegram e Telegram Trigger.
2. Receba uma mensagem
Crie um workflow com o nó Telegram Trigger. No evento, selecione Message, que representa uma nova mensagem recebida. Para o primeiro teste, não baixe arquivos e não filtre por usuário: deixe o caminho mínimo funcionar antes de adicionar regras.
3. Envie a resposta
Adicione o nó Telegram e escolha a operação Send Message. No campo de destino, use o chat.id que veio no evento recebido pelo trigger; no texto, escreva algo como “Recebi sua mensagem. Em que posso ajudar?”. A documentação do n8n lista essa operação e também recursos para editar mensagens, enviar arquivos e consultar chats.
O fluxo básico fica assim:
Telegram Trigger (Message)
↓
Telegram (Send Message)
↓
resposta para o mesmo chatAtive o workflow, abra o bot no Telegram, toque em Start ou envie uma mensagem e confira a execução no n8n. Se nada acontecer, verifique se o workflow está ativo, se o token foi colado sem espaços e se a instância do n8n consegue receber conexões externas. Para entender a lógica de entradas externas, veja também nosso guia sobre como criar um webhook no n8n para receber dados de um formulário.
Como fazer o primeiro teste pela API
Mesmo sem montar um bot completo, você pode confirmar se o token está válido pelo método getMe. No terminal, armazene a chave em uma variável de ambiente e rode:
curl "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getMe"A API responde em JSON com dados do bot quando a autenticação funciona. A documentação do Telegram descreve o Bot API como uma interface HTTP e mostra esse teste no tutorial oficial. Evite substituir a variável pelo token diretamente em comandos salvos no histórico do shell.
Para responder mensagens de verdade, o programa precisa receber atualizações por long polling ou webhook. Esses modos são mutuamente exclusivos: o método getUpdates não funciona enquanto um webhook de saída estiver configurado. Em uma plataforma visual, deixe o próprio nó de trigger cuidar da conexão e consulte os logs quando a entrega falhar.
O que muda quando o bot entra em um grupo?
Em uma conversa privada, o bot recebe as mensagens enviadas diretamente a ele. Em grupos, o Privacy Mode limita o que ele enxerga. Com a privacidade ativada, o bot recebe comandos direcionados a ele, comandos gerais em situações específicas, mensagens enviadas por ele e respostas às suas mensagens. Um bot administrador ou com o modo desativado pode receber mais mensagens, exceto mensagens de outros bots.
Essa limitação é uma proteção, não um defeito. Desative a privacidade somente quando o bot realmente precisar ler o grupo inteiro, como em uma moderação, e avise os participantes. Bots também não devem conversar entre si: o Telegram impede que eles recebam mensagens de outros bots para evitar loops.
Erros comuns ao criar um bot do Telegram
- “O bot foi criado, mas não responde”: o registro não inclui um servidor. Conecte o token ao n8n, a um script ou a outra aplicação.
- Username rejeitado: confira se ele termina em
bot, tem o tamanho permitido e ainda está disponível. - O trigger repete mensagens: não mantenha dois sistemas consumindo atualizações do mesmo bot. Long polling e webhook não devem ser usados ao mesmo tempo.
- O bot não vê mensagens do grupo: revise o Privacy Mode e as permissões de administrador.
- Erro 429: reduza a frequência. O FAQ do Telegram recomenda não enviar mais de uma mensagem por segundo no mesmo chat; em grupos, há limite de 20 mensagens por minuto.
Vale a pena criar um bot no Telegram?
Para uma automação pequena, sim. O conjunto BotFather + n8n resolve notificações, triagem inicial, consulta de status e encaminhamento para uma equipe sem exigir um projeto inteiro. Para um atendimento crítico, porém, trate o fluxo como software: registre erros, limite permissões, proteja dados pessoais e mantenha uma rota para falar com uma pessoa.
A melhor primeira versão é deliberadamente sem graça: um comando, uma entrada e uma resposta. Depois que esse circuito estiver comprovado, adicione botões, banco de dados, IA ou integração com planilhas. Começar pelo “superbot” costuma produzir apenas um fluxo difícil de testar e fácil de quebrar.
Perguntas frequentes
Preciso saber programar para criar um bot no Telegram?
Para registrar a conta no BotFather, não. Para fazê-la responder, você precisa de código ou de uma plataforma visual, como o n8n, que ainda exige configuração de um workflow.
O token do bot pode ser compartilhado?
Não. Ele funciona como uma credencial de acesso à API. Guarde-o em variável de ambiente ou cofre de segredos e revogue-o no BotFather se houver suspeita de vazamento.
Posso usar o mesmo bot no n8n e em um programa próprio?
É possível integrar o bot a diferentes serviços, mas não é uma boa ideia manter dois consumidores de atualizações concorrendo. Escolha uma estratégia de recebimento e centralize o fluxo.
O bot consegue ler tudo em um grupo?
Depende do Privacy Mode, das permissões e do tipo de mensagem. Com a privacidade ativada, ele recebe somente eventos relacionados a ele; para ler mais, pode ser necessário desativar o modo ou torná-lo administrador.