Crea bozza campagna

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

Crea una campagna come bozza. Non invia nulla: per inviarla usa poi l'endpoint di avvio. I destinatari si scelgono per tag; il messaggio può essere testo o un template approvato. Nel testo puoi usare i segnaposto {{name}}, {{phone}}, {{email}}.

Creare una bozza NON invia messaggi. Per inviare serve una chiamata esplicita all'endpoint di avvio.

Parametri

apikey obbligatorio

La tua API Key.

token obbligatorio

Token dell'account.

name obbligatorio

Nome della campagna.

channel obbligatorio

whatsapp, whatsapp-web o sms.

message_type obbligatorio

template, text, text_media o media_only.

message opzionale

Testo del messaggio (per text / text_media).

template_name opzionale

Nome del template (per message_type=template).

template_language opzionale

Lingua del template.

media_url opzionale

URL pubblico del media (dall'endpoint di upload).

media_type opzionale

image, audio, video o document.

recipient_type opzionale

all (tutti i contatti) o tags (filtra per tag). Default all.

tags opzionale

Array di tag dei destinatari (se recipient_type=tags).

scheduled_at opzionale

Data/ora di invio programmato. Omesso = invio manuale.

Richiesta

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 estate",
    "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 estate',
        '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 estate',
    channel: 'whatsapp',
    message_type: 'template',
    template_name: 'promo_estate',
    recipient_type: 'tags',
    tags: ['shopify']
  })
});
console.log(await res.json()); // { status:'success', campaign_id: 148 }

Risposta (200 OK)

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

Errore

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