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.
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.
A EasyCoexistence encaminha os dois webhooks de template para o seu endpoint, então uma queda de qualidade chega ao seu sistema no amarelo, em vez de ser descoberta quando um envio falha.
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