Créer un template Meta

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

Crée un modèle WhatsApp Meta et l'envoie à Meta pour approbation. Transmettez les champs simples (body, et les champs optionnels header/footer) et nous construisons les composants ; pour les modèles avancés, vous pouvez transmettre directement le tableau components au format Meta. Dans le body, utilisez {{1}}, {{2}}… comme variables.

Le template doit être approuvé par Meta avant de pouvoir être envoyé. L'approbation peut prendre un certain temps.

En-tête avec un fichier (PDF, image ou vidéo) : envoyez d'abord le fichier avec Envoyer un média, puis passez son URL dans header_media_url et mettez dans les components un HEADER avec format DOCUMENT (ou IMAGE / VIDEO) : le fichier arrive chez Meta comme exemple pour l'approbation. Un bouton URL ne peut avoir une partie variable qu'à la fin du lien ({{1}}), avec un exemple dans example. Voir le deuxième exemple.

Paramètres

10 · 5 obligatoires

apikey obligatoire

Votre API Key.

token obligatoire

Token du compte WhatsApp Meta.

name obligatoire

Nom du template : minuscules, uniquement lettres, chiffres et underscores.

category obligatoire

MARKETING ou UTILITY.

body obligatoire

Texte du corps (requis si vous ne passez pas components).

language facultatif

Code de langue (par défaut it).

header facultatif

Texte de l'en-tête (max 60 caractères).

footer facultatif

Texte du pied de page (max 60 caractères).

components facultatif

Tableau/JSON des composants au format Meta, pour les templates avancés.

header_media_url facultatif

URL du fichier de l'en-tête (PDF, image ou vidéo) envoyé avec Envoyer un média. Nécessaire quand les components ont un HEADER avec un fichier.

Besoin d'aide pour l'intégration ? info@sendapp.live

Requête

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": "Offre spéciale",
    "body": "Bonjour {{1}}, {{2}}% de réduction aujourd'hui seulement !",
    "footer": "Répondez STOP pour vous désabonner"
  }'

# Modèle avec PDF en en-tête et bouton avec lien variable
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": "Bonjour {{1}}, votre devis est en pièce jointe.", "example": { "body_text": [["Mario"]] } },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Politique de confidentialité", "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'     => 'Bonjour {{1}}, {{2}}% de réduction aujourd'hui seulement !',
    ]),
]);
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: 'Bonjour {{1}}, {{2}}% de réduction aujourd'hui seulement !'
  })
});
console.log(await res.json());

Réponse

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

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