Telegram Bot API em português
Guias práticos em português para quem desenvolve bots no Telegram: token, chat id, webhook e envio de mensagens, com exemplos em curl, Python e JavaScript. Além disso, ferramentas gratuitas no navegador para chamar qualquer um dos 185 métodos da Bot API 10.3 e testar Mini Apps.
Guias em português
Do zero ao bot em produção: criar o bot, pegar o token e o chat id, configurar o webhook e enviar mensagens pela API.
Como criar um bot no Telegram grátis: do BotFather à primeira mensagem
Aprenda a criar bot no Telegram grátis com o @BotFather: pegue o token, teste com getMe e envie a primeira mensagem com curl e Python.
Como enviar mensagens pela API do Telegram com sendMessage (curl, Python e JavaScript)
Use a API do Telegram para enviar mensagens com sendMessage: exemplos em curl, Python e JavaScript, HTML e MarkdownV2, botões inline e erros comuns.
Telegram bot token: como pegar o token do bot, verificar e revogar
Veja como pegar o token do bot do Telegram no @BotFather, achar o token de um bot existente, testar com getMe e revogar um token vazado.
Como configurar o webhook do bot do Telegram: setWebhook, secret_token e n8n
Configure o webhook do bot do Telegram: requisitos de HTTPS e portas, setWebhook com secret_token, getWebhookInfo, deleteWebhook e erros comuns no n8n.
Chat id do Telegram: como pegar o ID de usuário, grupo, canal e tópico com o seu bot
Descubra o chat id do Telegram para o seu bot: getUpdates em chat privado, grupos, supergrupos (-100), canais e tópicos, e o que fazer se vier vazio.
Ferramentas gratuitas
Bot API Tester
Chame qualquer um dos 185 métodos da Bot API direto do navegador, com formulários de parâmetros, long polling do getUpdates e visualizador de JSON.
Swagger / OpenAPI
Especificação OpenAPI 3.1 de todos os 185 métodos, com autorização pelo token do bot e "Try it out" para executar requisições reais.
Mini App Tester
Teste a API JavaScript Telegram.WebApp no navegador em modo simulado (mock) ou dentro do próprio Telegram, com log de eventos e painel de propriedades.
Perguntas frequentes sobre bots no Telegram
O que é a Telegram Bot API?
É a interface HTTP que o Telegram oferece para bots: você faz requisições HTTPS para api.telegram.org com o token do bot e recebe respostas em JSON. Funciona com qualquer linguagem capaz de fazer requisições HTTP.
Preciso de um servidor para rodar um bot do Telegram?
Para testar, não: com getUpdates (long polling) o bot roda até no seu computador. Para ficar no ar 24 horas, use uma VPS ou um serviço de hospedagem; o webhook exige uma URL HTTPS pública.
Qual linguagem usar para programar um bot do Telegram?
Qualquer uma que faça requisições HTTPS. As mais comuns são Python (python-telegram-bot, aiogram, pyTelegramBotAPI) e Node.js (grammY, Telegraf); em Go há o telebot e o go-telegram-bot-api.
Um bot pode ler todas as mensagens de um grupo?
Por padrão, não: no modo de privacidade ele recebe só os comandos destinados a ele, as respostas às mensagens dele e as mensagens de serviço. Para receber tudo, desative o modo com /setprivacy no @BotFather ou torne o bot administrador.
Estas ferramentas são oficiais do Telegram?
Não. É um projeto independente, sem vínculo com o Telegram. O token fica salvo apenas no localStorage do seu navegador, e as requisições vão direto para api.telegram.org, sem servidores intermediários.