Linhas e entrega
A mensagem não chegou: falhas e códigos de erro
Onde ver por que uma mensagem falhou, o que significa cada código da Meta e do WhatsApp e o que fazer dentro do ZapFlow.
Resposta rápida
Nas conversas, a mensagem que não saiu aparece com Falhou em vermelho, e logo abaixo o motivo em português. As causas mais comuns são janela de 24 horas fechada (use um template), contato que bloqueou o número ou não tem WhatsApp, limite da Meta por contato e problema na conta da Meta. A tabela abaixo diz o que fazer em cada caso.
Onde ver o motivo
- Na conversa: a bolha da mensagem enviada mostra Falhou no lugar dos tiques, e embaixo uma linha vermelha com o motivo, no formato "nome do erro · explicação". Passe o mouse sobre Falhou para ver o texto completo.
- Na faixa Sai pela, embaixo do campo de mensagem: avisos que impedem o envio antes de tentar, como Janela de 24h fechada nesta linha, Linha desconectada ou Limite diário desta linha atingido.
- No cartão da linha, em Integrações: quando o problema é da conta inteira, como pagamento. Veja Linha parada pela Meta.
Linha oficial: códigos da Meta
| Código | O que aparece | O que quer dizer | O que fazer |
|---|---|---|---|
| 131047 | Janela de 24h expirou | O contato não falou com você nas últimas 24 horas | Envie um template aprovado. Veja Janela de 24 horas |
| 131049 | Segurada pela Meta | A Meta segurou a mensagem para preservar o engajamento: acontece com template de marketing para quem já recebe muitas mensagens de empresas ou interage pouco | Não insista no mesmo dia. Mande só para quem interage, ou use template de utilidade quando for aviso de compra |
| 131026 | Mensagem não entregue | O número pode não ter WhatsApp ativo, ter bloqueado você, ou a conta estar com baixa reputação | Confira o número com o contato. Se repetir muito, revise a lista |
| 131056 | Limite de mensagens por par excedido | Muitas mensagens para o mesmo contato em pouco tempo | O ZapFlow tenta de novo mais tarde. Espace as mensagens para a mesma pessoa |
| 130472 | Mensagem fora do critério Meta | A Meta escolheu não entregar (teste interno dela) | Nada a fazer nessa mensagem. Não é problema do número |
| 131048 | Envio restrito por qualidade | A Meta restringiu o número por spam ou qualidade baixa | Pare os disparos e espere a restrição cair. Veja Qualidade e limite diário |
| 131042 | Problema de pagamento na conta | Falta forma de pagamento ou crédito na conta do WhatsApp Business | Regularize na Meta. A linha para sozinha até você confirmar |
| 132001 | Template não existe nesta WABA | Nome ou idioma errado, ou template aprovado em outra conta | Use um template aprovado na conta da linha que está enviando |
| 132015 | Template pausado pela Meta | O template teve qualidade baixa e foi pausado | Use outro template. Veja Template reprovado ou pausado |
| 132007 | Variáveis do template incorretas | Faltou ou sobrou variável | Confira as variáveis no envio ou no bloco da automação |
| 130429 | Limite de velocidade atingido | A Meta limitou a velocidade do número | O ZapFlow desacelera sozinho. Reduza a velocidade em Configurações > Disparos |
Linha QR code: avisos do WhatsApp e do ZapFlow
| O que aparece | O que quer dizer | O que fazer |
|---|---|---|
| Este número não está no WhatsApp desta linha. | O número não tem conta no WhatsApp | Confira o número. O ZapFlow não manda para quem não existe |
| O WhatsApp recusou o primeiro contato por esta linha QR (erro 463). | Linha nova ou recém-conectada tentando falar com quem nunca falou com ela | Peça para o contato mandar mensagem primeiro, use uma linha oficial ou espere o aquecimento |
| Teto diário anti-ban atingido | A linha chegou ao limite de envios em massa do dia | Continue no dia seguinte (o contador vira às 21h de Brasília) ou use outra linha. Veja Aquecimento |
| Linha desconectada | A linha QR caiu | Reconectar no cartão. Veja Linha desconectada |
Contato em opt-out
Quem pediu para sair (opt-out) não recebe mensagens automáticas: disparos e automações pulam esse contato e registram o motivo. Se alguém da equipe tentar mandar à mão pelo chat, o ZapFlow pergunta antes se quer enviar mesmo assim. Na ficha do contato aparece o selo Opt-out. Veja Opt-out.
Tiques: enviada, entregue e lida
Mensagem sem Falhou saiu do ZapFlow. Os tiques mostram o resto: um tique é enviada, dois tiques é entregue no celular e tiques azuis é lida (quando o contato não desligou a confirmação de leitura). Mensagem presa em um tique por muito tempo normalmente é celular do contato desligado ou sem internet.
Perguntas frequentes
Posso reenviar uma mensagem que falhou?
Corrija a causa primeiro (por exemplo, mande um template se a janela fechou) e envie de novo. Reenviar a mesma coisa sem corrigir só repete a falha.
Muitas mensagens falharam num disparo. O número está em perigo?
Depende do motivo. Falhas por janela fechada ou template errado não prejudicam o número. Muitas falhas por bloqueio ou retenção (131049, 131026) ou Envio restrito por qualidade são sinal de lista ruim: pare e revise. Veja Como evitar bloqueio.
O que quer dizer "Segurada pela Meta"?
É o código 131049: a Meta limitou mensagens de marketing para aquele contato e não entregou. Não é bloqueio. Tente mais tarde ou use um template de utilidade quando for um aviso de compra ou de acesso.
A mensagem saiu mas o cliente diz que não recebeu.
Confira se ela tem dois tiques. Se tiver só um, o celular do cliente ainda não recebeu. Se tiver dois, a mensagem chegou e pode estar em uma conversa arquivada ou silenciada do cliente.
Artigos relacionados
Janela de 24 horasLinha parada pela Meta (pausa automática)Como evitar bloqueio e banimento do númeroTemplate reprovado, pausado ou desativadoOpt-out: quem pediu para sair