Campagnes

Une campagne envoie le même message à chaque contact d'un groupe, vague après vague, à la cadence que vous fixez. La passerelle répartit les messages sur vos téléphones, suit chacun d'eux et montre en direct combien sont partis, ont été reçus ou ont échoué.

Tout ce qui est décrit ici se passe dans Campagnes, dans la section Messages du menu.

À quoi servent les campagnes

• Annoncer une promotion, une ouverture, un changement de prix à tous vos clients.
• Rappeler un rendez-vous ou une échéance à une liste de personnes.
• Informer les membres d'une association, les parents d'une école, le personnel d'une entreprise.

Pour un seul message ou une courte liste saisie à la main, utilisez plutôt l'Envoi rapide : voir Envoyer des messages.

Avant de commencer

• Un groupe de contacts contenant les destinataires : voir Contacts et groupes.
• Au moins un téléphone connecté avec des SIM capables d'envoyer : voir Appareils.
• Un compte Opérateur ou Superadministrateur. Un compte Lecture seule voit les campagnes mais aucun bouton.

Créer une campagne

Cliquez sur Nouvelle campagne. La fenêtre Créer une campagne compte trois étapes.

Étape 1 : Nom et destinataires

À la création, la passerelle prend les membres joignables du groupe à cet instant :

• les contacts désinscrits (STOP) sont écartés ;
• un numéro présent deux fois n'est envoyé qu'une fois ;
• un groupe sans aucun contact joignable est refusé, avec une explication, plutôt que de donner une campagne vide ;
• une campagne compte au plus 50 000 destinataires.

Étape 2 : Message

Important : une campagne envoie le même texte à tout le monde. Les variables d'un modèle sont résolues une seule fois, à la création, sans les informations d'aucun contact : {prenom|Cher client} devient « Cher client » pour tous, et {prenom} sans repli reste visible tel quel. Utilisez des valeurs de repli, ou écrivez le texte sans variable.

Étape 3 : Cadence et planification

Laissez les champs de cadence vides pour utiliser les valeurs par défaut de la passerelle. La cadence d'une campagne est un plafond : la vitesse réelle dépend aussi de vos téléphones, du quota de chaque SIM et des limites par SIM des réglages, par minute et intervalle minimal entre deux SMS (voir Cadence des SIM).

Le Récapitulatif en bas rappelle ce qui va se passer. Ensuite :

• Envoyer maintenant crée la campagne et la démarre immédiatement.
• Programmer la crée à l'état Programmée ; elle démarre d'elle-même à l'heure choisie. D'ici là, vous pouvez la modifier, la démarrer plus tôt avec Lancer, ou l'annuler.

Si la campagne est créée mais ne peut pas démarrer (aucun téléphone en ligne, par exemple), la fenêtre se ferme quand même et un message en donne la raison : la campagne reste dans la liste en Brouillon, avec son bouton Lancer. Ne la créez pas une seconde fois.

Suivre une campagne

Chaque ligne de la liste montre le statut, une barre de progression et les compteurs :

Pendant l'envoi, la ligne affiche aussi la cadence, la date de lancement et une fin estimée, calculée à partir de la cadence choisie.

Le filtre Statut restreint la liste à un statut :

Le statut est toujours piloté par la passerelle : il ne se modifie jamais à la main, seulement par les boutons ci-dessous.

Actions

Le bouton principal d'une ligne dépend de son statut (Lancer, Mettre en pause, Reprendre ou Relancer). Le menu ... en fin de ligne liste toutes les actions, et reste visible même sur un écran étroit où le tableau défile à l'horizontale. Une action attendue mais que le statut ne permet pas encore (supprimer une campagne en cours, par exemple) reste dans le menu, grisée, avec la raison écrite en dessous.

Pour renvoyer une campagne terminée à tout le groupe, dupliquez-la.

Relancer une campagne annulée

Relancer reprend une campagne annulée, pour les destinataires qui n'ont pas reçu le message : ceux qu'elle n'avait pas encore atteints, et ceux dont le message a été retiré de la file au moment de l'annulation. La fenêtre indique combien ils sont. Les destinataires qui ont déjà reçu le message ne le reçoivent jamais une seconde fois.

La campagne garde son message, ses liens courts, sa cadence et ses statistiques : les compteurs continuent là où ils étaient, et le compteur Annulés revient à zéro à mesure que les destinataires repassent En attente. Les pauses de nuit et du dimanche s'appliquent comme d'habitude.

Une fois relancée et partie, une campagne garde son texte et sa cadence figés, même si vous avez programmé la relance : seul Renommer reste possible. Les destinataires dont le message a échoué ne sont pas relancés ; pour les atteindre, dupliquez la campagne en une nouvelle.

Relancer est grisé quand il ne reste personne à qui envoyer : chaque destinataire a déjà reçu le message ou a échoué.

Supprimer une campagne

La suppression retire la campagne, sa liste de destinataires et ses statistiques, définitivement. Une fenêtre de confirmation le rappelle avant toute chose.

• Les messages déjà envoyés restent dans l'historique des messages et les conversations : ils sont votre trace de ce qui est parti.
• Ses liens courts continuent de fonctionner, puisque des destinataires peuvent encore les ouvrir des jours plus tard. Ils ne sont simplement plus rattachés à une campagne dans Liens courts.
• Une campagne En cours ou En pause ne peut pas être supprimée : annulez-la d'abord, puis supprimez-la.
• Juste après une annulation, un message qui était déjà sur un téléphone peut encore être en route. Supprimer reste grisé (« Des messages sont encore en route ») jusqu'à ce qu'il soit réglé, ce qui prend au plus quelques minutes.

Pauses de nuit et du dimanche

Dans Paramètres > Envoi, la Pause nocturne des campagnes et Suspendre les campagnes le dimanche ne retiennent que les campagnes. Pendant une pause :

• une campagne en cours reste En cours mais ne libère rien, puis continue d'elle-même à la fin de la pause. Vous n'avez jamais à la relancer à la main ;
• les messages de campagne déjà en file attendent aussi : une vague libérée à 19 h 59 ne part pas à 22 h ;
• tout le reste part à toute heure : envoi rapide, appels d'API, réponses de conversation, réponses automatiques.

Les pauses se lisent dans le fuseau de la plateforme. Voir Paramètres.

Ce qui influe aussi sur une campagne

Par l'API

Avec une clé API, la lecture demande la portée read et toute modification la portée admin. Voir Clés API.

Sans scheduledAt, la campagne est créée en brouillon et attend /start ; avec un scheduledAt futur, elle est programmée. Une date passée est refusée (SCHEDULED_AT_IN_PAST). L'événement campaign.completed peut prévenir vos outils : voir Webhooks.

Une relance garde le même identifiant de campagne. Relancer une campagne qui n'est pas annulée renvoie 403 VALIDATION_ERROR ; relancer une campagne sans destinataire restant renvoie 422 VALIDATION_ERROR. Supprimer une campagne en cours ou en pause, ou une campagne annulée dont un message est encore en route, renvoie 403 CAMPAIGN_NOT_DELETABLE. Modifier autre chose que le nom d'une campagne partie renvoie 403 CAMPAIGN_NOT_EDITABLE.

Dépannage