API

Intégrateur Marketing Cloud Salesforce API : faire entrer le bon contact dans le bon journey

Dawap relie CRM, e-commerce, CMP ou datawarehouse à Salesforce Marketing Cloud Engagement sans réduire le projet à un import de contacts. Chaque activation conserve sa Business Unit, son ContactKey, son consentement, la Data Extension concernée, l’événement déclenché et le retour qui permet au marketing, au support et à l’IT d’expliquer ce qui s’est réellement passé.

  • Identité contact réconciliée
  • Journey déclenché sous conditions
  • Preuve d’envoi et reprise attribuées
APIs, données et infrastructures que nos projets savent connecter
Conception, intégration et maintenance
01 Contrat versionné
02 Sécurité explicite
03 Reprise testée
04 Supervision avec alertes

Réponse immédiate

Un intégrateur Marketing Cloud Salesforce API sécurise la décision qui autorise chaque activation.

Dawap construit le middleware entre vos sources et Marketing Cloud Engagement : authentification par Installed Package, sélection de la Business Unit, mapping ContactKey, écritures contrôlées dans les Data Extensions, événements Journey Builder, messages transactionnels et retours Event Notification Service. La prestation inclut les règles de refus, l’observabilité et la reprise ; elle ne s’arrête pas à une réponse HTTP favorable.

  • Borner le premier lot à une source, une Business Unit, une Data Extension, un événement et un journey.
  • Résoudre identité, consentement et finalité avant toute écriture ou activation marketing.
  • Conserver requestId, eventInstanceId ou messageKey selon le parcours sans les confondre.
  • Réconcilier traitement, disposition et système source avant de clore l’exécution.

Journey control room · scénario illustratif

Une activation ne mérite le feu vert que si sa chronologie reste prouvable.

Ce contact, ces identifiants et ces résultats sont fictifs. L’interface montre le dossier attendu avant d’autoriser un journey sensible : périmètre, identité, consentement, schéma, événement et retour.

Release d’activationJRN-CART-FR · v12
Business Unit
France Retail · MID …482
Package
Activation Runtime
Scope
journeys_write · data_extensions_write
Contrat vérifié
01
Vérité source

Le CRM porte l’intention

Contact C-9081Panier abandonné · EUR
Éligible
CRM ID
CRM-9081
ContactKey
CK-FR-9081
Consentement
Email · actif
Finalité
Relance panier · v3
Signal reçucart.abandoned · EVT-7742
02
Middleware Dawap

Cinq portes avant effet

  1. ✓
    Identité réconciliéeCRM-9081 ↔ CK-FR-9081
  2. ✓
    Finalité autoriséeEmail · relance panier · v3
  3. ✓
    Périmètre confirméMID …482 · package runtime
  4. ✓
    Schéma compatibleDE_CART_FR · contract v7
  5. ✓
    Réentrée permiseAucune activation ouverte
Verdict middlewareGO · événement autorisédecision: 7F4A · map:v7
03
Marketing Cloud

Le verdict garde ses preuves

Data ExtensionDE_CART_FR
Row upserted
requestId
REQ-61…9C
résultat
1 traité · 0 rejet
POST/interaction/v1/events201
EventDefinitionKeyCART_ABANDONED_V12eventInstanceId · EVI-43…A8
Retour réconciliéENS · EmailSentmessageKey MK-7742 · effet appliqué une fois
  1. 1
    SourceSignal qualifié
  2. 2
    DécisionEffet autorisé
  3. 3
    ActivationEvent accepté
  4. 4
    PreuveDisposition rapprochée

Premier lot recommandé

Une Business Unit, un contact difficile, un journey et le retour qui tranche.

Apportez le parcours qui déclenche aujourd’hui le plus d’investigations. Le cadrage doit rendre son identité, son autorisation, son événement, son effet et sa reprise lisibles par les quatre équipes concernées.

Cadrer mon journey témoin

Quand l’activation devient inexplicable

Un événement accepté par Marketing Cloud ne prouve ni l’entrée utile dans le journey ni le message reçu.

Source CRM, Business Unit, identité, consentement, Data Extension, définition d’événement et disposition du message ont des cycles différents. Le middleware doit préserver cette chronologie avant d’automatiser le volume.

01 Identité

ContactKey et identifiant CRM désignent deux personnes logiques

Une clé recréée, recyclée ou mappée différemment peut alimenter la bonne Data Extension avec le mauvais contact. La résolution d’identité doit précéder le déclenchement.

02 Périmètre

Le package agit dans la mauvaise Business Unit

Token, scopes et MID cible doivent rester liés au flux. Un accès valide ne suffit pas à prouver que l’appel agit dans le périmètre marketing attendu.

03 Résultat

Le statut de transport masque le verdict métier

Un événement peut être accepté puis traité, mis en file ou rejeté plus tard. Un message peut aussi produire plusieurs événements de disposition ; la preuve doit être réconciliée.

Contrats d’activation SFMC

Six contrats empêchent le journey de devenir une boîte noire entre CRM et support.

Marketing Cloud expose plusieurs surfaces et identifiants. Le projet doit encore dire qui autorise l’effet, comment il est prouvé et ce qui peut être rejoué.

01 · Business Unit

Le MID cible reste attaché à l’intention

Installed Package, type d’intégration, scopes et account_id sont documentés ; chaque appel conserve le périmètre qui a réellement produit son résultat.

02 · Identité

ContactKey ne remplace pas la clé métier source

CRM ID, SubscriberKey, ContactKey et éventuelles clés de Data Extension sont rapprochés dans un registre explicite, sans fusion implicite par email.

03 · Consentement

La finalité autorisée voyage avec l’activation

Source, canal, finalité, horodatage, retrait et politique d’exclusion sont testés avant le déclenchement, puis conservés dans la décision.

04 · Data Extension

Schéma, clés et rétention forment un contrat

Customer key, colonnes, types, primary keys, source et durée utile sont versionnés ; les résultats asynchrones restent relus par requestId.

05 · Journey

EventDefinitionKey et règles de réentrée sont recettés ensemble

ContactKey, données requises, contact actif, version du journey, exclusions et réentrée déterminent si un HTTP 201 peut devenir une activation valide.

06 · Disposition

L’envoi et son retour sont réconciliés

messageKey, send definition et événements ENS sont reliés à l’intention source ; les livraisons at least once sont dédupliquées avant tout changement aval.

Méthode d’activation

Faire signer le contrat avant que le journey ne puisse agir.

Dawap part d’un contact et d’un effet marketing qui posent déjà problème. Marketing, CRM, conformité et support nomment la source, l’identité, la finalité, la Business Unit, le schéma, l’événement, les règles de réentrée et la preuve de clôture. Le flux ne s’élargit qu’après avoir résisté à une identité ambiguë, un droit retiré et une livraison répétée.

01

Autoriser l’effet

Vérifier identité, consentement, finalité, périmètre et version avant toute activation.

02

Conserver la corrélation

Relier identifiant interne, requestId, eventInstanceId ou messageKey sans les rendre interchangeables.

03

Prouver le verdict

Distinguer appel accepté, traitement SFMC, disposition et mise à jour du système propriétaire.

04

Reprendre sans réenvoyer

Isoler le contact ou l’événement en écart depuis une inbox, un checkpoint et une décision connus.

Premier lot Salesforce Marketing Cloud

Faire passer un contact difficile de la source au verdict de campagne sans perdre sa chronologie.

On choisit un parcours déjà source de doublons, de non-envois ou d’investigations longues. Le lot est accepté lorsque les équipes peuvent reconstruire la clé contact, la règle de consentement, l’écriture utile, l’événement, l’état aval et la reprise depuis une même trace.

1 source 1 Business Unit 1 Data Extension 1 journey 5 contre-tests

Sorties attendues

01

Carte source–identité–consentement–Business Unit–Data Extension–événement–disposition avec owner pour chaque décision.

02

Inventaire des Installed Packages, types d’authentification, scopes, MIDs, endpoints REST ou SOAP conservés et dépendances historiques.

03

Contrat du contact témoin avec schéma, clés, finalité, réentrée, exclusion, eventDefinitionKey et preuve aval attendue.

04

Cinq contre-tests : contact inactif, scope retiré, mauvaise Business Unit, consentement expiré et événement reçu deux fois.

05

Journal expurgé reliant corrélation interne, requestId, eventInstanceId ou messageKey aux statuts métier normalisés.

06

Recette marketing–CRM–support, seuils d’arrêt, alertes, reprise ciblée, documentation et runbook de rotation des accès.

Recette Salesforce Marketing Cloud

Trois situations qui doivent produire une décision marketing–IT vérifiable.

Ces scénarios sont illustratifs et doivent être rejoués sur vos Business Units, vos packages et vos assets Salesforce. Ils ne constituent pas des résultats clients ni une référence Salesforce Marketing Cloud déjà livrée.

01 · Mauvais périmètre

Le token est valide, mais la Business Unit cible n’est pas celle du journey.

Scénario terrain
Un package autorisé peut obtenir un token sans prouver que le MID et les assets visés correspondent au parcours attendu. Écrire directement ferait naître un état difficile à retrouver dans une autre Business Unit.
Architecture
Registre package–MID–scope–asset, validation du token context, séparation des environnements et verrou avant écriture.
Livrable
Matrice d’accès, fixture de changement de MID, journal expurgé et règle d’arrêt explicite.
Décision
Refuser l’activation, attribuer l’écart au périmètre et ne pas chercher le contact dans toutes les Business Units.
Résultat vérifiable
Aucun effet marketing n’est produit tant que package, MID, Data Extension et journey ne forment pas un même périmètre.
02 · Événement Journey Builder

L’API retourne 201, puis le contact reste absent du parcours attendu.

Scénario terrain
POST /interaction/v1/events accepte ContactKey, EventDefinitionKey et les données requises, puis renvoie un eventInstanceId. Ce succès de transport n’établit pas à lui seul le verdict métier du journey.
Architecture
Corrélation intention–eventInstanceId, version du journey, contrôle du contact actif, règles de réentrée, statut asynchrone et preuve aval.
Livrable
Contrat d’événement, contre-tests contact inactif/clé inconnue, état normalisé et procédure d’investigation.
Décision
Conserver l’acceptation, qualifier le traitement et ne rejouer qu’après avoir exclu un blocage durable ou une entrée déjà consommée.
Résultat vérifiable
Marketing et support distinguent clairement événement accepté, contact traité et parcours réellement activé.
03 · Notification répétée

Le même événement de disposition ENS arrive plus d’une fois.

Scénario terrain
Salesforce documente une livraison ENS au moins une fois. Appliquer chaque notification comme une nouveauté peut doubler une activité CRM, une alerte ou un changement de consentement.
Architecture
Callback vérifié, inbox durable, signature si configurée, clé de déduplication, accusé rapide et traitement asynchrone.
Livrable
Fixture de notification répétée, registre d’inbox, métriques de doublon, quarantaine et commande de replay ciblée.
Décision
Accuser la livraison déjà connue sans répéter son effet, puis rapprocher sa disposition avec le messageKey ou les identifiants de job.
Résultat vérifiable
Le retour Marketing Cloud reste idempotent et le système source ne fabrique pas une seconde vérité.

Marketing Cloud, Salesforce CRM ou e-commerce ?

Le bon owner dépend du système qui décide après le signal.

Nous connectons Marketing Cloud Engagement aux événements et aux données nécessaires aux campagnes. Le CRM conserve les données commerciales ; la boutique ou l’ERP confirme les commandes et leurs changements.

01 · Marketing Cloud

Le besoin porte sur Data Extensions, journeys ou messages SFMC

Cette offre cadre Business Units, packages, identités, données d’activation, événements, dispositions et run.

02 · Salesforce CRM

La décision principale porte sur leads, comptes ou opportunités

L’intégration Salesforce CRM relie les données Sales Cloud ou Service Cloud à vos autres outils, selon les objets et interfaces disponibles.

03 · E-commerce

La commande, le panier ou le retour doit d’abord être fiabilisé

Le hub e-commerce possède la chronologie transactionnelle ; Marketing Cloud n’en reçoit que le signal utile et autorisé.

Preuves projet, portée explicite

Quatre réalisations pour juger les flux et le run sans inventer une référence Marketing Cloud.

Ces projets montrent comment Dawap relie événements, données métier, équipes et preuves opérationnelles. L’intégration SFMC doit encore être recettée sur vos packages, Business Units, contacts et journeys.

Plateforme de souscription assurance Opteven connectée aux APIs métier Intégration API Opteven : souscription assurance connectée Voir le projet
  • 03 mai 2024
  • Lecture ~25 min

Dawap a construit pour Opteven deux applications complémentaires : une souscription automobile en six étapes connectée à HubSpot, à l’ERP et à DocuSign, puis un portail pour contrôler les fichiers partenaires et transmettre les contacts qualifiés avec une trace exploitable.

Architecture suspendue représentant le cockpit commercial de 1UP Distribution Développement web 1UP Distribution : cockpit commercial et comptes B2B Voir le projet
  • 12 février 2026
  • Lecture ~31 min

Dawap a réuni dans un cockpit commercial unique le portefeuille, le CRM opérationnel, la prise de commande, les devis, commandes, livraisons, factures, avoirs, radars de comptes à sauver et analyses multi-périodes. Chaque vue respecte les rôles et relie le signal commercial à sa preuve métier.

Pipeline API Shopify et Wix transformant commandes et variantes pour Ciama Intégration API Ciama : pipeline API Shopify et Wix Voir le projet
  • 17 mars 2026
  • Étude de cas · 20 min

Ciama sélectionne quatre lecteurs spécialisés pour collecter commandes et variantes Shopify ou Wix, puis les normalise dans deux modèles communs. Le pipeline protège le compte et le canal, décide entre ajout et mise à jour, distribue les écritures et sécurise la désactivation après un snapshot complet.

Site multilingue et CMS éditorial de Corim Solutions Développement web & PageSpeed Corim Solutions : site multilingue, CMS éditorial et performance vérifiée Voir le projet
  • 07 avril 2025
  • Lecture ~30 min

Pour faire vivre ses offres GMAO et ses ressources, Corim Solutions réunit site français et anglais, CMS éditorial, métadonnées, redirections et mesures PageSpeed dans un même socle Symfony. En production, 150 URL ont ensuite été vérifiées sur mobile et desktop, avec 300 rapports Lighthouse valides.

Guides de cadrage

Approfondir Marketing Cloud API, consentement, webhooks et réconciliation.

Ces guides détaillent les appels Marketing Cloud, le consentement, les webhooks et le rapprochement des événements entre le CRM et les parcours marketing.

API Salesforce Marketing Cloud : journeys et data extensions Intégration API API Salesforce Marketing Cloud : journeys et data extensions Lire l'article
  • 4 février 2026
  • Lecture ~23 min

Salesforce Marketing Cloud relie REST API, SOAP, Data Extensions, Journey Builder, Transactional Messaging, triggered sends et Marketing Cloud Connect. La méthode cadre business units, send definitions, messageKey, send logging, quotas, throughput, retry, retour arrière, support et intégration CRM, CMP ou boutique.

API emailing et marketing automation Intégration API API emailing et marketing automation : piloter les flux Lire l'article
  • 15 mars 2025
  • Lecture ~23 min

Quand CRM, boutique et plateforme d'envoi partagent une vérité claire, l'emailing reste un flux d'architecture et non une suite de campagnes. Un consentement flou, un doublon ou un déclencheur trop rapide finit toujours par coûter du support, de la marge et une confiance nette. La base se dégrade et la reprise se tend.

Des événements webhook sécurisés traversent journal durable, déduplication, traitement et rejeu Intégration API Webhooks fiables en production Lire l'article
  • 8 août 2026
  • Lecture ~14 min

Un code HTTP réussi ne prouve ni traitement ni cohérence métier. Une architecture fiable vérifie l’origine, journalise avant acquittement, déduplique, préserve l’ordre utile, isole les échecs et permet un rejeu ciblé. Les métriques relient chaque événement reçu à son effet final et à sa preuve de reprise.

Réconciliation API : corriger les écarts entre systèmes Intégration API Réconciliation API : détecter et corriger les écarts Lire l'article
  • 27 mai 2025
  • Lecture ~32 min

La réconciliation API devient utile quand chaque écart est relié à une source de vérité, à une preuve d’exécution et à une action bornée. Elle évite les resync massifs et transforme un doute sur la donnée en décision lisible. Le dispositif conserve la fenêtre, le watermark, la clé métier et le droit de correction avant tout replay ou compensation.

Questions fréquentes

Questions fréquentes avant une intégration Salesforce Marketing Cloud API

Réponses sur Business Units, Installed Packages, Data Extensions, Journey Builder, messages transactionnels, ENS et premier lot.

01Que fait un intégrateur Marketing Cloud Salesforce API ?

Il relie vos sources à Marketing Cloud Engagement avec un contrat explicite : package, Business Unit, identité, consentement, Data Extension, journey, message, retour et reprise. Dawap développe le middleware et la couche d’exploitation adaptée à ce contrat.

02Comment sécuriser les accès Salesforce Marketing Cloud ?

L’intégration part d’un Installed Package et de son type d’authentification. Les scopes sont réduits au besoin, les secrets restent côté serveur et le MID cible est conservé. Salesforce retourne aussi les base URLs REST et SOAP propres au tenant dans la réponse de token.

03Peut-on synchroniser les Data Extensions de façon asynchrone ?

Oui. Les routes asynchrones permettent d’insérer ou mettre à jour des lignes, puis d’interroger statut et résultats avec le requestId. Le middleware conserve ce suivi et rapproche les rejets de la ligne source au lieu de valider le batch sur sa seule acceptation.

04Comment fiabiliser un événement Journey Builder ?

POST /interaction/v1/events attend notamment ContactKey et EventDefinitionKey, plus Data quand le schéma l’exige. Un succès renvoie HTTP 201 et un eventInstanceId ; un contact inactif ou une définition inconnue peut produire HTTP 400. La recette vérifie ensuite la version du journey et le verdict attendu.

05Comment éviter les doublons de messages transactionnels ?

Les envois unitaires utilisent un messageKey unique. La documentation Salesforce recommande cette clé pour dédupliquer à l’envoi et précise une unicité par Business Unit sur une fenêtre de 72 heures. La corrélation interne doit toutefois rester plus durable que cette fenêtre.

06Comment exploiter Event Notification Service en production ?

Le callback est enregistré puis vérifié avant abonnement. ENS livre les notifications au moins une fois : le récepteur doit accuser rapidement, dédupliquer, traiter en asynchrone et conserver une reprise. Salesforce documente jusqu’à trois tentatives initiales puis une livraison différée pouvant aller jusqu’à sept jours.

Marketing Cloud Engagement · activation et run

Votre prochain journey peut-il expliquer chaque activation du signal au verdict ?

Dawap peut cadrer un contact témoin puis construire le middleware, les contrôles et la reprise qui rendent Salesforce Marketing Cloud exploitable par marketing, CRM, conformité et support.

Cadrer mon journey témoin