Emails transactionnels Salesforce Marketing Cloud : API ou Journey Builder ?

Un e-mail de réinitialisation de mot de passe qui arrive en 40 minutes, une confirmation de commande noyée dans une file d’attente de campagne : la plupart des incidents d’envoi dans Salesforce Marketing Cloud viennent d’une confusion entre messages transactionnels et messages marketing. Ce guide pratique vous explique comment choisir entre l’API Transactional Messaging et les envois déclenchés via Journey Builder, comment configurer chaque option, et quelles règles de conformité s’appliquent. Vous repartirez avec une méthode de décision, des exemples d’appels REST et un plan de mise en production.

Transactionnel ou marketing : la vraie différence

Un message est transactionnel lorsqu’il est déclenché par une action précise de l’utilisateur et qu’il porte une information indispensable : confirmation de commande, code à usage unique, facture, alerte de sécurité. Un message marketing cherche à promouvoir une offre ou à engager le contact. La frontière juridique compte, car en Europe l’exemption de consentement ne couvre que le contenu strictement transactionnel.

Ce que cela change techniquement

Dans Marketing Cloud, la différence se matérialise à trois endroits : la classification d’envoi (Send Classification), le profil de livraison et le chemin d’envoi (file d’attente dédiée ou non). Un mauvais paramétrage mélange vos flux et fait subir à un code de connexion les mêmes délais qu’une newsletter de 800 000 destinataires.

Les trois approches possibles

Vous avez en pratique trois options pour envoyer un e-mail déclenché :

  • l’API Transactional Messaging (REST), pensée pour l’unitaire et la rapidité ;
  • un parcours Journey Builder avec entrée par événement API ;
  • un Triggered Send classique, désormais en retrait pour les nouveaux projets.

Pour un nouveau chantier, la décision se joue presque toujours entre les deux premières.

CritèreTransactional Messaging APIJourney Builder (événement API)
Latence viséeQuasi immédiate, file prioritaireDépend de l’injection et du parcours
Logique métierMinimale (un message, un destinataire)Riche (décisions, attentes, multicanal)
Contenu marketingÀ éviterAdapté
SuiviStatut par message via l’APITracking de parcours et de campagne

Configurer l’API Transactional Messaging pas à pas

1. Préparer les prérequis

Créez un package API avec les droits de lecture et d’écriture sur les messages transactionnels, puis une classification d’envoi de type Transactional associée à un profil d’expéditeur dédié. Utilisez de préférence un sous-domaine distinct de celui de vos campagnes (par exemple notif.votredomaine.fr) afin d’isoler la réputation.

2. Créer la définition d’envoi

La définition relie un e-mail, une classification et un profil de livraison. Elle se crée une fois, puis se réutilise pour chaque message.

POST https://{SUBDOMAIN}.rest.marketingcloudapis.com/messaging/v1/email/definitions
{
  "definitionKey": "order-confirmation-fr",
  "name": "Confirmation de commande FR",
  "classification": "Default Transactional",
  "status": "Active",
  "content": { "customerKey": "tpl-order-confirmation-fr" },
  "subscriptions": { "list": "All Subscribers", "autoAddSubscriber": true, "updateSubscriber": true }
}

3. Envoyer un message

Chaque envoi utilise une clé de message unique, ce qui garantit l’idempotence en cas de relance réseau.

POST https://{SUBDOMAIN}.rest.marketingcloudapis.com/messaging/v1/email/messages/{{messageKey}}
{
  "definitionKey": "order-confirmation-fr",
  "recipient": {
    "contactKey": "C-100482",
    "to": "client@example.com",
    "attributes": { "FirstName": "Camille", "OrderNumber": "FR-2026-88412", "Total": "129,90 €" }
  }
}

Dans l’e-mail, récupérez ces attributs avec AMPscript :

%%[ SET @prenom = AttributeValue("FirstName") ]%%
Bonjour %%=v(@prenom)=%%, votre commande %%=v(AttributeValue("OrderNumber"))=%% est confirmée.

Quand préférer Journey Builder

Choisissez un parcours dès que le message s’inscrit dans une séquence : abandon de panier suivi d’un rappel, onboarding en plusieurs étapes, ou notification qui doit basculer vers un SMS si l’e-mail n’est pas ouvert. L’entrée par événement API injecte le contact avec ses données, et les décisions s’appliquent ensuite.

POST https://{SUBDOMAIN}.rest.marketingcloudapis.com/interaction/v1/events
{
  "ContactKey": "C-100482",
  "EventDefinitionKey": "APIEvent-order-shipped",
  "Data": { "OrderNumber": "FR-2026-88412", "Carrier": "Colissimo" }
}

L’insight clé : utilisez l’API transactionnelle quand le message est la fin de l’histoire (un code, un reçu), et Journey Builder quand le message est le début d’une conversation. Mélanger les deux rôles dans un même tuyau est la première cause de retards et de dégradation de réputation.

Conformité et bonnes pratiques de contenu

Un message transactionnel ne doit pas servir de cheval de Troie promotionnel. Quelques lignes de recommandation produit en pied de mail peuvent suffire à le requalifier en message commercial, avec obligation de consentement et de lien de désinscription. En cas de doute, validez avec votre DPO et appuyez-vous sur les lignes directrices de la CNIL.

Surveiller et fiabiliser

Interrogez le statut des messages via l’API, stockez la clé de message dans votre système source et prévoyez une logique de reprise avec backoff exponentiel en cas d’erreur 429 ou 5xx. Créez une alerte si le taux d’échec dépasse un seuil défini.

Checklist de mise en production

Avant d’ouvrir le trafic réel, parcourez ces points avec votre équipe technique. Vérifiez d’abord que le domaine d’envoi est authentifié (SPF, DKIM, DMARC) et que la classification transactionnelle est bien rattachée à la définition. Testez ensuite les cas limites : adresse invalide, attribut manquant, caractères accentués dans le prénom, montant avec symbole monétaire. Simulez enfin un pic de charge, par exemple le lancement d’une promotion, pour confirmer que les messages critiques restent livrés en quelques secondes pendant qu’une campagne tourne en parallèle.

Documentez enfin les responsabilités : qui possède les gabarits, qui reçoit les alertes d’échec, et qui valide toute modification de contenu. Cette gouvernance légère évite que le transactionnel dérive peu à peu vers le promotionnel.

À retenir

Séparez les flux. Classification, profil d’expéditeur et sous-domaine dédiés pour le transactionnel.

Un message, un rôle. L’API pour l’unitaire et l’urgent, Journey Builder pour les séquences et le multicanal.

Idempotence obligatoire. Une clé de message unique évite les doublons lors des relances.

Contenu sobre. Pas de promotion dans un message transactionnel, sous peine de requalification.

Besoin d’un audit ? L’équipe CGC-Agency peut revoir votre architecture d’envoi : contactez-nous.

A voir: