Solução de problemas: Telegram não recebe mensagens

Diagnóstico passo a passo quando as mensagens do Telegram não chegam à Caixa de entrada: token, webhook e bot bloqueado.

Jun 25, 2026

O problema

Você conectou um bot do Telegram, mas as mensagens dos seus clientes não chegam à Caixa de entrada do Omnifox. A causa quase sempre é uma de três: token inválido ou expirado, webhook não registrado, ou o bot bloqueado ou mal configurado. Siga estes passos na ordem.

Antes de começar

  • Você precisa de acesso ao canal em Canais.
  • Tenha o @BotFather à mão no seu Telegram.

Passo 1 — Verifique o token

  1. Acesse Canais e abra o canal do Telegram (ou Conectar canal → Telegram se estiver recriando).
  2. Clique em Verificar token do bot.
  3. Se aparecer "Token de bot inválido", o token expirou ou foi revogado. Peça um novo ao @BotFather com /token, cole-o e salve.

Regenerar um token invalida o anterior: se alguém o alterou no @BotFather, seu canal fica mudo até você atualizar o token.

Passo 2 — Revise o webhook

O Telegram entrega as mensagens ao Omnifox por meio de um webhook. O Omnifox o registra automaticamente ao salvar o canal (campo Webhook URL, "registrada ao salvar").

  1. Salve o canal novamente para forçar o registro do webhook.
  2. Para inspecionar o status do webhook direto no Telegram, abra no navegador: https://api.telegram.org/bot<SEU_TOKEN>/getWebhookInfo
  3. Na resposta, o campo url deve apontar para o domínio do Omnifox. Se url estiver vazio, o webhook não está registrado—salve o canal novamente.
  4. Se last_error_message mostrar um erro (de certificado ou de conexão, por exemplo), anote-o para o suporte.

Causa frequente: usar o mesmo bot em outra ferramenta. O Telegram permite apenas um webhook por bot; se outra plataforma registrou a dela, ela sobrescreve a do Omnifox e as mensagens param de chegar. Use um token/bot exclusivo para o Omnifox.

Passo 3 — O bot está bloqueado ou sem a privacidade correta?

  • Se você ou o cliente bloqueou o bot, o Telegram não entrega as mensagens. Abra o chat com o bot, toque no nome dele e escolha Desbloquear.
  • Em grupos, por padrão o bot só vê mensagens que o mencionam ou que são comandos. Se você espera capturar tudo em um grupo, desative o Group Privacy do bot no @BotFather (/setprivacy → Disable) e adicione o bot ao grupo novamente.
  • Garanta que o cliente tenha iniciado a conversa com /start ao menos uma vez; um bot não pode escrever primeiro para quem nunca falou com ele.

Verificação final

Envie uma mensagem ao bot a partir de outra conta do Telegram. Ela deve aparecer na Caixa de entrada em segundos. Se chegar, o canal está operacional.

Se ainda não funcionar

  • Confirme que o canal está ativo (não pausado) em Canais.
  • Verifique se não há outra integração rodando com o mesmo token.
  • Contate o suporte com o resultado do getWebhookInfo.

Dica: guarde o token em local seguro e não o compartilhe; quem o tiver pode sequestrar o webhook do seu bot.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp