Passer au contenu principal
POST
/
campaigns
/
{id}
/
launch
Lancer une campagne
curl --request POST \
  --url https://api.wachap.com/v1/campaigns/{id}/launch \
  --header 'Authorization: Bearer <token>'

Lancer une campagne

Démarrez l’envoi des messages d’une campagne avec vérification automatique des limites.

Endpoint

/v1/campaigns/:id/launch

Headers

Authorization
string
requis
Bearer token avec votre Secret Key (format: Bearer sk_...)

URL Parameters

id
string
requis
L’identifiant de la campagne

Vérifications automatiques

Avant de lancer la campagne, le système vérifie automatiquement :
  • Subscription active - Vous avez un abonnement valide
  • Subscription non expirée - Votre abonnement n’est pas expiré
  • Messages suffisants - Vous avez assez de messages restants pour tous les contacts
Si une vérification échoue, la campagne ne sera pas lancée.

Exemples de requêtes

curl -X POST https://api.wachap.com/v1/campaigns/campaign_abc123/launch \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_CLE_SECRETE"

Exemple de réponse (Succès)

{
  "success": true,
  "message": "Campagne lancée avec succès",
  "campaign": {
    "id": "campaign_abc123",
    "status": "running",
    "totalContacts": 150,
    "sent": 0,
    "pending": 150
  }
}

Exemple de réponse (Erreur)

{
  "success": false,
  "error": {
    "message": "Messages insuffisants pour lancer cette campagne...",
    "code": "INSUFFICIENT_MESSAGES",
    "status": 403,
    "details": {
      "remaining": 50,
      "required": 150,
      "missing": 100
    }
  }
}

Notes importantes

  • Une campagne ne peut être lancée que si son statut est draft ou paused.
  • La campagne doit contenir au moins 1 contact.
  • Les messages sont envoyés avec le délai configuré.

Codes d’erreur

CodeDescription
400CAMPAIGN_NO_CONTACTS - La campagne ne contient aucun contact
401INVALID_SECRET_KEY - Clé secrète invalide
403NO_ACTIVE_SUBSCRIPTION, SUBSCRIPTION_EXPIRED, MESSAGE_LIMIT_REACHED
404CAMPAIGN_NOT_FOUND - Campagne non trouvée
409CAMPAIGN_ALREADY_RUNNING, CAMPAIGN_ALREADY_COMPLETED

Autorisations

Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de chemin

id
string
requis

Réponse

200

OK