Por que as mensagens recebidas do WhatsApp não chegam
Diagnóstico passo a passo quando os clientes te escrevem no WhatsApp, mas as mensagens não aparecem na sua caixa de entrada do Omnifox.
Quando usar este artigo
Seus clientes te escrevem no WhatsApp, eles veem a mensagem como enviada, mas ela não aparece na sua caixa de entrada do Omnifox. Quase sempre a causa está em uma de três camadas: o webhook da Meta, o número/canal mal roteado, ou o workspace errado. Este guia é para administradores do canal.
Antes de começar
- Você precisa de função de administrador e acesso ao Gerenciador do WhatsApp no Meta Business.
- Tenha à mão o número afetado e o ID do canal (em Canais, botão "Copiar ID do canal").
Diagnóstico passo a passo
- Confirme que o canal está Conectado. Abra Canais. Se o número aparecer como Desconectado ou com alerta, o token expirou (erro 190 da Meta). Reconecte pelo Embedded Signup.
- Verifique se o webhook aponta para o Omnifox. Na Meta → seu app → WhatsApp → Configuração, o webhook deve apontar para o endpoint do Omnifox e estar inscrito no campo
messages. Se outra ferramenta sequestrou o webhook, as mensagens recebidas vão para ela, não para você. - Garanta que o número entrega para um único destino. Um número (phone number ID) só pode entregar para um app/webhook. Se você o conectou antes em outro lugar, desvincule lá.
- Confirme o workspace correto. O canal pertence a um workspace específico. Se você está vendo outro workspace no Omnifox, as mensagens existem mas você não as vê. Troque de workspace no canto superior esquerdo.
- Descarte bloqueio/opt-out. As mensagens recebidas sempre chegam, mas se o contato foi marcado como bloqueado ou spam do seu lado, pode ser filtrado. Procure-o em Contatos.
Verificação
Peça para alguém te enviar um WhatsApp novo. Deve aparecer na caixa de entrada em segundos. Se não, force uma verificação do canal: no painel de Canais use "Reativar canal" para disparar um healthcheck imediato.
Se ainda assim não chegar
- Webhook verde na Meta mas nada no Omnifox: provavelmente o campo
messagesnão está inscrito, ou o número entrega para outro app. Reconfigure o webhook. - Chega para um número e não para outro: cada número é um canal independente; verifique o canal específico, não o primeiro da lista.
- Chegava e parou: quase sempre token expirado (190) ou o número foi repareado em outra ferramenta. Reconecte.
- Coexistence: se você usa o canal em modo Coexistence, as mensagens digitadas no app do celular também devem sincronizar; verifique o indicador de sincronização do canal.
Dicas
- Nunca conecte o mesmo número em duas plataformas ao mesmo tempo: o webhook é exclusivo e elas disputam as mensagens recebidas.
- Após reconectar, sempre envie uma mensagem de teste real antes de dar por resolvido.
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.