Campagnes

Liste les campagnes de cette organisation, de la plus récente à la plus ancienne. Les campagnes MARKETING sont des envois en masse vers des segments ou tous les contacts ; les campagnes TRANSACTIONAL sont des envois à destinataire unique déclenchés par des déclencheurs ou l’API.

Lire une campagne complète : statut, planification, audience (segments ou tous les contacts), modèles de canal et compteurs de livraison (envoyés, livrés, ouverts, échoués).

Crée une campagne comme BROUILLON : une campagne marketing de masse (par ex. un envoi de modèle WhatsApp) vers des segments ou tous les contacts, ou un envoi transactionnel à destinataire unique.

Mettre à jour le nom, l’heure de planification ou l’audience d’une campagne. L’audience et la planification ne peuvent être modifiées que tant que la campagne est modifiable (marketing : BROUILLON, ANNULÉE ou ÉCHOUÉE ; transactionnel : BROUILLON, ACTIVE ou EN PAUSE).

Copie une campagne, y compris ses segments et ses modèles de canal. La copie est créée en tant que BROUILLON et n’envoie rien.

Supprime définitivement une campagne et son historique de livraison. Les campagnes marketing ne peuvent pas être supprimées lorsqu’elles sont planifiées ou en cours d’envoi ; les campagnes transactionnelles doivent d’abord être mises en pause.

Fait passer une campagne par les étapes de son cycle de vie : 'schedule' met en file une campagne MARKETING pour toute son audience (le vrai envoi de masse — immédiatement ou à l’heure prévue ; nécessite un modèle de canal) ; 'cancel' arrête une campagne marketing planifiée/en cours d’envoi et la remet en brouillon ; 'activate' active une campagne TRANSACTIONAL ; 'pause' la suspend.

Attache ou met à jour le message du canal d'une campagne — celui qui est réellement envoyé.

Ajoute des contacts précis à l’audience d’une campagne MARKETING (en plus des segments / envoyer à tous), par ex. une liste importée depuis un fichier ou filtrée en code. Nécessite une campagne modifiable avec au moins un modèle de canal.

Prévisualise le nombre de destinataires qu’une campagne MARKETING atteindra par canal, selon son audience actuelle — vérifie ça avant de planifier l’envoi.

Réessaie les destinataires en échec d’une campagne (jusqu’à 1000 par appel). Omet recipient_ids pour tous les réessayer.

Retire les destinataires en attente (pas encore envoyés) d’une campagne MARKETING modifiable. Omet contact_ids pour retirer tous ceux en attente.

Liste les champs de personnalisation (variables {{variable}}) d’une campagne avec leurs valeurs par défaut.

Crée ou met à jour un champ de personnalisation ({{variable}}) sur une campagne avec sa valeur par défaut. Les clés réservées comme first_name/last_name sont résolues depuis le contact ; les autres utilisent la valeur par défaut sauf si une entrée par destinataire la remplace.

Définis des valeurs de personnalisation par destinataire sur une campagne MARKETING. Passe une entrée par destinataire, identifié par e-mail, téléphone ou user_id. Passe dry_run pour prévisualiser quels destinataires correspondraient sans rien écrire.

Met en file une Campagne MARKETING pour l’envoyer à toute son audience. L’envoi est immédiat si la campagne n’a pas d’heure planifiée, sinon il attend ce moment. C’est le véritable envoi de masse : confirme avec l’utilisateur avant de l’exécuter. Nécessite le statut DRAFT, CANCELLED ou FAILED et au moins un modèle de canal.

Annule une campagne MARKETING au statut SCHEDULED ou SENDING : elle repasse à DRAFT et peut être modifiée puis replanifiée. Les destinataires déjà envoyés le restent.

Active une campagne TRANSACTIONAL afin qu’elle accepte les déclencheurs et commence à envoyer à des destinataires individuels. Autorisé depuis BROUILLON ou EN PAUSE ; nécessite au moins un modèle de canal.

Met en pause une campagne transactionnelle ACTIVE. Les déclencheurs sont rejetés jusqu’à sa réactivation ; la configuration est conservée.

Envoie un test d’une campagne à une seule adresse e-mail ou un seul numéro de téléphone afin que son contenu puisse être vérifié avant l’envoi réel. Fonctionne uniquement tant que la campagne est testable (marketing : BROUILLON, ANNULÉE ou ÉCHOUÉE ; transactionnel : BROUILLON, ACTIVE ou EN PAUSE).

Statistiques agrégées de livraison et d’engagement par campagne : totaux, taux de livraison et taux d’ouverture, éventuellement limités à une plage de dates.

Liste les envois individuels d’une campagne avec leur statut (sent, delivered, opened, failed, bounced). Répond à "avons-nous envoyé X à ce contact" : filtre par campagne, par contact, ou cherche par nom, e-mail ou téléphone sur toutes les Campagnes.