Skip to main content
POST
Create a WABA message template
Submete um novo template de mensagem à Meta para revisão.
  • name — minúsculas, no formato snake_case (ex: boas_vindas_cliente).
  • categoryMARKETING, UTILITY ou AUTHENTICATION.
  • language — código de idioma da Meta (ex: pt_BR).
  • bodyText — corpo do template. Use placeholders {{1}}, {{2}}… para variáveis.
  • bodyExample — um valor de exemplo por placeholder, exigido pela Meta na submissão.
  • footerText — rodapé opcional.
Escolha o tipo de header pelo headerFormat:
  • TEXT (padrão) — use headerText.
  • IMAGE, VIDEO ou DOCUMENT — informe a mídia de exemplo em headerMediaUrl (URL pública) ou headerMediaBase64. O backend faz o upload da amostra na API de Resumable Upload da Meta automaticamente — você não precisa gerar o header_handle manualmente.

Botões

Passe buttons[] (a Meta limita por tipo — ex: 1 telefone, até 2 URLs):
  • QUICK_REPLY{ "type": "QUICK_REPLY", "text": "Sim" }
  • URL{ "type": "URL", "text": "Ver pedido", "url": "https://site.com/{{1}}", "urlExample": "https://site.com/42" } (urlExample só é necessário quando a url tem {{1}}).
  • PHONE_NUMBER{ "type": "PHONE_NUMBER", "text": "Ligar", "phoneNumber": "+5511999999999" }
  • COPY_CODE{ "type": "COPY_CODE", "example": "PROMO10" }
A resposta em data traz o id do template criado e o status inicial (normalmente PENDING).
A aprovação é feita pela Meta e pode levar de minutos a horas. Só templates APPROVED podem ser enviados.

Authorizations

Authorization
string
header
required

API Key para autenticação. Formato: <API_KEY>

Path Parameters

id
string
required

Body

name
string
required
Minimum string length: 1
Pattern: ^[a-z0-9_]+$
category
required
Allowed value: "MARKETING"
language
string
required
Minimum string length: 2
bodyText
string
required
Minimum string length: 1
headerFormat
Allowed value: "TEXT"
headerText
string
headerMediaUrl
string
headerMediaBase64
string
headerMediaMime
string
bodyExample
string[]
buttons
object[]

Response

Resposta bem-sucedida

success
boolean
required
data
any
error
string
code
string