Templates

​

O objeto template

​

Criar um template

curl -X POST https://api.ararahq.com/v1/templates \
  -H "Authorization: Bearer $ARARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pedido_confirmado",
    "category": "UTILITY",
    "language": "pt_BR",
    "body": "Oi {{1}}, seu pedido {{2}} foi confirmado. Total: R$ {{3}}.",
    "footer": "Acompanhe pelo nosso site",
    "samples": { "1": "João", "2": "12345", "3": "147,90" }
  }'

{
  "id": "a7f3c1e2-4b5d-6789-abcd-ef0123456789",
  "name": "pedido_confirmado",
  "category": "UTILITY",
  "language": "pt_BR",
  "providerStatus": "PENDING",
  "rejectionReason": null,
  "availableForSending": true,
  "bodyPreview": "Oi {{1}}, seu pedido {{2}} foi confirmado. Total: R$ {{3}}.",
  "createdAt": "2026-09-15T14:30:00Z"
}

​

Regras que valem saber

• Aprovação é por conta WhatsApp Business. Trocou de número ou de conexão, o template aprovado fica na conta antiga e aparece com availableForSending: false. Recrie no número ativo.
• Nome repetido responde 409 CONFLICT. O mesmo código vale para conteúdo bloqueado pela moderação da Arara.
• Corpo não começa nem termina com variável. Mande um exemplo por variável em samples (objeto, não array): a Meta usa na revisão.
• AUTHENTICATION tem conteúdo fixo. A Arara envia à Meta o texto {{1}} é o seu código de verificação com um botão de copiar código, em pt_BR. body, buttons e language enviados não mudam o template. No envio, passe o código como única variável.
• Botões. Até 10, texto de até 20 caracteres, no máximo 2 de link (URL e SMART_LINK) e 1 de telefone. O tipo FLOW abre um formulário e o tipo CHARGE leva uma cobrança.
• Carrossel. De 2 a 10 cards, cada um com mídia, texto e até 2 botões, todos com a mesma estrutura de botões.
• Biblioteca da Meta. POST /v1/templates/library cria um template UTILITY que já nasce aprovado. Exige número conectado (422 GUPSHUP_APP_NOT_READY sem ele).
• id é UUID. Passar o nome em GET /v1/templates/{id} responde 400 INVALID_PATH_PARAM. Para buscar por nome, use GET /v1/templates?name=.
• Template pausado não envia. PAUSED responde 422 TEMPLATE_PAUSED no envio; DISABLED e não aprovado respondem 422 TEMPLATE_NOT_SENDABLE.
• Apagar é irreversível. A Arara apaga primeiro na Meta; se a Meta recusar, nada é apagado.
• Conta ativa. Todas as rotas exigem conta ativada (403 ACCOUNT_NOT_ACTIVATED).

​

Limite de templates

​

Endpoints

​

Erros mais comuns

​

Próximos passos