Skip to main content
Use um template para enviar uma mensagem aprovada pelo WhatsApp, com valores variáveis preenchidos por você. Para entender o ciclo de aprovação, veja Templates.
Escopos necessários: templates:write para submeter, templates:read para consultar e messages:write para enviar.
1

Submeta o template

A resposta traz variables com os placeholders do corpo e o status inicial.
2

Aguarde a aprovação

O provedor decide no tempo dele. Acompanhe de duas formas:
  • Webhook: assine template.* e espere template.approved ou template.rejected.
  • Consulta: GET /v1/templates/{id} e verifique status.
Se o template for rejeitado, rejection_reason indica o motivo. Corrija e submeta de novo com outro nome.
3

Envie com parâmetros

Com o template approved, passe template.id e os body_parameters na ordem dos placeholders.

Regras de validação

A Routa valida o template no aceite, então estes erros voltam na hora:
O SDK expõe templates.submit() apenas com corpo de texto. Para cabeçalho, rodapé e botões, use a API REST diretamente. Veja Templates.