Gérer les prospects avec Salesforce Sales Cloud
Salesforce est l’une des principales plateformes de gestion de la relation client (CRM) basées sur le cloud, conçue pour aider les entreprises à gérer l’ensemble de leur processus de vente, notamment la génération de prospects, le suivi des opportunités et la gestion des comptes.
Cette page montre comment utiliser les webhooks de Braze pour créer et mettre à jour des prospects dans Salesforce Sales Cloud via une intégration soumise par la communauté.
Il s’agit d’une intégration proposée par la communauté qui n’est pas directement prise en charge par Braze. Seuls les modèles de webhook officiels fournis par Braze sont pris en charge par Braze.
Fonctionnement
L’intégration de Braze avec Salesforce Sales Cloud utilise les webhooks de Braze pour créer et mettre à jour des prospects dans Salesforce Sales Cloud via l’endpoint Salesforce sobjects/Lead.
Braze propose actuellement deux intégrations avec Salesforce Sales Cloud pour les cas d’utilisation suivants :
Cette intégration sert uniquement à mettre à jour Salesforce depuis Braze dans le cadre de vos efforts d’acquisition et de maturation de prospects. Pour synchroniser les données de Salesforce vers Braze, consultez le modèle de données B2B ou contactez l’un de nos partenaires technologiques.
Conditions préalables
Avant de pouvoir procéder à cette intégration, l’assistance Salesforce doit vous accorder la possibilité de créer des applications connectées. Vous pouvez en faire la demande en soumettant une demande d’assistance Salesforce.
Une fois que l’assistance Salesforce vous a accordé la possibilité de créer une application connectée dans Salesforce Sales Cloud, suivez les étapes de la documentation Salesforce : Configure a Connected App for the OAuth 2.0 Client Credentials Flow.
Lorsque vous configurez les paramètres OAuth nécessaires pour l’application connectée, conservez tous les paramètres OAuth avec leurs valeurs et sélections par défaut, à l’exception des éléments suivants :
- Sélectionnez Enable for device flow. Vous pouvez laisser le champ Callback URL vide, car il sera remplacé par défaut par une marque substitutive.
- Pour les OAuth Scopes sélectionnées, ajoutez Manage user data via APIs (api).
- Sélectionnez Enable Client Credentials Flow.
Créer un prospect dans Salesforce Sales Cloud
En tant que plateforme d’engagement client, Braze peut générer de nouveaux prospects en fonction des flux utilisateurs, par exemple lorsqu’un formulaire est rempli sur une page d’accueil. Lorsque cela se produit, vous pouvez utiliser un webhook Braze Salesforce Sales Cloud pour créer un prospect correspondant dans Salesforce.
Étape 1 : Récupérez vos client_id et client_secret
- Dans Salesforce, accédez à Platform Tools > Apps > App Manager.
- Recherchez votre application Braze nouvellement créée et sélectionnez View.
- Sous Consumer Key and Secret, sélectionnez Manage Consumer Details.
- Sur la page qui s’affiche, notez votre Consumer Key et votre Consumer Secret. La Consumer Key correspond à votre
client_id, et le Consumer Secret correspond à votreclient_secret.
Étape 2 : Configurez votre modèle de webhook
Utilisez des modèles pour réutiliser rapidement ce webhook sur la plateforme Braze.
- Dans Braze, accédez à Modèles, sélectionnez Modèles de webhook, puis sélectionnez + Créer un modèle de webhook.
- Donnez un nom au modèle, par exemple « Salesforce Sales Cloud > Créer un prospect ».
- Dans l’onglet Rédiger, saisissez les informations suivantes :
Rédiger le webhook
| Champ | Détails |
|---|---|
| URL du webhook | https://[insert_instance_name].my.salesforce.com/services/data/v60.0/sobjects/Lead/ |
| Méthode HTTP | POST |
| Corps de la requête | Paires clé/valeur JSON |
Valeurs clés des propriétés du corps
Sélectionnez + Add New Body Property pour chacune des paires clé/valeur que vous souhaitez mapper de Braze vers Salesforce. Vous pouvez mapper n’importe quel champ ; le tableau suivant n’est qu’un exemple.
| Clé | Valeur |
|---|---|
| firstName | {{${first_name}}} |
| lastName | {{${last_name}}} |
{{${email_address}}} |
|
| company | {{custom_attribute.${company}}} |
En-têtes de requête
Sélectionnez + Add New Header pour chacun des en-têtes de requête suivants.
| Clé | Valeur |
|---|---|
| Authorization | {% connected_content https://[insert_instance_name].my.salesforce.com/services/oauth2/token :method post :body client_id=[insert_client_id]&client_secret=[insert_client_secret]&grant_type=client_credentials :save result %}Bearer {{result.access_token}} |
| Content-Type | application/json |
- Sélectionnez Enregistrer le modèle.

Mettre à jour un prospect dans Salesforce Sales Cloud
Pour configurer un webhook Braze Salesforce Sales Cloud qui met à jour les prospects dans Salesforce, vous avez besoin d’un identifiant commun entre Salesforce Sales Cloud et Braze. L’exemple ci-dessous utilise le lead_id de Salesforce comme external_id dans Braze, mais vous pouvez également utiliser un user_alias. Pour plus de détails, consultez la section Données B2B.
Cet exemple montre spécifiquement comment mettre à jour le stade d’un prospect en « MQL » (Marketing Qualified Lead) après qu’il a franchi un certain seuil de score. Il s’agit d’un élément central de notre cas d’utilisation de workflow de scoring des prospects B2B.
Étape 1 : Récupérez vos client_id et client_secret
- Dans Salesforce, accédez à Platform Tools > Apps > App Manager.
- Recherchez votre application Braze nouvellement créée et sélectionnez View.
- Sous Consumer Key and Secret, sélectionnez Manage Consumer Details.
- Sur la page qui s’affiche, notez votre Consumer Key et votre Consumer Secret.
- La Consumer Key correspond à votre
client_id, et le Consumer Secret correspond à votreclient_secret.
- La Consumer Key correspond à votre
Étape 2 : Configurez votre modèle de webhook
- Dans Braze, accédez à Modèles, sélectionnez Modèles de webhook, puis sélectionnez + Créer un modèle de webhook.
- Donnez un nom au modèle, par exemple « Salesforce Sales Cloud > Mettre à jour le prospect en MQL ».
- Dans l’onglet Rédiger, saisissez les informations suivantes :
Rédiger le webhook
| Champ | Détails |
|---|---|
| URL du webhook | https://[insert_instance_name].my.salesforce.com/services/data/v60.0/sobjects/Lead/{{${user_id}}} |
| Méthode HTTP | PATCH |
| Corps de la requête | Paires clé/valeur JSON |
Valeurs clés des propriétés du corps
Sélectionnez + Add New Body Property pour la paire clé/valeur suivante. Notez que Lead_Stage__c est un exemple de nom. Le champ personnalisé que vous utilisez pour suivre les MQL dans Salesforce peut avoir un nom différent ; assurez-vous qu’ils correspondent.
| Clé | Valeur |
|---|---|
Lead_Stage__c |
MQL |
En-têtes de requête
Sélectionnez + Add New Header pour chacun des en-têtes de requête suivants.
| Clé | Valeur |
|---|---|
| Authorization | {% connected_content https://[insert_instance_name].my.salesforce.com/services/oauth2/token :method post :body client_id=[insert_client_id]&client_secret=[insert_client_secret]&grant_type=client_credentials :save result %}Bearer {{result.access_token}} |
| Content-Type | application/json |
- Sélectionnez Enregistrer le modèle.

Utiliser ces webhooks dans un flux de travail opérationnel
Vous pouvez rapidement ajouter vos modèles à vos flux de travail opérationnels dans Braze, par exemple :
- Dans le cadre d’une campagne pour les nouveaux prospects qui crée un prospect dans Salesforce.
- Dans le cadre d’un Canvas de scoring des prospects qui met à jour les utilisateurs ayant franchi votre seuil MQL en « MQL » et qui met à jour Salesforce Sales Cloud avec les mêmes informations.
Campagne pour les nouveaux prospects
Pour créer un prospect dans Salesforce lorsqu’un utilisateur fournit son adresse e-mail, vous pouvez créer une campagne qui utilise le modèle de webhook « Update Lead » et se déclenche lorsqu’un utilisateur ajoute son adresse e-mail (par exemple, lorsqu’il remplit un formulaire web).

Canvas de scoring des prospects pour le franchissement du seuil MQL (Marketing Qualified Lead)
Ce webhook est abordé dans le cas d’utilisation du lead scoring, mais vous pouvez également vérifier les MQL et mettre directement à jour Salesforce dans le Canvas de scoring des prospects (au lieu de créer une campagne webhook distincte) :
Ajoutez une étape supplémentaire à votre mise à jour utilisateur pour vérifier si un utilisateur a franchi le seuil MQL que vous avez défini. Si c’est le cas, mettez à jour le statut de l’utilisateur en « MQL », puis mettez à jour Salesforce avec le même statut « MQL » à l’aide de ce modèle de webhook. Salesforce s’occupe du reste en acheminant ce prospect vers les équipes commerciales appropriées selon vos règles de routage des prospects.
Ajouter une étape Canvas pour vérifier les utilisateurs ayant franchi le seuil MQL
- Ajoutez une étape de parcours d’audience avec deux groupes : « MQL Threshold » et « Tous les autres ».
- Dans le groupe « MQL Threshold », recherchez les utilisateurs dont le statut n’est pas « MQL » (par exemple,
lead_stageest égal à « Lead »), mais dont le score de prospect dépasse le seuil que vous avez défini (par exemple,lead_scoresupérieur à 50). Si c’est le cas, ils passent à l’étape suivante ; sinon, ils sortent du flux.

- Ajoutez une étape de Mise à jour utilisateur qui met à jour la valeur de l’attribut
lead_stagede l’utilisateur en « MQL ».

- Ajoutez une étape webhook qui met à jour Salesforce avec le nouveau stade MQL.

Votre flux Canvas mettra désormais à jour les utilisateurs ayant franchi votre seuil MQL !

Résolution des problèmes
Ces flux de travail offrent des capacités de débogage limitées dans Salesforce. Nous vous recommandons donc de consulter le Journal d’activité des messages de Braze pour comprendre pourquoi un webhook a échoué et si des erreurs se sont produites.
Par exemple, une erreur causée par une URL invalide utilisée pour la récupération du jeton OAuth s’affichera sous la forme https://[insert_instance_name].my.salesforce.com/services/oauth2/token is not a valid URL.
