Nota do template, pacing e pausing: os três mecanismos que a Meta usa para segurar o seu disparo no WhatsApp, e o que derruba a nota
Template novo nasce sem nota e tem a entrega segurada até a Meta coletar feedback. Se o sinal vier ruim, as mensagens retidas são descartadas com o erro 132015 e o template é pausado por 3 horas na primeira vez, 6 na segunda e desabilitado na terceira. A regra vale para empresas brasileiras desde 12 de setembro de 2023.
Por que minhas mensagens de template ficaram retidas?
Porque o template entrou em pacing. Pacing é o mecanismo da WhatsApp Business Platform que segura a entrega de um template até coletar feedback inicial dos clientes. Enquanto ele age, as mensagens saem normalmente até um limiar não divulgado pela Meta. Atingido esse ponto, as mensagens seguintes ficam retidas, e a resposta da API passa a trazer message_status com o valor held_for_quality_assessment em vez de accepted.
Dali saem dois caminhos. Se o sinal de qualidade que chega for bom, as mensagens retidas são liberadas e o disparo volta a escalar para todo o público. Se o sinal for ruim, as mensagens retidas são descartadas, o status do template vira pausado e cada mensagem descartada dispara um webhook com status igual a failed e code igual a 132015.
Este texto se apoia na documentação oficial da Meta sobre pacing, pausing e qualidade de template, espelhada e traduzida internamente pelo AI Hub Brasil em 21 de maio de 2026.
Como a Meta calcula a nota do template?
A nota de qualidade do template combina três sinais: uso, ou seja, o quanto o template foi enviado; feedback do cliente, que são denúncias, bloqueios e marcações negativas; e engajamento, principalmente a taxa de leitura. Baixa taxa de leitura puxa a nota para baixo sozinha, mesmo sem denúncia nenhuma.
| Nota na API | Significado | Como aparece no WhatsApp Manager | Ainda envia? |
|---|---|---|---|
GREEN | Alta qualidade, pouco ou nenhum feedback negativo. | Active : High quality | Sim |
YELLOW | Qualidade média: feedback negativo de vários usuários ou baixa taxa de leitura. Pode ser pausado em breve. | Active : Medium quality | Sim |
RED | Baixa qualidade, em risco de pausa ou desativação. | Active : Low quality | Sim, mas em perigo |
UNKNOWN | Nota pendente: o template ainda não recebeu feedback nem dados de leitura. | Active : Quality pending | Sim |
Todo template recém-criado começa em UNKNOWN. A consulta é feita pela API de template pedindo o campo quality_score, que devolve a nota e o carimbo de data e hora da última avaliação.
Quando o pacing pega o meu template?
Três situações deixam um template sujeito a pacing: ser recém-criado, ter sido despausado, ou ser um template antigo que não tem nota GREEN. O histórico de qualidade pesa: uma pausa anterior por baixa qualidade é uma das principais razões para o pacing aparecer, inclusive em outros templates da mesma conta.
Para templates de utilidade há uma regra própria. Eles só ficam sujeitos a pacing se você já tiver tido um template de utilidade pausado antes. Depois dessa primeira pausa, os templates de utilidade recém-criados, despausados ou sem nota verde ficam potencialmente sujeitos a pacing pelos 7 dias seguintes.
A Meta declara um compromisso de tempo para não inviabilizar campanha sensível a prazo: mesmo em pacing, as mensagens de maior vazão são entregues em até 1 hora, no percentil 99.
Existe ainda um segundo pacing, que age no portfólio de negócio e não no template. Ele atinge portfólios que enviaram menos de 500 mil mensagens de template em 365 dias móveis, ou sob monitoramento por atividade suspeita. A entrega sai em lotes e o descarte vem com o código 135000.
Quanto tempo meu template fica pausado?
Ao atingir a pior nota de qualidade, o template é pausado automaticamente para proteger a reputação dos números que o usaram. As durações são fixas e escalam a cada reincidência.
| Ocorrência | Efeito |
|---|---|
| 1ª vez | Pausado por 3 horas |
| 2ª vez | Pausado por 6 horas |
| 3ª vez | Desabilitado |
Durante a pausa, o template não pode ser enviado e a API rejeita as tentativas. A boa notícia é que você não é cobrado por essas tentativas e elas não consomem o seu limite de mensagens. A pausa, de início, não atinge o número de telefone: outros templates de alta qualidade continuam saindo dali. Mas a documentação avisa que enviar consistentemente templates de baixa qualidade acaba impactando o número ao longo do tempo.
O despause pode ser automático, quando o prazo se esgota, ou manual, pelo endpoint de unpause da API ou por um clique no WhatsApp Manager. Detalhe operacional que costuma travar campanha: templates pausados durante o pacing precisam ser despausados manualmente antes de voltar a ser usados.
A regra de pausing vale para empresas do Brasil, da Colômbia e de Singapura desde 12 de setembro de 2023, e para todas as demais desde 12 de outubro do mesmo ano. O Brasil foi um dos três mercados que estrearam o mecanismo.
Existe limite de marketing por pessoa?
Sim, e ele é individual, não da sua conta. A plataforma limita quantas mensagens de template de marketing um usuário recebe de qualquer empresa num período, quando essa pessoa está menos propensa a se engajar. A decisão considera a taxa de leitura recente de marketing dela e o quanto a caixa de entrada já está cheia.
Cada mensagem de marketing entregue conta para o limite daquele usuário. Existe uma válvula de escape: se a pessoa responde, abre uma janela de atendimento de 24 horas, e mensagens de marketing enviadas dentro dessa janela não contam para o limite. Quando a entrega é barrada pelo limite, o webhook chega com failed e código 131049, e a recomendação oficial é esperar pelo menos 24 horas antes de tentar de novo com aquela pessoa.
Insistir piora: reenviar várias vezes em 24 horas para quem já bateu no limite pode tornar novas tentativas indisponíveis por até 24 horas. O limite por usuário não está ativo para números do Espaço Econômico Europeu, Reino Unido, Japão e Coreia do Sul. Já para usuários com número dos Estados Unidos, a plataforma simplesmente não entrega template de marketing.
Como a nota do template limita quanto você pode enviar
O limite de mensagens do portfólio, compartilhado por todos os números dele, começa em 250 telefones únicos por 24 horas em conta nova. Para chegar a 2.000 é preciso verificar o negócio ou entregar 2.000 mensagens para telefones únicos em 30 dias móveis usando templates com nota alta. Os degraus seguintes, 10.000, 100.000 e ilimitado, vêm por escalonamento automático, que exige alta qualidade em todos os números e templates.
Ou seja: nota alta de template é pré-requisito tanto para sair de 250 quanto para subir de degrau depois. Qualidade e capacidade de envio são a mesma variável vista de dois ângulos. Quem está montando a operação encontra o desenho completo do canal no guia da API oficial do WhatsApp.
Leitura crítica
O desenho é coerente com o interesse da plataforma, e isso não é crítica: mensagem que as pessoas leem eleva o seu limite, mensagem que parece spam derruba tudo. O problema para quem opera é que o limiar do pacing não é divulgado, então não existe forma de calcular de antemão quantas mensagens saem antes da retenção começar. O planejamento de campanha convive com uma variável cega.
A consequência prática é que disparo em massa de template novo é uma aposta ruim por construção. O template nasce em UNKNOWN, entra em pacing por definição, e o volume alto só serve para acelerar a chegada de um sinal que pode ser negativo. Subir devagar, confirmar a nota verde e só então escalar não é conselho de cautela: é a única sequência que o mecanismo premia.
Há também um ponto cego de diagnóstico. Como a nota é puxada por taxa de leitura, uma operação pode perder entrega sem nunca ter recebido uma denúncia sequer. O indicador a acompanhar é leitura por template, e ele mede a qualidade do conteúdo, não a da lista.