Le principe des scénarios
Un scénario envoie une suite d’emails aux contacts qui entrent dans une base de données hébergée. Chaque déclencheur associe une campagne à un délai, compté à partir du moment où le contact est enregistré. Trois déclencheurs à 0 jour, 3 jours et 10 jours produisent une séquence de trois messages, sans intervention.
Ce que l’API fait, et ce qu’elle ne fait pas
C’est le point à comprendre avant d’écrire la moindre ligne de code : l’API n’orchestre pas les scénarios, elle les alimente.
Le scénario lui-même se construit dans l’interface MDWorks. La base hébergée, les campagnes, les déclencheurs et leurs délais s’y définissent, et il n’existe aucun endpoint SOAP pour les créer ou les modifier. Votre système d’information ne pilote donc pas la mécanique d’envoi, il y injecte des destinataires.
Cette répartition a une conséquence pratique. Un changement de séquence, l’ajout d’un message de relance ou la modification d’un délai se font côté interface, sans toucher à votre code. À l’inverse, un scénario mal configuré ne produira rien de visible côté API : l’insertion réussira, et aucun email ne partira.
Ce qui doit exister avant le premier appel
Trois éléments, dans cet ordre :
- Les campagnes, créées dans « Automation », « Campagnes email ». Elles se construisent comme un message classique, à une différence près : les destinataires ne sont pas modifiables, puisque c’est le déclenchement du scénario qui les importe.
- La base de données hébergée, avec les requêtes complexes activées. Si la base n’apparaît pas au moment de créer le scénario, c’est presque toujours ce réglage qui manque : il se trouve dans la partie « Structure » de la base.
- Le scénario et au moins un déclencheur. Un scénario sans déclencheur existe, accepte des destinataires, et n’envoie rien.
La mise en place détaillée côté interface est décrite dans Créer un scénario.
Les deux fonctions disponibles
| Fonction | Rôle | Retour |
|---|---|---|
Envoi_Mail_Scenario_API | Insère un destinataire dans la boucle et lance le décompte | L’identifiant du destinataire, utile pour le suivre, ou un tableau contenant le message d’erreur |
Liste_Destinataires_Scenario | Relit les destinataires déjà présents dans un scénario | Un tableau d’adresses email |
Les deux passent par l’endpoint de contrôle, https://www.eml-srv.com/_soap/control.php, et s’authentifient avec le couple login et mot de passe du compte.
Envoi_Mail_Scenario_API accepte au passage les variables de personnalisation nom, prenom et p1 à p6. Elles sont portées par le destinataire, donc disponibles dans toutes les campagnes de la séquence, pas seulement la première.
Ce qui se passe après l’insertion
Le décompte démarre à l’insertion, pas à la création du scénario. Chaque déclencheur part ensuite à son délai propre. Un déclencheur réglé sur 0 jour et 0 heure envoie sa campagne immédiatement après l’enregistrement du contact.
Deux garde-fous s’appliquent avant l’insertion. Une adresse déjà désinscrite, donc présente dans votre blackliste, est refusée avec un message explicite. Une adresse syntaxiquement erronée l’est également. Dans les deux cas la fonction retourne un tableau d’erreur plutôt qu’un identifiant, ce qui reste le moyen le plus simple de distinguer un succès d’un rejet côté appelant.
L’historique des messages effectivement envoyés se consulte dans l’interface, dans la partie « Historique » du scénario.