L'intégration Salesforce permet de de synchroniser vos données (contacts, leads et autres objets) entre Salesforce et Dialog Insight. La synchronisation fonctionne dans les 2 directions (sauf pour les abonnements qui peuvent seulement être synchronisés de Dialog Insight vers Salesforce). Certaines restrictions s'appliquent pour la synchronisation de contacts créés dans un projet Dialog Insight (voir le diagramme dans la section Préalables).
Préalables
Structure des projets Dialog Insight et séparation des données |
| Avant de configurer l’intégration Salesforce, déterminez si vous devez créer des projets dédiés pour Salesforce. Cela dépend surtout de votre besoin de séparer ou non les contacts provenant de cette source de données. Si vous n’êtes pas certain de la meilleure approche selon votre contexte, notre équipe peut vous guider. De façon générale, il est déconseillé d’utiliser plusieurs intégrations dans un même projet, car cela peut entraîner des conflits de données ou de mappage, ainsi que des comportements imprévisibles lors de la synchronisation. Dans une structure CDP, si vous souhaitez distinguer vos différentes sources d’acquisition, il est recommandé de créer des projets sources dédiés pour l’intégration Salesforce. Ces projets serviront de source indépendante dont les données pourront ensuite être centralisées dans votre projet unifié. Dans le diagramme plus bas, vous avez un exemple des types de projets et des déclencheurs supportés. Vous pourriez soit créer un projet de type A ou B (ou les deux) selon vos besoins. Si vous faites de l'acquisition de contacts (création de contacts) dans Dialog Insight, vous devez faire un projet de type B pour synchroniser ces nouveaux contacts vers Salesforce (ce qui crée ces contacts dans Salesforce également). Ensuite, vous pouvez synchroniser ces contacts de Salesforce vers un projet de type A qui sera utilisé pour vos communications.  **Les abonnements sont synchronisés seulement de Dialog Insight vers Salesforce.** |
Clé unique et champs de projet Chaque projet doit avoir une clé unique (une valeur unique qui permet d'identifier chaque contact et de s'assurer qu'il n'y a pas de doublon). Consultez le diagramme pour savoir quelle clé unique est recommandée selon le type de projet. Assurez-vous d'avoir les champs nécessaires dans chacun de vos projets selon les données que vous voulez synchroniser. Le format des champs doit être compatible avec les champs Salesforce. |
Étape 1 : Configurer la connexion externe
Rendez-vous dans Projet → Gestion de données → Connexions externes et cliquez sur Liste des connexions externes (sous Connexions externes). Ensuite, cliquez sur Créer une nouvelle connexion tierce : 
Sélectionnez Salesforce comme source, donnez un nom à connexion et cliquez sur Voir autorisations service tiers :
Cliquez sur Créer une autorisation :
Donnez un nom à l'autorisation et cliquez sur Autoriser l'accès. Lorsque c'est approuvé, cliquez sur Continuer :
Pour terminer, sélectionnez l'autorisation dans la liste et cliquez sur Sauvegarder.
Étape 2 : Installer le plug-in
L'étape 2 n'est pas nécessaire pour synchroniser des données de Dialog Insight vers Salesforce.
| Le plugin est nécessaire pour synchroniser de Salesforce vers Dialog Insight. Si vous synchronisez seulement dans l'autre direction (de Dialog Insight vers Salesforce), ce n'est pas nécessaire de l'installer. Vous pouvez passer à l'étape suivante. |
Rendez-vous dans l'édition de la connexion tierce que vous venez de créer en cliquant sur Éditer :
Cliquez sur le lien pour installer le plug-in :
Vous devrez vous connecter à votre compte.
Si vous avez une ancienne version du plug-in Salesforce, vous devriez avoir une notification qui vous demande de le désinstaller. Il vous faudra par la suite reconfigurer vos Destination Projects et transferts d'objets.
Lorsqu'on vous demande « Que faire si les noms de composants sont en conflit avec ceux de ce package? », il est recommandé de choisir l’option Ne pas installer.
Pour le choix du groupe d'utilisateurs, nous recommandons de choisir Installer pour tous les utilisateurs :
Lorsque vous avez fait vos choix, cliquez sur Install.
Ensuite, approuvez le ou les domaines de Dialog Insight que vous utilisez et cliquez sur Continue :
Une confirmation s'affichera une fois l’installation terminée (ça peut prendre quelques minutes) :
Étape 3 : Ajouter un Destination Project
Pour indiquer à Salesforce quel projet utiliser pour synchroniser vos données, vous devez ajouter un Destination Project.
Dans Salesforce, rendez-vous dans DI Destination Projects, puis cliquez sur New :
Vous devez ensuite entrer les clés demandées et cliquer sur Authorize.
Ces clés sont disponibles dans la page Édition connexion tierce : 
Si vous avez plusieurs projets, ajoutez chacun de ces projets comme Destination Project.
Étape 4 : Synchroniser les données
Pour la suite, vous verrez comment configurer la synchronisation pour chaque objet Salesforce (Contacts, Leads ou autre objet Salesforce compatible avec votre projet) dont vous voulez transférer des données. Vous pouvez synchroniser n'importe quel type d'objet natif ou personnalisé de Salesforce vers une table relationnelle de votre projet Dialog Insight à condition que les champs de cette table soient compatibles avec le format des champs de l'objet Salesforce synchronisé. Pour connaître la structure des objets de Salesforce disponibles dans votre compte, consultez l'interface Object Manager. Vous devez configurer un transfert pour chaque objet et pour chaque projet concerné.
Pour comprendre les déclencheurs supportés, voir le diagramme au début de cet article dans la section Préalables. La procédure qui suit doit être faite pour chaque objet à synchroniser (et dans chaque projet concerné si vous en utilisez plus d'un). Pour mettre en place la synchronisation d'un objet, réalisez les configurations suivantes:
Remplissez ensuite les informations demandées, cliquez sur Save et ensuite sur le + sous Action :
Pour le DI Object Name, vous devez entrer le code de la table relationnelle. Vous pouvez trouver le code dans la section Données relationnelles (sous Configuration). S'il s'agit de la table des contacts de votre projet, le code à inscrire Contact avec une majuscule.Puis, ajoutez les champs de l'objet de Salesforce que vous voulez utiliser pour la synchronisation et confirmez votre sélection en cliquant sur Save :
Pensez à inclure le champ qui correspond à la clé primaire de votre projet Dialog Insight ou de la table relationnelle concernée.
Ensuite, choisissez le type de données selon le cas :
Pour les objets Salesforce (standard ou personnalisé), sélectionnez une de vos tables relationnelles dans la liste.Cliquez sur Abonnements:
Ajoutez des abonnements parmi ceux dans la liste :
Cliquez sur Ajouter une assignation :
Commencez par assigner votre clé primaire (selon la structure de votre projet). Écrivez manuellement le nom du champ (comme à gauche) en vous référant au nom dans votre compte Salesforce (comme à droite) :
Lorsque vous avez terminé l'Assignation des champs, cliquez sur Activer :
Retournez ensuite dans les Connexions externes et sélectionnez l'option Créer une intégration de données :
Ensuite, sélectionnez la connexion tierce à utiliser, puis, cochez les opérations (déclencheurs) que vous voulez appliquer :
Cliquez sur Activer quand vous êtes prêt à synchroniser vos données.Étape 5 : Premier import manuel avec fichier CSV
Après avoir activé la synchronisation, vos tables ne contiennent pas encore de données. Vous pouvez faire un premier import des données vers la table relationnelle Dialog Insight ou vers l'objet Salesforce selon le cas.
Quelques ressources utiles :