For the complete documentation index, see llms.txt. This page is also available as Markdown.

Template (WABA) não chega ao destinatário

Por que um Template (WABA) não chega ao destinatário?

Caso uma mensagem de modelo (Template) seja enviada pela API Oficial (WABA) e o sistema indique o envio com sucesso, mas a entrega não ocorra no dispositivo do destinatário, é provável que a mensagem tenha sido retida nos filtros de qualidade e engajamento da Meta.

O sistema de entrega da Meta é automatizado e segue regras rigorosas para evitar SPAM e garantir a experiência do usuário final, independentemente da plataforma utilizada para o envio.


1. O Filtro Automatizado da Meta

Mesmo com o template aprovado, o algoritmo da Meta monitora o comportamento do envio em tempo real. Diversos fatores podem bloquear ou atrasar a entrega, incluindo:

  • Baixa Taxa de Resposta: Envio de alto volume de mensagens com pouca interação por parte dos destinatários.

  • Frequência de Envio: Disparos repetitivos em curto espaço de tempo.

  • Bloqueios e Denúncias: Índices elevados de bloqueios ou denúncias de spam por parte dos usuários.

  • Qualidade do Número: Um histórico ruim de qualidade (visível no Gerenciador do WhatsApp) impacta diretamente a entrega.

  • Repetição: O envio massivo e repetido do mesmo template para o mesmo número (comum em testes).

2. O Novo Sistema de Autorização de Entrega

A Meta implementou camadas de segurança que impactam a entrega baseadas no comportamento do usuário final:

  • Pontuação de Engajamento: Avaliação do nível de interação do destinatário específico com a empresa.

  • Janela de Entrega Baseada em Engajamento: Quanto menor o engajamento do cliente, maior pode ser o atraso (delay) ou a restrição de entrega imposta pela Meta.

  • Filtros de Conteúdo: Mecanismos automáticos de Anti-Spam e Anti-Flood para detecção de padrões abusivos.


3. Diagnóstico Técnico (Teste de Isolamento)

Para confirmar se a falha de entrega é sistêmica ou um bloqueio externo da Meta, recomenda-se realizar um teste de envio direto pela API Oficial, isolando o Z-PRO.

O teste pode ser realizado via Postman:

  1. Acessar a coleção oficial da Meta: WhatsApp Business Platform Collection.

  2. Configurar a requisição com as credenciais (Token e ID do número) utilizadas no Z-PRO.

  3. Realizar o envio do mesmo template para o mesmo número que apresentou falha.

Interpretação do Resultado:

  • Mensagem NÃO entregue pelo Postman: Confirma-se que o bloqueio é imposto pela Meta/WhatsApp (devido a regras de negócio, qualidade ou filtro de spam). Nesses casos, o Z-PRO não possui controle sobre a entrega.

  • Mensagem entregue pelo Postman: Indica uma possível inconsistência na configuração dentro do Z-PRO. Recomenda-se a abertura de um chamado técnico anexando os logs do teste.

Atualizado

Isto foi útil?