Crea template Meta

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

Crea un template WhatsApp Meta e lo invia a Meta per l'approvazione. Passa i campi semplici (body, e opzionali header/footer) e costruiamo noi i componenti; per template avanzati puoi passare direttamente l'array components in formato Meta. Nel body usa {{1}}, {{2}}… come variabili.

Il template deve essere approvato da Meta prima di poter essere inviato. L'approvazione può richiedere del tempo.

Intestazione con un file (PDF, immagine o video): carica prima il file con Carica media, poi passa il suo URL in header_media_url e nei components metti un HEADER con format DOCUMENT (o IMAGE / VIDEO): il file arriva a Meta come esempio per l'approvazione. Un pulsante URL può avere una parte variabile solo alla fine del link ({{1}}), con un esempio in example. Vedi il secondo esempio.

Parametri

10 · 5 obbligatori

apikey obbligatorio

La tua API Key.

token obbligatorio

Token dell'account WhatsApp Meta.

name obbligatorio

Nome del template: minuscolo, solo lettere, numeri e underscore.

category obbligatorio

MARKETING o UTILITY.

body obbligatorio

Testo del corpo (obbligatorio se non passi components).

language opzionale

Codice lingua (default it).

header opzionale

Testo dell'intestazione (max 60 caratteri).

footer opzionale

Testo del piè di pagina (max 60 caratteri).

components opzionale

Array/JSON dei componenti in formato Meta, per template avanzati.

header_media_url opzionale

URL del file dell'intestazione (PDF, immagine o video) caricato con Carica media. Serve quando i components hanno un HEADER con un file.

Serve aiuto con l'integrazione? info@sendapp.live

Richiesta

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": "Offerta speciale",
    "body": "Ciao {{1}}, sconto del {{2}}% solo per oggi!",
    "footer": "Rispondi STOP per disiscriverti"
  }'

# Template con PDF in testa e pulsante con link variabile
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": "Ciao {{1}}, in allegato il tuo preventivo.", "example": { "body_text": [["Mario"]] } },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Informativa privacy", "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'     => 'Ciao {{1}}, sconto del {{2}}% solo per oggi!',
    ]),
]);
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: 'Ciao {{1}}, sconto del {{2}}% solo per oggi!'
  })
});
console.log(await res.json());

Risposta

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

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