Préambule
Comme évoqué dans l'article 🔦 Envoyer des comptes/contacts dans mon CRM, l'outil Target a la possibilité de se connecter directement avec votre CRM Salesforce afin d'envoyer des Pistes, des Comptes, des Comptes/Contacts, et/ou de récupérer les Comptes clients.
Ce tutoriel présente la marche à suivre pour mettre en place ce connecteur.
1. Création d'une application connectée dans Salesforce
- Connectez-vous à votre environnement Salesforce avec un profil Administrateur.
- Accéder au menu Configuration de Salesforce
- Depuis le menu Applications : Applications clientes externes, Paramètres, créez une Nouvelle application connectée
-
Renseignez les informations obligatoires ci-dessous dans l'application :
- Nom de l'application connectée : Un nom permettant d’identifier l'application, par exemple "Sparklane_Push_CRM"
- Nom d'API : celui-ci est renseigné automatiquement
- Activer les paramètres OAuth : Oui
-
URLs de rappel :
- https://target.sparklane.fr/oauth-redirect.html
- https://target.ellisphere.com/oauth-redirect.html
-
Domaines OAuth sélectionnés :
- Gérer les données des utilisateurs via des API (api)
- Exécuter des requêtes à tout moment (refresh_token, offline_access)
- Nécessite un secret pour le flux serveur Web : Oui
- Le reste ne devra pas être coché, notamment la case PKCE.
- Enregistrez l'application et récupérez les Détails consommateurs
- L'URL de votre environnement Salesforce, la Clé consommateur ainsi que le Secret consommateur seront nécessaires pour l'étape suivante.
2. Configuration du connecteur dans Target
-
Connectez-vous avec un utilisateur disposant d'un profil Manager
▶️ Target : http://target.sparklane.fr/
- Accédez depuis le menu à l'espace paramètres onglet Intégrations et créez une nouvelle intégration Salesforce
-
Saisissez les informations obtenues à l'étape précédente.
▶️ Actif = coché
Libellé = Ce libellé permet à l’utilisateur d’identifier le connecteur
Adresse de l'API Rest Salesforce = exemple : demosparklane.lightning.force.com
Seule la valeur précédant la partie lighning.force ou my.salesforce est à saisir
Version de l'API = laisser la valeur préremplie
Identifiant client de l'application = Clé consommateur de l'application connectée
Secret client de l’application = Secret consommateur de l'application connectée
-
Testez l'authentification en cliquant sur "Accorder une autorisation d'accès"
⚠️ Si votre navigateur est connecté à un autre environnement Salesforce, veillez à vous déconnecter au préalable ou donner cette autorisation depuis la navigation privée du navigateur.
▶️ Il n’est pas nécessaire de passer par l’espace paramétrage pour accorder l'autorisation d’accès. Celle-ci sera demandée automatiquement à l'utilisateur lors de sa première action de publication de données vers Salesforce.
La page de paramétrage du connecteur permet à tous moment de révoquer un accès accordé précédemment.
Les utilisateurs avec un profil Manager ont également la possibilité d’accorder/révoquer une autorisation d’accès utilisée par des traitements automatisés.
3. Création du connecteur d'envoi
- Cliquez sur le bouton Nouveau connecteur
- Cliquez sur le bouton Push CRM
-
Remplir les différents champs de configuration et cliquez sur Enregistrer
▶️ Actif = coché
Libellé = Ce libellé permet à l’utilisateur d’identifier le connecteur
Mode de publication = Permet à l’utilisateur de définir vers quel objet Salesforce doivent être envoyées les données (Objets disponibles : Piste, Compte, Compte+Contact)
Pour l'objet Piste = Mode de publication : Simple
Type d'objet(s) Salesforce = Lead
Pour l'objet Compte = Mode de publication : Simple
Type d'objet(s) Salesforce = Account
Pour les objets Compte+Contact = Mode de publication : Multiple
4. Test de création d'un prospect depuis Target
Dans l'onglet Contacts, déclenchez l'envoi du prospect choisi (une coordonnée doit être recherchée au préalable) en cliquant sur les petits points puis "Envoyer au CRM".
Dans la fenêtre, sélectionnez le CRM à tester (si vous en avez plusieurs) puis cliquez sur "Envoyer"
▶️ Si l'icône d'un nuage avec le symbole ✔️ apparaît, l'envoi a fonctionné.
Si une croix rouge ❌ apparaît, il y a un problème dans la configuration.
- N'hésitez pas à contrôler les données reçues dans votre CRM pour s'assurer que tous les champs sont correctement remplis.
▶️ Vous trouverez dans le fichier en téléchargement, la liste de tous nos champs disponibles. Si vous souhaitez changer les champs envoyés par défaut, n'hésitez pas à vous rapprocher de votre Chef de projet Target ou du support Target.