Meta-Vorlage erstellen

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

Erstellt eine WhatsApp-Meta-Vorlage und reicht sie bei Meta zur Genehmigung ein. Übergeben Sie die einfachen Felder (body sowie die optionalen header/footer) und wir erstellen die Komponenten für Sie; für erweiterte Vorlagen können Sie das Array components direkt im Meta-Format übergeben. Verwenden Sie im Body {{1}}, {{2}}… als Variablen.

Die Vorlage muss von Meta genehmigt werden, bevor sie gesendet werden kann. Die Genehmigung kann einige Zeit dauern.

Header mit einer Datei (PDF, Bild oder Video): Lade die Datei zuerst mit Medien hochladen hoch, übergib dann ihre URL in header_media_url und setze in die components einen HEADER mit format DOCUMENT (oder IMAGE / VIDEO): Die Datei geht als Beispiel für die Freigabe an Meta. Ein URL-Button kann nur am Ende des Links einen variablen Teil haben ({{1}}), mit einem Beispiel in example. Siehe das zweite Beispiel.

Parameter

10 · 5 Pflichtfelder

apikey erforderlich

Ihr API Key.

token erforderlich

Token des WhatsApp-Meta-Kontos.

name erforderlich

Vorlagenname: Kleinbuchstaben, nur Buchstaben, Zahlen und Unterstriche.

category erforderlich

MARKETING oder UTILITY.

body erforderlich

Textkörper (erforderlich, wenn Sie keine components übergeben).

language optional

Sprachcode (Standard it).

header optional

Kopfzeilentext (max. 60 Zeichen).

footer optional

Fußzeilentext (max. 60 Zeichen).

components optional

Array/JSON der Komponenten im Meta-Format, für erweiterte Vorlagen.

header_media_url optional

URL der Header-Datei (PDF, Bild oder Video), hochgeladen mit Medien hochladen. Nötig, wenn die components einen HEADER mit einer Datei haben.

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

Anfrage

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": "Sonderangebot",
    "body": "Hallo {{1}}, {{2}}% Rabatt nur heute!",
    "footer": "Antworten Sie mit STOP, um sich abzumelden"
  }'

# Vorlage mit PDF im Header und Button mit variablem Link
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": "Hallo {{1}}, anbei dein Angebot.", "example": { "body_text": [["Mario"]] } },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Datenschutzhinweis", "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'     => 'Hallo {{1}}, {{2}}% Rabatt nur heute!',
    ]),
]);
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: 'Hallo {{1}}, {{2}}% Rabatt nur heute!'
  })
});
console.log(await res.json());

Antwort

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

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