Mensagens
Templates do WhatsApp Oficial
Envie templates aprovados pela Meta usando um canal WhatsApp Cloud.
Use POST /api/v1/messages/template para um contrato explícito de template oficial.
{
"to": "+5511999999999",
"channelCode": "whatsapp-oficial",
"template": {
"name": "confirmacao_pedido",
"language": "pt_BR"
},
"bodyVariables": ["Maria", "#1234"]
}Você também pode identificar o template pelo campo template.id. Ao usar nome, template.name e template.language são obrigatórios.
Variáveis ficam no nível raiz
bodyVariables, headerParameter e buttonParameters são irmãos de template; eles não ficam dentro do objeto template.
Header de texto
{
"headerParameter": {
"kind": "text",
"text": "Pedido #1234"
}
}Header de mídia
{
"headerParameter": {
"kind": "media",
"format": "DOCUMENT",
"url": "https://cdn.example.com/pedido-1234.pdf",
"mimeType": "application/pdf",
"fileName": "pedido-1234.pdf"
}
}Botões dinâmicos
{
"buttonParameters": [
{
"index": 0,
"subType": "url",
"value": "pedido-1234"
}
]
}Os valores devem seguir exatamente a ordem e o formato do template aprovado. Veja Enviar template oficial para todos os campos.