Telegram Bot API Tester

O Bot API Tester permite testar seu bot do Telegram online, direto no navegador: cole o token do bot, escolha qualquer um dos 185 métodos da Bot API 10.3, preencha um formulário de parâmetros tipados e veja a resposta em JSON na hora. É um playground gratuito da Telegram Bot API online e uma alternativa leve ao Postman para verificar o token do bot, depurar requisições e experimentar métodos sem escrever código.

Como testar um bot do Telegram no navegador

1. Crie um bot no @BotFather com /newbot e copie o token (veja como obter o token do bot).
2. Cole o token no campo do topo da página. Ele fica salvo no localStorage do seu navegador.
3. Execute getMe. Um token válido retorna o objeto User do seu bot; 401 Unauthorized indica token errado ou revogado.
4. Escolha um método em uma das 19 categorias ou pela busca — ou abra direto pelo hash da URL, por exemplo telegram-bot-api-tester.html#sendMessage.
5. Preencha os parâmetros (os obrigatórios vêm marcados) e clique em Executar ou pressione Ctrl+Enter.
6. Analise o resultado no visualizador de JSON recolhível e copie o que precisar.

Como verificar o token do bot do Telegram

O getMe funciona como verificador de token: uma única chamada mostra se o token é válido e a qual bot ele pertence (id, first_name, username). Se a resposta for 401 Unauthorized, confira se o token foi copiado inteiro ou gere um novo no @BotFather com /token.

Tarefas comuns

• Descobrir o chat ID. Inicie o long polling, mande uma mensagem para o bot e leia message.chat.id no histórico, que guarda as últimas 100 atualizações. Detalhes em como descobrir o chat ID no Telegram.
• Testar mensagens e formatação. Experimente sendMessage com parse_mode, teclados inline e prévias de links antes de levar tudo para o código; veja como enviar mensagens pela Bot API.
• Gerenciar webhooks. Chame setWebhook, getWebhookInfo e deleteWebhook seguindo o guia de webhook para bots do Telegram.
• Explorar a Bot API 10.x. Mensagens ricas, mensagens efêmeras e os demais recursos novos ficam ao lado dos métodos clássicos, prontos para chamar com o seu token.

Como o getUpdates não funciona enquanto houver um webhook configurado, ao iniciar o long polling o tester chama deleteWebhook primeiro (as atualizações pendentes são mantidas). Se o seu bot usa webhook em produção, restaure-o com setWebhook quando terminar.

Privacidade: o token fica no seu navegador

O tester é uma página estática, sem backend próprio. O token fica no localStorage do navegador, e cada requisição vai direto do seu navegador para api.telegram.org, que aceita CORS. Nem o token nem o tráfego da API passam pelos nossos servidores. Mesmo assim, para experimentos, o mais seguro é usar um bot de teste separado.

Outras ferramentas e referências

Consulte a descrição OpenAPI 3.1 de cada método no Swagger, teste a API JavaScript Telegram.WebApp no Mini App Tester ou abra a referência de métodos, com parâmetros e exemplos em curl, Python e JavaScript.