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.

Jun 26, 2026

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

  1. Abra a campanha em Transmissões e olhe o contador Falhas.
  2. Leia o motivo de erro de cada destinatário com falha.
  3. 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.

  1. 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.
  2. Verifique se os contatos têm número em formato internacional com prefixo +.
  3. 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.

  1. Na etapa Mensagem, o seletor Modelo do WhatsApp lista apenas modelos com status aprovado.
  2. Se você não vê seu modelo, o status é pendente ou rejeitado. Confira no gerenciador de modelos do canal.
  3. 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:

  1. 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".
  2. 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.
  3. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp