Créer un brouillon de campagne

POSThttps://app.sendapp.ai/api/campaigns/draft

Crée une campagne en tant que brouillon. Elle n'envoie rien : pour l'envoyer, utilisez ensuite l'endpoint de lancement. Les destinataires sont choisis par tag ; le message peut être du texte ou un modèle approuvé. Dans le texte, vous pouvez utiliser les espaces réservés {{name}}, {{phone}}, {{email}}.

Créer un brouillon N'envoie PAS de messages. Pour envoyer, un appel explicite à l'endpoint de lancement est requis.

Paramètres

apikey obligatoire

Votre API Key.

token obligatoire

Token du compte.

name obligatoire

Nom de la campagne.

channel obligatoire

whatsapp, whatsapp-web ou sms.

message_type obligatoire

template, text, text_media ou media_only.

message facultatif

Texte du message (pour text / text_media).

template_name facultatif

Nom du template (pour message_type=template).

template_language facultatif

Langue du template.

media_url facultatif

URL publique du média (depuis l'endpoint de chargement).

media_type facultatif

image, audio, video ou document.

recipient_type facultatif

all (tous les contacts) ou tags (filtrer par tag). Par défaut all.

tags facultatif

Tableau de tags des destinataires (si recipient_type=tags).

scheduled_at facultatif

Date/heure d'envoi programmé. Omis = envoi manuel.

Requête

curl -X POST 'https://app.sendapp.ai/api/campaigns/draft' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "name": "Promo été",
    "channel": "whatsapp",
    "message_type": "template",
    "template_name": "promo_estate",
    "recipient_type": "tags",
    "tags": ["shopify"]
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/campaigns/draft');
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 été',
        'channel'        => 'whatsapp',
        'message_type'   => 'template',
        'template_name'  => 'promo_estate',
        'recipient_type' => 'tags',
        'tags'           => ['shopify'],
    ]),
]);
echo curl_exec($ch); // { status:'success', campaign_id: 148 }

const res = await fetch('https://app.sendapp.ai/api/campaigns/draft', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_API_KEY',
    token: 'YOUR_ACCOUNT_TOKEN',
    name: 'Promo été',
    channel: 'whatsapp',
    message_type: 'template',
    template_name: 'promo_estate',
    recipient_type: 'tags',
    tags: ['shopify']
  })
});
console.log(await res.json()); // { status:'success', campaign_id: 148 }

Réponse (200 OK)

{
  "status": "success",
  "message": "Draft saved.",
  "campaign_id": 512
}

Erreur

{
  "status": "error",
  "message": "Draft not found or already launched."
}