Envoyer un modèle WhatsApp (Meta)

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

Envoyez un modèle approuvé via la WhatsApp Cloud API de Meta (type=template). Les modèles servent à démarrer une conversation ou à écrire au client en dehors de la fenêtre de 24 heures.

Le modèle doit déjà être approuvé par Meta. Voir Créer un modèle pour en créer un. Les variables du texte ({{1}}, {{2}}…) sont renseignées via le tableau components.

Paramètres

7 · 6 obligatoires

apikey obligatoire

Votre API Key.

token obligatoire

Token du compte.

number obligatoire

Numéro du destinataire au format international sans + (ex. 1234567890).

type obligatoire

Doit être template.

template.name obligatoire

Nom exact du modèle approuvé.

template.language.code obligatoire

Code de langue du modèle (ex. it, en_US).

template.components facultatif

Valeurs des variables du modèle (body, header, boutons). Omettez si le modèle n'a pas de variables.

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

Requête

# Modèle sans variables
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/send' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "number": "1234567890",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": { "code": "en_US" }
    }
  }'

# Modèle avec variables {{1}} et {{2}}
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/send' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "number": "1234567890",
    "type": "template",
    "template": {
      "name": "promo_sconto",
      "language": { "code": "it" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Mario" },
            { "type": "text", "text": "20" }
          ]
        }
      ]
    }
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/send');
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',
        'number'   => '1234567890',
        'type'     => 'template',
        'template' => [
            'name'     => 'promo_sconto',
            'language' => ['code' => 'it'],
            'components' => [[
                'type' => 'body',
                'parameters' => [
                    ['type' => 'text', 'text' => 'Mario'],
                    ['type' => 'text', 'text' => '20'],
                ],
            ]],
        ],
    ]),
]);
echo curl_exec($ch);

const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_API_KEY',
    token: 'YOUR_ACCOUNT_TOKEN',
    number: '1234567890',
    type: 'template',
    template: {
      name: 'promo_sconto',
      language: { code: 'it' },
      components: [{
        type: 'body',
        parameters: [
          { type: 'text', text: 'Mario' },
          { type: 'text', text: '20' }
        ]
      }]
    }
  })
});
console.log(await res.json());

Réponse

{
  "status": "success",
  "message": "Message sent successfully",
  "message_id": "wamid.HBgLMzkxMjM0NTY3ODkwFQIAERgSN0EwMjBBQkZDRDEyMzQ1Njc4"
}

{
  "status": "error",
  "message": "The template parameters do not match the approved template."
}