Solução de problemas: falhas, sem identidade, modelo não aprovado, travado, novas tentativas
Diagnostique e resolva os erros mais comuns das suas campanhas: destinatários com falha, contatos sem identidade no WhatsApp, modelos não aprovados, envios travados e novas tentativas.
O que este guia cobre
Quando uma campanha não entrega como esperado, a causa quase sempre está em uma de cinco frentes. Este guia ajuda você a identificar o problema na tela de detalhes da transmissão e a corrigi-lo.
Para começar, vá em Transmissões, abra a campanha afetada e veja o painel de estatísticas: você verá os contadores Enviados, Entregues, Lidos, Respondidos e Falhas. Cada destinatário com falha guarda um motivo de erro — essa é a sua melhor pista.
1. Destinatários com falha
- Abra a campanha em Transmissões e olhe o contador Falhas.
- Leia o motivo de erro de cada destinatário com falha.
- Os motivos mais comuns são: número inválido, janela de 24 h fechada (não se aplica a modelos) ou uma recusa da Meta (códigos 131xxx).
Dica: se todos os envios falharem com OAuthException código 190, o token do canal expirou. Reconecte o canal do WhatsApp em Configurações → Canais usando o Embedded Signup.
2. Contatos "sem identidade"
Um contato sem identidade válida no WhatsApp não pode receber a mensagem e aparece com o erro Contact not found ou número inválido.
- Na etapa Público do assistente, o contador Destinatários estimados conta todos os contatos que atendem aos seus filtros; não verifica se cada um tem número ou identidade válidos no canal. Esses contatos são descartados no envio e ficam como Falha.
- Verifique se os contatos têm número em formato internacional com prefixo
+. - Limpe seu segmento (grupo, etiqueta ou campo personalizado) para não incluir registros incompletos.
3. Modelo não aprovado
As transmissões de WhatsApp só podem usar modelos aprovados pela Meta.
- Na etapa Mensagem, o seletor Modelo do WhatsApp lista apenas modelos com status aprovado.
- Se você não vê seu modelo, o status é pendente ou rejeitado. Confira no gerenciador de modelos do canal.
- Se um modelo for rejeitado depois de agendar a campanha, o envio falha com a mensagem "WhatsApp template is not approved". Troque por um aprovado e crie a transmissão novamente.
4. Campanha travada
Se o status ficar em Enviando por muito tempo:
- Confirme que você não atingiu o limite mensal de destinatários do seu plano. Ao atingi-lo, os destinatários restantes ficam como falha com o motivo "Plan cap reached".
- Verifique se você não atingiu outro limite do plano (transmissões por mês ou destinatários por envio). As Transmissões estão em todos os planos, mas o canal de WhatsApp por QR não as permite.
- Aguarde alguns minutos: o envio é em lotes e respeita os limites da Meta.
5. Novas tentativas
Cada mensagem é reenviada automaticamente até 3 vezes com espera progressiva. Só após a terceira tentativa com falha o destinatário é marcado como Falha em definitivo. Não precisa reenviar à mão: leia o motivo, corrija a causa (modelo, número ou token) e lance uma nova campanha para os destinatários com falha.
Verificação
Volte ao detalhe da campanha e confirme que Entregues + Lidos sobem enquanto Falhas para de crescer. Uma taxa de entrega saudável fica acima de 90%.
Artigos relacionados
Artigos relacionados
-
Como criar uma campanha de difusão (broadcast)
Crie, segmente e agende uma difusão para seus contatos passo a passo no Omnifox.
-
Boas práticas para difundir sem ser bloqueado
Reduza denúncias de spam e bloqueios seguindo estas regras ao enviar difusões pelo WhatsApp e outros canais.
-
O que é uma campanha e seus status (rascunho, agendada, enviando, concluída)
O que é uma campanha de transmissão na Omnifox e o que significam seus status: rascunho, agendada, enviando e concluída.
-
Canais suportados para transmissões (WhatsApp, E-mail, SMS, Telegram)
Conheça quais canais voce pode usar para enviar transmissões no Omnifox e o que cada um exige.
-
Segmentar a audiência: todos, grupos, tags (E/OU) e campo personalizado
Aprenda a escolher com precisão quem recebe sua transmissão combinando grupos, tags com lógica E/OU e campos personalizados.