# 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.

{% hint style="warning" %}
**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.
{% endhint %}

***

### 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](https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api).
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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/principais-erros/template-waba-nao-chega-ao-destinatario.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.