Como criar um bot no Telegram em 2026: BotFather, sem código e Python

Aprenda a criar um bot no Telegram em 2026: faça o cadastro no BotFather, configure respostas com ferramentas no-code ou Python e teste se está tudo funcionando.
HowToCreateABot

Um bot do Telegram pode responder a perguntas, executar comandos e conectar um chat a outros serviços. Para criá-lo, você começa pelo BotFather. Mas, para que ele responda, precisa configurar um fluxo no-code ou criar um programa que processe as mensagens.

Este guia explica como criar um bot no Telegram em 2026: registrar uma conta, obter um token, configurar respostas sem código ou com Python e resolver os erros mais comuns. Vamos começar pelo BotFather e, depois, mostrar as duas formas de criar um bot funcional.

Resumo

Registre o bot pela conta oficial @BotFather e mantenha o token de acesso em segurança.

Um fluxo no-code dá conta de respostas simples; com Python, você controla a lógica personalizada.

O BotFather cria a conta, mas, para responder, o bot precisa de um fluxo ou programa em execução.

Teste /start, /help e uma mensagem de texto em um chat privado antes de publicar o bot.

O que é um bot do Telegram?

Um bot do Telegram é um aplicativo criado para automatizar tarefas, com o qual as pessoas interagem pelo Telegram. Ele pode responder a perguntas, executar comandos ou conectar uma conversa a outro serviço, como explica a visão geral dos bots do Telegram.

Comece com uma única tarefa. Um bot de ajuda pode mostrar instruções para /start e /help. Já um bot de eco repete a mensagem recebida: envie Hello e receba Hello. Isso já basta para testar a conexão antes de adicionar outras funções.

Um bot não é automaticamente um chatbot com IA. Para enviar uma resposta fixa, basta criar uma regra; uma resposta de IA exige integração com um modelo à parte. Já uma Mini App é uma interface web aberta dentro do Telegram — um projeto diferente do bot de texto que vamos criar aqui.

Os bots também fazem parte do ecossistema de anúncios do Telegram: uma plataforma de publicidade no Telegram como a AdsGram veicula campanhas em canais, bots e Mini Apps.

Como criar um bot no Telegram

Crie a conta com o BotFather e, em seguida, escolha entre um fluxo no-code e Python para definir o que o bot vai fazer. O BotFather é a etapa de cadastro, comum às duas opções — não uma terceira forma de criar a lógica da conversa.

Opção

O que você configura

Ideal para começar

O que fica sob sua responsabilidade

BotFather

Conta, perfil e token de acesso

Cadastro obrigatório

Propriedade e configurações da conta

No-code

Gatilhos, condições e respostas

Uma conversa curta e previsível

Fluxo, credenciais e disponibilidade do serviço

Python

Handlers e lógica da aplicação

Regras personalizadas ou integrações

Código, dependências e ambiente de execução

Antes de escolher uma ferramenta para criar bots no Telegram, desenhe uma conversa: mensagem recebida → condição → resposta. Confira se a ferramenta aceita os tipos de mensagem necessários, permite criar ramificações e armazenar dados. Se a conversa tiver muitas exceções, compare o trabalho necessário para alterar as regras num editor visual e no código.

bot-creation-workflow

Registre o bot no BotFather

Acesse o perfil oficial do @BotFather, envie /newbot e siga as instruções para definir um nome de exibição e um nome de usuário. O Telegram explica esse processo de cadastro no tutorial do primeiro bot.

  1. Abra o BotFather pelo link direto acima e toque em Iniciar.
  2. Envie /newbot.
  3. Digite um nome de exibição, como Workshop Help.
  4. Escolha um nome de usuário disponível que termine em bot, como workshop_help_demo_bot.
  5. Guarde o token de acesso em um gerenciador de senhas ou cofre de segredos.
  6. Abra o link do bot para confirmar que consegue aceder ao chat.

O nome de utilizador de exemplo é apenas ilustrativo; a disponibilidade não é garantida. Use letras latinas, números e sublinhados e siga os requisitos de nome de utilizador apresentados pelo BotFather.

Um token de acesso autentica o bot na Bot API. Quem o obtiver poderá controlar o bot, por isso não o publique em capturas de ecrã, repositórios ou documentos partilhados. Se já tiver um bot, abra as opções de gestão do BotFather para obter ou substituir o token. Se for exposto, revogue-o e atualize a aplicação ligada com o novo token.

botfather-registration

Comandos úteis do BotFather

Estes são comandos comuns de configuração, não uma lista completa. Consulte o guia do Telegram para o BotFather e o menu atual do BotFather para ver as definições disponíveis.

Comando

Finalidade

/newbot

Registar um bot

/mybots

Gerir os seus bots

/setname

Editar o nome de apresentação

/setdescription

Descrever o que o bot faz

/setabouttext

Editar a breve biografia do perfil

/setuserpic

Definir a imagem do perfil

/setcommands

Configurar o menu de comandos

/token

Gerar um token de autenticação

Adicione apenas comandos que a sua aplicação realmente processa. Uma opção no menu não cria uma resposta: /help continua a precisar de uma regra de fluxo de trabalho ou de um handler no código.

Crie um bot sem programar

Para criar um bot do Telegram sem programar, ligue o respetivo token a um fluxo de trabalho visual e defina como as mensagens recebidas geram respostas. Veja este exemplo básico com o n8n — uma ferramenta de automatização de terceiros, não um serviço do Telegram.

Comece com uma instância do n8n que possa receber eventos do Telegram. A instalação em servidor próprio também exige configuração, por isso «sem código» não significa «sem configuração». Não parta do princípio de que um plano alojado ou o funcionamento contínuo são gratuitos.

  1. Crie um novo fluxo de trabalho e adicione o Trigger do Telegram.
  2. Crie credenciais do Telegram e introduza o token do BotFather no campo Access Token, seguindo a documentação de credenciais.
  3. Selecione o evento Message no Telegram Trigger.
  4. Adicione uma ação do Telegram com o recurso Message e a operação Send Message.
  5. Defina Chat ID como o ID do chat da mensagem recebida. Se a ação vier diretamente a seguir ao trigger, use a expressão {{ $json.message.chat.id }}.
  6. Defina Text como Olá! O seu bot está ligado. A documentação da ação do Telegram descreve as operações disponíveis.
  7. Inicie um listener de teste e, em seguida, envie uma nova mensagem privada ao bot.
  8. Confirme que recebeu a resposta e publique ou ative o fluxo de trabalho para o utilizar continuamente.

Este exemplo responde deliberadamente com a mesma frase a todas as mensagens. A seguir, adicione uma condição para encaminhar /start para uma mensagem de boas-vindas e /help para as instruções. Defina também o que enviar quando a mensagem não for reconhecida, para não deixar o utilizador à espera.

Se alojar o n8n no seu próprio servidor, o Telegram precisa de um endereço público de webhook HTTPS. Os testes e o ambiente de produção podem substituir o registo de webhook um do outro. Por isso, use um bot de teste separado sempre que alterar um fluxo de trabalho ativo. Consulte o guia de resolução de problemas do n8n para o Telegram.

Crie um bot do Telegram com Python

Use Python se precisar de controlar diretamente as respostas, a validação e as integrações. O exemplo abaixo implementa /start, /help e a repetição de texto, seguindo o padrão de handlers assíncronos do exemplo de python-telegram-bot.

Prepare o projeto

Instale uma versão compatível do Python; Python 3.12 é uma boa opção para este exemplo. A documentação da biblioteca traz informações sobre compatibilidade. Crie uma pasta e um ambiente virtual para manter os pacotes deste projeto separados.

No macOS ou Linux:

mkdir telegram-bot-demo cd telegram-bot-demo
python3 -m venv .venv source .venv/bin/activate
python -m pip install "python-telegram-bot==22.8"

No PowerShell do Windows, use py -m venv .venv,
em seguida, execute .\.venv\Scripts\Activate.ps1 e depois use o mesmo comando de instalação.
Se uma política local impedir a ativação, execute .\.venv\Scripts\python.exe diretamente, em vez de alterar as políticas do sistema só para seguir este tutorial.

Adicione o código do bot

Salve este código como bot.py. O token vem de uma variável de ambiente, não de uma string incluída no controle de versão.

import os

from telegram import Update

from telegram.ext (

Application, CommandHandler, ContextTypes,

MessageHandler, filters,

)


async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):

if update.message:

await update.message.reply_text("Hello! Send text or use /help.")


async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE):

if update.message:

await update.message.reply_text("I repeat text messages. Try sending Hello.")


async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):

if update.message and update.message.text:

await update.message.reply_text(update.message.text)


def main():

token = os.environ.get("TELEGRAM_BOT_TOKEN")

if not token:

raise SystemExit("Set TELEGRAM_BOT_TOKEN before starting the bot.")

app = Application.builder().token(token).build()

app.add_handler(CommandHandler("start", start))

app.add_handler(CommandHandler("help", help_command))

app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

app.run_polling(allowed_updates=["message"])


if __name__ == "__main__":

main()

​

Execute o bot

Configure o token na mesma sessão do terminal e execute python bot.py. No macOS ou Linux, usando bash ou zsh, isso evita digitar o token diretamente em um comando que ficará salvo no histórico do shell:

read -s "TELEGRAM_BOT_TOKEN?Paste bot token: "
zsh export TELEGRAM_BOT_TOKEN python bot.py

No bash, substitua a primeira linha por read -s -p "Paste bot token: " TELEGRAM_BOT_TOKEN.

No PowerShell 7, use $env:TELEGRAM_BOT_TOKEN = Read-Host -MaskInput 'Paste bot token' e depois python bot.py.

Abra o chat privado e teste /start, /help e uma mensagem curta. Interrompa o processo com Ctrl+C. Este código é um ponto de partida para aprendizado: não inclui banco de dados, estado persistente da conversa nem monitoramento de produção.

Mantenha o bot em execução

Execute o aplicativo em um servidor sempre ligado ou mantenha o fluxo sem código ativo no ambiente de hospedagem. Se você fechar o processo local do Python, o bot para de responder.

Long polling significa que seu programa consulta o Telegram para buscar novos eventos. Com um webhook, é o Telegram que envia os eventos para o seu servidor. A referência da Bot API descreve esses dois mecanismos mutuamente exclusivos para receber atualizações. O exemplo em Python usa polling, enquanto o gatilho do n8n usa um webhook.

Antes de transformar um experimento em um serviço compartilhado:

- Mantenha o token nas configurações de secrets da hospedagem e exclua .venv e os arquivos de secrets do Git.
- Execute apenas uma instância de polling por token de bot; evite que outro aplicativo consuma os eventos do mesmo bot.
- Configure a reinicialização automática e investigue as falhas sem registrar secrets nem conteúdo desnecessário das mensagens.
- Armazene fora da memória do processo os dados de conversa que precisam ser mantidos.
- Teste uma reinicialização e confirme que o bot volta a funcionar.

Se o projeto precisar de uma interface web mais adiante, planeje-a separadamente. O guia da AdsGram sobre erros comuns no desenvolvimento de Mini Apps do Telegramé uma leitura complementar para essa etapa.

AdsGram

Comece a Ganhar em 3 Passos

  1. 01Conectar
  2. 02Colocar anúncios
  3. 03Receber pagamento
Monetize agora

Corrija erros comuns de configuração

Se o bot não responder, confira se o aplicativo está em execução e se as atualizações estão sendo entregues antes de alterar o perfil. Siga esta ordem para descobrir se o problema está na conta, no fluxo de trabalho ou no código.

  1. Sem resposta após o cadastro: conecte e inicie o fluxo de trabalho ou o programa; o BotFather, por si só, não o executa.
  2. Variável de ambiente ausente: defina TELEGRAM_BOT_TOKEN no mesmo terminal ou serviço de hospedagem que inicia o Python.
  3. Erro de autenticação: confira se há espaços em branco, se o token está desatualizado ou se as credenciais são de outro bot.
  4. Conflito de polling: encerre os processos duplicados. Se estiver migrando de um serviço com webhook, remova-o intencionalmente com deleteWebhook antes de iniciar o polling. Consulte as perguntas frequentes sobre atualizações do Telegram.
  5. Funciona no chat privado, mas não no grupo: confira o modo de privacidade e teste um comando direcionado ao bot, como /help@your_bot_username.
  6. O comando do menu não faz nada: implemente um handler para esse comando; adicioná-lo no BotFather apenas o torna visível.

Perguntas frequentes

Você pode começar localmente, sem contratar hospedagem. A seguir, respondemos às principais dúvidas sobre cadastro e funcionamento contínuo.

Posso criar um bot do Telegram de graça?

A plataforma básica de bots do Telegram é gratuita, e você pode desenvolver um bot simples em Python no seu próprio computador. Pode haver custos à parte com hospedagem, serviços no-code ou APIs externas. Para começar, teste um bot local que responde a mensagens de texto e confira os custos de qualquer hospedagem ou serviço antes de mantê-lo em funcionamento contínuo.

O BotFather é seguro?

Acesse a conta oficial pelos links da documentação do Telegram ou pelo link direto para @BotFather neste guia. O BotFather é a ferramenta do Telegram para gerenciar bots. Os principais riscos são contas falsas e tokens de acesso expostos. Mantenha o token em sigilo e compartilhe-o apenas com o aplicativo ou serviço em que você confia para operar o bot.

Como pegar um token de bot do Telegram no BotFather?

Envie /newbot para o BotFather oficial e siga as instruções para escolher um nome e um nome de usuário. Em seguida, o BotFather fornecerá o token do bot. Se você já tem uma conta, use as opções de gerenciamento para gerar um token. Guarde-o em segurança e atualize as credenciais do aplicativo sempre que revogar ou substituir o token anterior.

Preciso saber Python para criar um bot do Telegram?

Não. Você pode criar uma resposta básica usando um fluxo visual, sem Python, ou chamar a Bot API com outras linguagens de programação. Escolha a abordagem de acordo com o comportamento desejado e com o que você consegue manter. Uma ferramenta visual pode ser suficiente para uma árvore de decisão simples; validações e integrações mais complexas talvez justifiquem criar seu próprio aplicativo.

Por que meu bot para de funcionar quando fecho o terminal?

Neste exemplo, o terminal executa o processo que recebe mensagens e envia respostas. Quando o processo termina, essa lógica para, embora a conta do bot continue existindo. Para mantê-lo funcionando, implante o programa em um ambiente sempre ativo, com reinicialização automática, ou deixe um fluxo hospedado em execução e confira os registros de execução se as respostas pararem de chegar.

Elizaveta Bydanova
Elizaveta Bydanova
Líder de Desenvolvimento de Negócios, Adsgram

Ler próximo

As últimas notícias da indústria, entrevistas, tecnologias e recursos

Plataforma automatizada tudo-em-um para publicidade eficaz

Comece sua jornada publicitária conosco hoje.