Criar template Meta

POST https://app.sendapp.ai/api/whatsapp-meta/create_template

Cria um template WhatsApp Meta e envia-o à Meta para aprovação. Passe os campos simples (body e os opcionais header/footer) e nós construímos os componentes; para templates avançados pode passar diretamente o array components no formato Meta. No body use {{1}}, {{2}}… como variáveis.

O template deve ser aprovado pela Meta antes de poder ser enviado. A aprovação pode demorar algum tempo.

Cabeçalho com um ficheiro (PDF, imagem ou vídeo): carregue primeiro o ficheiro com Carregar media, depois passe o seu URL em header_media_url e nos components ponha um HEADER com format DOCUMENT (ou IMAGE / VIDEO): o ficheiro chega à Meta como exemplo para a aprovação. Um botão URL só pode ter uma parte variável no fim do link ({{1}}), com um exemplo em example. Veja o segundo exemplo.

Parâmetros

10 · 5 obrigatórios

apikey obrigatório

A tua API Key.

token obrigatório

Token da conta WhatsApp Meta.

name obrigatório

Nome do template: minúsculas, apenas letras, números e underscores.

category obrigatório

MARKETING ou UTILITY.

body obrigatório

Texto do corpo (obrigatório se não passar components).

language opcional

Código de idioma (padrão it).

header opcional

Texto do cabeçalho (máx. 60 caracteres).

footer opcional

Texto do rodapé (máx. 60 caracteres).

components opcional

Array/JSON dos componentes em formato Meta, para templates avançados.

header_media_url opcional

URL do ficheiro do cabeçalho (PDF, imagem ou vídeo) carregado com Carregar media. Necessário quando os components têm um HEADER com um ficheiro.

Precisa de ajuda com a integração? info@sendapp.live

Pedido

curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/create_template' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "name": "promo_estate",
    "category": "MARKETING",
    "language": "it",
    "header": "Oferta especial",
    "body": "Olá {{1}}, {{2}}% de desconto só hoje!",
    "footer": "Responda STOP para cancelar a subscrição"
  }'

# Modelo com PDF no cabeçalho e botão com link variável
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/create_template' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "name": "preventivo_pdf",
    "category": "UTILITY",
    "language": "it",
    "header_media_url": "https://cdn.sendapp.example/media/preventivo-esempio.pdf",
    "components": [
      { "type": "HEADER", "format": "DOCUMENT" },
      { "type": "BODY", "text": "Olá {{1}}, em anexo o seu orçamento.", "example": { "body_text": [["Mario"]] } },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Política de privacidade", "url": "https://example.com/privacy/{{1}}", "example": ["cliente-1042"] }
      ] }
    ]
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/create_template');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'apikey'   => 'YOUR_API_KEY',
        'token'    => 'YOUR_ACCOUNT_TOKEN',
        'name'     => 'promo_estate',
        'category' => 'MARKETING',
        'body'     => 'Olá {{1}}, {{2}}% de desconto só hoje!',
    ]),
]);
echo curl_exec($ch);

const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/create_template', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_API_KEY',
    token: 'YOUR_ACCOUNT_TOKEN',
    name: 'promo_estate',
    category: 'MARKETING',
    body: 'Olá {{1}}, {{2}}% de desconto só hoje!'
  })
});
console.log(await res.json());

Resposta

{
  "status": "success",
  "message": "Template created successfully.",
  "template_id": "1234567890123456"
}

{
  "status": "error",
  "message": "The name can only contain lowercase letters, numbers and underscores."
}