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.
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
- Acesse Canais e abra o canal do Telegram (ou Conectar canal → Telegram se estiver recriando).
- Clique em Verificar token do bot.
- 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").
- Salve o canal novamente para forçar o registro do webhook.
- Para inspecionar o status do webhook direto no Telegram, abra no navegador:
https://api.telegram.org/bot<SEU_TOKEN>/getWebhookInfo - Na resposta, o campo
urldeve apontar para o domínio do Omnifox. Seurlestiver vazio, o webhook não está registrado—salve o canal novamente. - Se
last_error_messagemostrar 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
/startao 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
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.