> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Controles de qualidade e entrega

> Entenda por que mensagens aprovadas podem ser atrasadas ou bloqueadas e responda aos sinais de qualidade sem tentativas cegas de reenvio.

Uma solicitação de API válida e um modelo aprovado não garantem que todas as mensagens chegarão ao destinatário.

O WhatsApp usa sinais de qualidade e controles de entrega para proteger os clientes contra mensagens indesejadas. Diagnostique o nível afetado antes de alterar um modelo, aumentar os gastos ou tentar reenviar uma campanha.

## Controles que podem afetar a entrega

O **Pacing** permite que o WhatsApp avalie as respostas a um modelo antes de liberar mais mensagens. Não interprete todo atraso como uma falha de transporte.

A **pausa ou desativação** pode tornar um modelo indisponível após feedback negativo ou baixo engajamento. Verifique o status atual do modelo antes de agendar envios adicionais.

Os **limites de marketing no nível do destinatário** podem impedir que um cliente receba outra mensagem de marketing, mesmo quando o seu portfólio tiver capacidade. Esses limites dizem respeito à experiência geral do cliente, não apenas às mensagens da sua empresa.

A Meta descreve esses mecanismos nos [fundamentos dos modelos](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/). Seus limites e disponibilidade podem mudar; não prometa uma cota fixa para cada cliente.

## Diagnosticar a partir do resultado

| Observação | Primeira ação |
| - | - |
| Solicitação aceita, mas ainda sem entrega | Acompanhe as atualizações de status e verifique se há processamento pendente; não duplique o envio imediatamente. |
| O modelo está pausado ou desativado | Interrompa os envios dependentes e revise o feedback e o conteúdo. |
| Falhas concentradas em um único modelo | Revise a categoria, a qualidade, o status e o público recente desse modelo. |
| Falhas concentradas em clientes individuais | Examine erros específicos do destinatário e as preferências de comunicação. |
| Falhas afetam muitos modelos e números | Verifique a capacidade do portfólio, o status da conta, a integridade da integração e o faturamento. |

Consulte os [Status de entrega de mensagens](/pt/documentation/whatsapp-business-platform/messaging/message-delivery-statuses) para o ciclo de vida de uma mensagem. Preserve o código de erro exato e os identificadores relevantes ao entrar em contato com o suporte.

## Códigos de erro comuns e a próxima verificação

A YCloud pode retornar seus próprios erros e erros upstream do WhatsApp. Preserve o código real e os detalhes; os seguintes são códigos comuns da **Meta** , não todos os resultados possíveis da YCloud.

| Código | O que verificar |
| - | - |
| `130429` | Taxa de transferência excedida; reduza a velocidade do envio. |
| `131026` | Não entregue; não conclua que o destinatário bloqueou você. |
| `131042` | Configuração de faturamento ou pagamento; não é automaticamente um banimento por política. |
| `131047` | Janela de atendimento expirada; escolha um modelo de mensagem aprovado adequado. |
| `131049` | Controle de entrega/engajamento do destinatário; evite tentativas imediatas de reenvio. |
| `131050` | O destinatário optou por não receber marketing da sua empresa; não tente reenviar essa mensagem de marketing. |
| `132000` | Incompatibilidade na contagem de parâmetros do modelo. |
| `132001` | Incompatibilidade de nome, idioma ou aprovação do modelo. |
| `132015` / `132016` | Modelo pausado ou desativado; interrompa os envios dependentes. |

Para `131049`, a Meta recomenda aguardar pelo menos 24 horas antes de uma possível nova tentativa de envio quando houver suspeita de limite do destinatário. Aguardar **não** garante a entrega; primeiro confirme o consentimento, a relevância e se uma nova tentativa é justificável. Isso é diferente de `131050`, que indica que o destinatário optou por não receber marketing.

Fonte: [Códigos de erro da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes).

## Executar um diagnóstico direcionado

Compare um pequeno conjunto de mensagens representativas por modelo, remetente, origem do público, horário e erro. Não faça testes entrando em contato repetidamente com o mesmo destinatário que apresentou falha.

Por exemplo, se um modelo falhar em vários números enquanto outros modelos funcionam, investigue primeiro o status e os parâmetros desse modelo. Se muitos modelos falharem após uma alteração no faturamento, examine o faturamento e a configuração da conta antes de reescrever os textos.

Crie um breve registro do incidente: falha observada, escopo afetado, último envio bem-sucedido conhecido, alterações recentes, ação de contenção e próximo responsável. Isso transforma o "WhatsApp não está funcionando" em um problema específico e testável.

## Melhorar a experiência do cliente

Comece com a relevância antes do volume:

* Envie o que o cliente esperava receber ao fazer o opt-in.
* Utilize a intenção recente do cliente e tenha um motivo claro para o contato.
* Coordene a frequência entre campanhas e automações.
* Identifique sua empresa claramente.
* Mantenha o conteúdo preciso, útil e fácil de interagir.
* Torne a opção de cancelamento simples e aplique-a prontamente.

Monitore tanto os resultados de entrega quanto as respostas dos clientes. Uma alta taxa de entrega com um número crescente de cancelamentos de inscrição (opt-outs) não é uma campanha saudável.

## Tente novamente de forma deliberada

Tente novamente apenas quando o erro indicar uma condição recuperável e a mensagem ainda for útil. Use tentativas limitadas e evite criar notificações duplicadas para o cliente.

Não reenvie repetidamente uma mensagem de marketing bloqueada, não alterne números de negócios nem rotule novamente conteúdo promocional como utilitário para burlar controles.

Se o cliente iniciar uma nova conversa, responda à solicitação real dele usando o tipo de mensagem permitido. Não trate essa interação como permissão para reiniciar campanhas não relacionadas.

## Tópicos relacionados

* [Análise e ciclo de vida do modelo](/pt/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle)
* [Limites de mensagens e capacidade de processamento](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput)
* [Cancelamento de inscrição do cliente (opt-out)](/pt/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out)
* [Restrições de conta e contestações](/pt/documentation/whatsapp-business-platform/consent-policies-and-account-health/account-restrictions-and-appeals)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.