API de Templates — Criar, Atualizar, Excluir

​

Categoria

• MARKETING — mensagens promocionais (mais sensíveis às políticas do WhatsApp).
• UTILITY — mensagens transacionais (atualizações de conta, alertas, lembretes).
• OTP — mensagens de código único / de verificação.

​

Estrutura do template

​

Header

• API REST: passe header.url (URL http(s) pública) ou header.base64 (data URI) — o base64 é re-hospedado no servidor automaticamente.
• MCP: header.url apenas — base64 não é suportado via MCP.

​

Body

• Até 1024 caracteres.
• Variáveis escritas como {{nome}} (estilo nomeado).
• O body não pode começar nem terminar com uma variável.
• Emojis e múltiplas variáveis são permitidos.

​

Footer

​

Buttons

• Botão de URL dinâmica: a URL termina com uma variável (ex.: https://loja.com/promo/{{link}}) — no máximo uma variável, nunca no domínio. O valor de exemplo vai em examples.
• Copy-code: o valor vai no botão como example (array, ex.: ["PROMO10"]), somente alfanumérico, até 15 caracteres. Não use para chaves PIX ou e-mails — coloque esses no body como uma {{variable}}.
• Botões são permitidos junto com um header de vídeo ou documento (PDF).

​

Variáveis & examples (obrigatório)

400 { "code": "TEMPLATE_EXAMPLES_REQUIRED", "details": { "missing": ["desconto"] } }

​

Limites de caracteres

​

Criar via API REST

curl -X POST https://pilotstatus.com.br/v1/templates \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_your_token_here" \
  -d '{
  "name": "promo_cupom",
  "category": "MARKETING",
  "language": "pt_BR",
  "body": {
    "header": { "type": "IMAGE", "url": "https://cdn.exemplo.com/banner.png" },
    "body":   { "text": "Oi {{nome}}! Use e ganhe {{desconto}} de desconto." },
    "footer": { "text": "Promoção por tempo limitado" },
    "buttons": [
      { "type": "QUICK_REPLY",  "text": "Quero!" },
      { "type": "URL",          "text": "Comprar", "url": "https://loja.com/promo/{{link}}" },
      { "type": "PHONE_NUMBER", "text": "Falar",   "phone_number": "+5511999998888" },
      { "type": "COPY_CODE",    "example": ["PROMO10"] }
    ]
  },
  "examples": { "nome": "Maria", "desconto": "10%", "link": "abc123" }
}'

• body pode ser um objeto (recomendado), uma string JSON ou texto simples (templates só de body).
• Edite com PUT /v1/templates/{id} (mesmo formato); remova com DELETE /v1/templates/{id} (também exclui da Meta para templates Meta; retorna { deleted: true, id }).
• GET /v1/templates / GET /v1/templates/{id} retornam source (META | PILOT_STATUS), metaStatus (APPROVED | PENDING | REJECTED | DISABLED | null), metaLanguage e sendable — em um número Meta apenas templates META com metaStatus: "APPROVED" são enviáveis.

​

Aprovação

• Números Meta: os templates são enviados à Meta para revisão (“Submit to Meta” em /templates, ou ao salvar). Categorias, idioma e status seguem as regras da Meta.
• Números não oficiais (Pilot Status web): os templates são criados localmente e ficam imediatamente utilizáveis — sem etapa de aprovação.

​

Não suportado

​

Erros de envio & rejeição

​

Verificado antes de enviar à Meta

​

Validação do lado da API

​

A Meta rejeitou o envio

​

Rejeitado após revisão

​

Bloqueios ao enviar (mesmo aprovado)

​

Erro comum ao enviar