O ciclo de vida do status do template
Um template percorre uma sequência de estados, e a aprovação é o meio dessa sequência, não o fim. Um template aprovado pode ser pausado por qualidade, reativado, pausado de novo e por fim desativado em definitivo, tudo isso sem que ninguém encoste nele.
A EasyCoexistence informa a pontuação de qualidade de cada template pelo conector MCP, então uma queda pode ser identificada no amarelo, em vez de ser descoberta quando um envio falha.
O erro devolvido ao enviar com um template pausado.
O erro devolvido quando um template está desativado em definitivo.
Campos de webhook que reportam o ciclo de vida: atualizações de status e de qualidade.
Os estados
Na ordem em que um template normalmente os encontra.
- PENDING: submetido e aguardando revisão.
- APPROVED: pronto para ser usado em envios.
- REJECTED: recusado na revisão, normalmente por estrutura ou categoria.
- PAUSED: temporariamente inutilizável depois de uma queda de qualidade.
- DISABLED: inutilizável em definitivo, o fim da linha.
Como um template é pausado
Não por nada que você faça. Os destinatários bloqueiam ou denunciam as mensagens enviadas com ele, a classificação de qualidade do próprio template cai de verde para amarelo e depois para vermelho, e a Meta o pausa para interromper a queda.
Uma pausa é temporária e se desfaz sozinha. O que importa é o que vem depois: pausas repetidas escalam, e um template que insiste em voltar ao vermelho acaba desativado em definitivo, em vez de pausado mais uma vez.
Os dois webhooks
Os dois são necessários para enxergar o ciclo inteiro, e assinar um sem o outro deixa um ponto cego.
message_template_status_update: aprovação, rejeição, pausa e desativação.message_template_quality_update: a classificação de qualidade se movendo entre verde, amarelo e vermelho.- O webhook de qualidade é o aviso antecipado; o de status é a consequência.
- Nenhum dos dois vem ligado por padrão, então os dois precisam ser assinados.
Por que o amarelo é o momento de agir
Quando um template é pausado, o envio com ele já falha e uma campanha já está quebrada. O amarelo é o estado em que ele ainda funciona e a queda já está visível.
Agir no amarelo significa olhar para o público além da redação. Um template bem escrito enviado para quem não esperava por ele coleta bloqueios tão rápido quanto um mal escrito, e reescrever o texto mantendo a mesma lista não muda nada.
O que a edição provoca
Um template aprovado pode ser editado, o que o manda de volta para a revisão. Isso é útil e tem uma consequência que as pessoas encontram em produção: se a edição mudar o número de variáveis, todo envio feito por uma integração não atualizada passa a falhar com o erro 132012.
Trate a contagem de variáveis de um template como parte do contrato da integração, e não como um texto que alguém do marketing é dono.
Erros comuns
- Tratar a aprovação como permanente. Um template aprovado pode ser pausado e por fim desativado.
- Assinar o webhook de status e não o de qualidade. O campo de qualidade é o aviso antecipado.
- Editar as variáveis de um template sem conferir o código que faz o envio.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Um template aprovado continua aprovado?
Não necessariamente. Retorno negativo sustentado pode pausá-lo e por fim desativá-lo em definitivo.
Qual é a diferença entre pausado e desativado?
Uma pausa se desfaz sozinha. Desativado é permanente e o template não pode ser usado de novo.
Como eu vejo isso chegando?
Assine o webhook de qualidade de template. Ele reporta a mudança para amarelo enquanto o template ainda funciona.
Por que os envios começaram a falhar depois de uma edição?
Se a edição mudou a contagem de variáveis, a integração não atualizada agora manda o número errado de parâmetros e recebe o erro 132012.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em