Gerenciador de webhook
setWebhook com token secreto, allowed_updates, max_connections, IP fixo e certificado autoassinado. Exclua o webhook ou descarte atualizações pendentes com segurança.
Grátis · Código aberto · Bot API 10.3
Telegram Bot Manager: webhooks, comandos e perfil do bot online
Configure, verifique e exclua o webhook do seu bot, edite comandos, nome, descrição, avatar, botão de menu e permissões de administrador — sem escrever código nem rodar scripts.
- Funciona no navegador — sem instalação, sem backend
- Compatível com a Telegram Bot API 10.3 mais recente
- Mostra erros do webhook com dicas de como corrigi-los
Status do webhook
Zona de perigo
Perfil do bot
O nome e as descrições podem ser definidos separadamente para cada idioma do usuário. “Todos os idiomas” é o valor padrão.
Comandos do bot
Os comandos aparecem no botão Menu e ao digitar “/”. Você pode definir listas diferentes para cada escopo e idioma.
Permissões de administrador padrão
Permissões sugeridas aos usuários quando adicionam o bot como administrador. Eles ainda podem alterá-las antes de confirmar.
Ferramentas de desenvolvedor
Respostas brutas da API
Último resultado de cada método get* chamado nesta sessão.
Registro de requisições
Últimas 100 requisições. O token do bot nunca é exibido; tokens secretos são ocultados.
Tudo o que o BotFather não faz, em um só lugar
Verificador getWebhookInfo
Atualizações pendentes, último erro de entrega e erros de sincronização no seu fuso horário — com dicas para SSL, DNS, timeouts e erros HTTP.
Editor de comandos
Edite setMyCommands como texto simples com validação, por escopo (chats privados, grupos, admins, um chat) e por idioma.
Perfil e avatar
Nome, descrição curta e descrição do bot em qualquer idioma. Envie ou remova uma foto ou avatar em vídeo.
Botão de menu
Alterne o botão de menu entre os comandos e seu Mini App (Web App), para todos os chats ou para um só.
Permissões de admin
Permissões de administrador padrão para grupos e canais, incluindo as mais novas da Bot API 10.3.
Ferramentas de dev
Respostas JSON brutas, registro de requisições e um comando curl pronto para copiar em cada ação.
5 idiomas, modo escuro
English, Русский, Español, Português e 简体中文. Temas claro e escuro, funciona no celular.
Como funciona
- Cole o token do botCopie o token do @BotFather e clique em Conectar.
- Verifique o statusWebhook, atualizações pendentes, erros e recursos do bot em uma só tela.
- Altere as configuraçõesEdite e salve — cada ação chama diretamente o método oficial da Bot API.
Seu token fica com você
- Página estática hospedada no GitHub Pages: não há servidor que possa armazenar ou registrar seu token.
- As requisições vão do seu navegador direto para
api.telegram.org(ou para o servidor de API que você escolher). - O token fica apenas nesta aba do navegador, a menos que você marque “Lembrar neste dispositivo”. “Desconectar” o remove.
- Content Security Policy rígida, sem analytics nem scripts de terceiros. O código-fonte é aberto — confira ou hospede sua própria cópia.
Guias
Configurar um webhookConfigure o webhook de um bot do Telegram em poucos cliques: URL HTTPS, token secreto, allowed_updates, max_connections e certificado autoassinado. Com exemplos curl.
Verificar um webhook (getWebhookInfo)Verifique online o webhook do seu bot do Telegram: URL, atualizações pendentes, último erro e o que ele significa. Corrija erros de SSL, DNS, timeout e 4xx/5xx.
Excluir um webhookExclua online o webhook do seu bot do Telegram (deleteWebhook), descarte atualizações pendentes e resolva o erro “409 Conflict” do getUpdates.
Editor de comandosEdite online os comandos do seu bot do Telegram: setMyCommands por escopo e idioma, deleteMyCommands, limites e formato. Grátis e sem código.
Perguntas frequentes
É seguro inserir o token do meu bot aqui?
A página é totalmente estática e não tem backend. O token é usado só no seu navegador para chamar a Telegram Bot API e não é enviado para nenhum outro lugar. Você pode auditar o código aberto ou rodar sua própria cópia. Se achar que o token vazou, revogue-o no @BotFather → /revoke.
Como verifico o webhook do meu bot do Telegram?
Conecte o bot e abra a aba Webhook. Ela chama getWebhookInfo e mostra a URL, o número de atualizações pendentes e o último erro de entrega com o horário e uma dica para corrigi-lo.
Como excluo o webhook e passo a usar getUpdates?
Abra Webhook → Zona de perigo → Excluir webhook. Se quiser, descarte as atualizações pendentes. Depois disso o bot pode receber atualizações com getUpdates (long polling) — caso contrário o Telegram responde “409 Conflict: can't use getUpdates method while webhook is active”.
Por que há atualizações pendentes e o bot não responde?
O Telegram não consegue entregar as atualizações ao seu webhook. Veja o último erro: problemas de SSL, erros de DNS, timeouts ou HTTP 4xx/5xx do seu servidor. Corrija o servidor e, se quiser, descarte a fila.
O que é allowed_updates?
A lista de tipos de atualização que o bot recebe. Por padrão chega tudo, exceto chat_member, message_reaction e message_reaction_count. Para recebê-los, escolha os tipos explicitamente.
Posso definir comandos diferentes para grupos ou outros idiomas?
Sim. Na aba Comandos escolha um escopo (todos os chats privados, todos os grupos, administradores, um chat ou membro específico) e um idioma. O Telegram mostra a cada usuário a lista mais específica.
Aparece “Erro de rede” ao conectar. E agora?
Sua rede, uma extensão do navegador ou seu país pode bloquear api.telegram.org. Abra “Avançado: servidor da API” e use seu próprio proxy (há um modelo gratuito para Cloudflare Workers no repositório) ou um servidor Bot API local.
É grátis? Posso hospedar eu mesmo?
Sim, é grátis e tem licença MIT. Faça um fork do repositório e ative o GitHub Pages, ou rode npm run build e envie a pasta dist para qualquer hospedagem estática.