Nota de qualidade do template no WhatsApp: o que derruba, e o que acontece quando ela chega no vermelho
A Meta calcula a nota de qualidade de cada template por uso, feedback do cliente e engajamento. Ao chegar na pior faixa, o template é pausado automaticamente por 3 horas na primeira vez, 6 horas na segunda e desabilitado na terceira.
Por que a nota de qualidade do meu template caiu?
Porque as pessoas reagiram mal ou simplesmente não leram. A documentação oficial da WhatsApp Business Platform diz que a nota de qualidade de um template é calculada a partir de três sinais combinados: uso (o quanto o template foi enviado), feedback do cliente (denúncias, bloqueios e marcações negativas dos usuários) e engajamento, principalmente a taxa de leitura. Taxa de leitura baixa puxa a nota para baixo mesmo sem uma única denúncia.
Não existe painel que mostre "este contato te denunciou". O que existe é a nota agregada, e ela se move sozinha conforme os dados chegam. Todo template recém-criado nasce sem nota e a recebe depois, quando já houve envio suficiente para medir.
Quais são as notas possíveis?
| Nota na API | Como aparece no WhatsApp Manager | O que significa | Ainda envia? |
|---|---|---|---|
GREEN | Active : High quality | Alta qualidade. Pouco ou nenhum feedback negativo. | Sim. |
YELLOW | Active : Medium quality | Feedback negativo de vários usuários, ou baixa taxa de leitura. Pode ser pausado em breve. | Sim. |
RED | Active : Low quality | Baixa qualidade. Em risco de ser pausado ou desabilitado. | Sim, mas em perigo. |
UNKNOWN | Active : Quality pending | Sem feedback nem dados de leitura suficientes ainda. | Sim. |
Repare que as quatro faixas permitem envio. A nota não bloqueia nada por si só. Ela alimenta dois mecanismos que bloqueiam: o pacing, que segura a entrega para colher feedback, e o pausing, que tira o template do ar.
O que acontece quando a nota chega no vermelho?
O template é pausado automaticamente. A duração é escalonada e está publicada:
- 1ª vez: pausado por 3 horas.
- 2ª vez: pausado por 6 horas.
- 3ª vez: desabilitado.
A finalidade declarada da pausa é proteger a nota de qualidade dos números de telefone que usaram aquele template. Enquanto o template está pausado, ele não pode ser enviado e a API rejeita as tentativas. Dois detalhes aliviam o estrago imediato: você não é cobrado pela tentativa de enviar um template pausado, e a tentativa não conta contra o seu limite de envio.
Sobre o número de telefone, a documentação faz uma ressalva importante. A pausa, inicialmente, não impacta o número de onde o template foi enviado: outros templates de alta qualidade continuam saindo daquela linha normalmente. Mas ela adverte que, se o negócio enviar consistentemente templates que chegam a baixa qualidade, o número pode acabar sendo impactado ao longo do tempo. A pausa é o aviso; a degradação do número é a conta que chega depois.
Como o template volta a funcionar?
De duas formas. Automática: o template despausa sozinho ao cumprir a duração, o status volta a Active e a nota é redefinida com base no feedback mais recente. Manual: por um POST em /{id}/unpause na API, ou pelo link de despausar manualmente no WhatsApp Manager.
Existe uma exceção que costuma pegar time desprevenido: templates pausados durante o Template Pacing precisam ser despausados manualmente antes de voltar a ser usados. Ficar esperando o despause automático nesse caso é esperar por algo que não vem.
Você também pode editar o template pausado, se acreditar que mudar o conteúdo reduz o feedback negativo. O custo é que, ao editar e reenviar para aprovação, o status vai para In Review e o template não pode ser enviado até ser reaprovado. Se a submissão for rejeitada, cabe recurso, e o recurso precisa incluir uma amostra (sample) com valores de variáveis e imagens de exemplo. A documentação afirma que o recurso é revisado e decidido em até 24 horas.
Como monitorar a nota antes de perder o template?
Pela API, consultando o campo quality_score na Template API, que devolve a nota e o timestamp da última avaliação. Pelo painel, o Manage templates mostra o mesmo em texto. E, para não depender de consulta manual, existem dois webhooks que carregam a informação em tempo real: message_template_quality_update, que avisa quando a nota muda, e message_template_status_update, que avisa quando o template é pausado ou reativado.
A regra operacional que se extrai da própria documentação é agir em YELLOW. Amarelo ainda envia, mas já é o registro de que houve feedback negativo ou leitura baixa. Esperar chegar em vermelho é esperar a pausa.
O que muda para quem opera no Brasil
A regra de pausa automática vale para negócios no Brasil desde 12 de setembro de 2023, junto com Colômbia e Singapura, antes do restante do mundo, que entrou em 12 de outubro de 2023. O Brasil foi mercado de estreia da regra, o que diz algo sobre onde o volume de template estava concentrado.
Para times de vendas e atendimento, a leitura prática é que o template deixou de ser um texto aprovado e virou um ativo com reputação própria, que pode ser perdido. Quem escala campanha reaproveitando uma única peça para a base inteira concentra todo o risco em um ponto: se ela cai, a operação para. Distribuir o volume entre peças distintas e segmentadas não é refinamento de copy, é continuidade de canal. Nosso guia completo da API oficial detalha como esse ciclo se encaixa na aprovação de templates.
Leitura crítica
O desenho é coerente com o incentivo da plataforma: proteger a caixa de entrada do usuário custa mais barato para a Meta do que perder o usuário. Mas há uma assimetria informacional relevante. O operador recebe uma nota agregada em quatro faixas e nenhum detalhamento de qual sinal a moveu. Não dá para saber se o amarelo veio de dez denúncias ou de uma taxa de leitura ruim, e essas duas causas pedem correções opostas: a primeira é problema de permissão e segmentação, a segunda é problema de conteúdo e horário.
Também vale notar o que a escada de pausa realmente comunica. Três horas na primeira vez é quase simbólico; seis horas na segunda ainda é absorvível. O salto real está no terceiro degrau, que não é uma pausa mais longa e sim o fim do template. Quem lê a tabela como uma sequência de multas crescentes subestima o corte, porque a terceira instância não devolve a peça. Ela obriga a começar de novo, com um template novo, sem histórico e sujeito de novo ao pacing.
Por fim, a ressalva sobre o número merece mais atenção do que costuma receber. A documentação diz que a pausa não impacta o número "inicialmente" e que o impacto pode vir "ao longo do tempo" com reincidência. Não há limiar publicado para essa transição. Na prática, o operador não sabe quantas pausas o separam de um problema na linha, e essa é exatamente a informação que ele mais precisaria ter.