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.
Atenção aos Testes em Número Único
Um cenário comum de bloqueio ocorre durante testes, quando o mesmo template é enviado repetidamente para um único número sem haver resposta.
O algoritmo interpreta esse comportamento como falta de interesse do destinatário e cessa a entrega. Para normalizar, recomenda-se responder à última mensagem recebida no WhatsApp de teste, gerando engajamento.
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:
Acessar a coleção oficial da Meta: WhatsApp Business Platform Collection.
Configurar a requisição com as credenciais (Token e ID do número) utilizadas no Z-PRO.
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