O ciclo de estados de um template
Um template percorre uma sequência de estados, e a aprovação é apenas uma etapa intermédia, não o fim. Um template aprovado pode ser pausado por razões de qualidade, reativado, pausado novamente e, por fim, desativado permanentemente, sem intervenção humana.
O erro devolvido ao enviar com um template pausado.
O erro devolvido quando um template é desativado permanentemente.
Os campos do webhook que comunicam o ciclo de vida: status e atualizações de qualidade.
Os estados
A ordem pela qual um template normalmente passa por eles.
- PENDING: submetido e a aguardar análise.
- APPROVED: disponível para envio.
- REJECTED: recusado na análise, normalmente por estrutura ou categoria.
- PAUSED: temporariamente indisponível após uma queda de qualidade.
- DISABLED: permanentemente indisponível, o fim do percurso.
Como um template é pausado
Não é algo que faça. Os destinatários bloqueiam ou denunciam as mensagens enviadas com o template, a sua classificação de qualidade passa de verde a amarelo e depois a vermelho, e a Meta pausa-o para travar a queda.
A pausa é temporária e termina por si só. O que importa é o que acontece depois: pausas repetidas agravam-se, e um template que continua a voltar ao vermelho acaba desativado permanentemente, em vez de ser novamente pausado.
Os dois webhooks
Ambos são necessários para acompanhar todo o ciclo, e subscrever 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 entre verde, amarelo e vermelho.
- O webhook de qualidade é o aviso antecipado; o webhook de estado é a consequência.
- Nenhum está ativo por predefinição, por isso é necessário subscrever ambos.
Porque é que o amarelo é o momento de agir
Quando um template é pausado, o envio com ele já falha e uma campanha já está interrompida. O amarelo é o estado em que ainda funciona e a queda é visível.
Agir no amarelo significa analisar o público, além do texto. Um template bem escrito enviado a pessoas que não o esperavam acumula bloqueios tão depressa como um template mal escrito, e reescrever o texto mantendo a lista não altera nada.
O que acontece ao editar
Um template aprovado pode ser editado, o que o envia novamente para análise. Isso é útil, mas tem uma consequência comum em produção: se a edição alterar o número de variáveis, todos os envios de uma integração não alterada começam a falhar com o erro 132012.
Trate o número de variáveis de um template como parte do contrato da integração, não como texto pertencente à equipa de marketing.
Erros comuns
- Tratar a aprovação como permanente. Um template aprovado pode ser pausado e acabar desativado.
- Subscrever o estado, mas não a qualidade. O campo de qualidade é o aviso antecipado.
- Editar as variáveis de um template sem verificar o código que o envia.
A EasyCoexistence encaminha ambos os webhooks de templates para o seu endpoint, para que uma queda de qualidade chegue ao seu sistema no amarelo, antes de uma falha de envio.
Perguntas frequentes
Um template aprovado mantém-se aprovado?
Não necessariamente. Feedback negativo continuado pode pausá-lo e, por fim, desativá-lo permanentemente.
Qual é a diferença entre pausado e desativado?
Uma pausa termina por si só. Desativado é permanente e o template não pode voltar a ser utilizado.
Como posso detetar o problema antecipadamente?
Subscreva o webhook de qualidade do template. Este comunica a passagem para amarelo enquanto o template ainda funciona.
Porque é que os envios começaram a falhar depois de uma edição?
Se a edição alterou o número de variáveis, a integração não alterada envia agora um número incorreto de parâmetros e recebe o erro 132012.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em