Erro 132012 do WhatsApp: formato dos parâmetros do template divergente

O que precisa se alinhar

Tudo, e silenciosamente. Não existe correspondência parcial.

• Quantidade: três marcadores no corpo significam três parâmetros de corpo, nem mais nem menos.
• Ordem: os parâmetros são posicionais, então trocar dois produz uma mensagem enviada com os valores nos lugares errados, ou esse erro se os tipos forem diferentes.
• Tipo: um parâmetro de moeda ou de data tem um formato de objeto definido e não pode ser enviado como texto simples.
• Componentes: os parâmetros de cabeçalho, de corpo e de botão são listas separadas e não podem ser fundidos em uma só.

A edição que quebra a produção

Os templates são editados por pessoas que não são as pessoas que chamam a API. Alguém adiciona uma variável para deixar a mensagem mais clara, o template é aprovado de novo, e todo envio feito pela integração que não mudou começa a falhar.

Vale se defender disso em vez de descobrir na hora. Assinar os webhooks de status de template faz com que uma edição chegue como um evento, e tratar a quantidade de variáveis de um template como parte do contrato da integração, revisada quando ela muda, impede que uma melhoria de redação vire uma queda de serviço.

Erros comuns

• Enviar um parâmetro a mais por precaução. Mais é tão errado quanto menos.
• Tratar parâmetros posicionais como se fossem nomeados. Eles são combinados só pela posição.
• Editar um template sem conferir o código que envia ele.

Perguntas frequentes

Continue lendo