Préambule
Comme évoqué dans l'article 🔦 Envoyer des comptes/contacts dans mon CRM, l'outil Predict a la possibilité de se connecter directement avec votre CRM Microsoft Dynamics 365 afin d'envoyer 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. Inscription d’une application dans l’active directory d'Azure
- Accédez à l'active directory depuis votre portail Azure.
- Sur la page d'accueil, récupérez la valeur du champ Domaine principal.
🗉 Exemple : Azure Tenant Domain = demosparklane.onmicrosoft.com
- Accédez au menu Inscriptions d'applications et déclarez une nouvelle application
-
Renseignez le Nom, Type de comptes ainsi que l'URL de redirection
▶️
Nom : Choisir une valeur explicite, par exemple : Connecteur SparklaneType de comptes pris en charge : Sélectionner : Comptes dans cet annuaire d’organisation uniquement
URI de redirection : saisir : Web https://predict.sparklane.fr/oauth-redirect.html
-
Depuis la vue d’ensemble de l’application Connecteur Sparklane, récupérez l’ID d’application (client)
🗉 exemple Id d’application (client) = 35axxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
2. Création d'un secret pour l'application
-
Accédez au menu Certificats & secrets depuis le menu de gauche et créez un secret client pour le connecteur
▶️ Utilisez une description qui vous permet d'identifier l’usage auquel est destinée cette clé.
La date d’expiration est choisie en fonction de vos pratique de sécurité. En fonction de la valeur choisie, il sera nécessaire de la renouveler avant son expiration.
⚠️ La valeur de la clé n’est visible qu’au moment de sa création.
🗉 Secret client = tWf***************************
3. Autorisation de l’accès à l’API Dynamics pour l’application
-
Accédez au menu API autorisées depuis le menu de gauche et ajoutez une autorisation pour Dynamics CRM
⚠️ Les deux autorisations suivantes sont nécessaires :
Dynamics CRM user_impersonation
Microsoft Graph User.Read
-
A ce stade la configuration dans Azure est terminée, vous devez disposer :
du nom de de domaine Azure,
de l’URL de votre instance Dynamics,
de l’Id d’application Connecteur Sparklane,
du secret client du Connecteur Sparklane.
🗉 Exemples :
Azure Tenant Domain = demosparklane.onmicrosoft.com
URL Ms Dynamics = https://demo-sparklane.crm12.dynamics.com/
Id d’application (client) = 35axxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Secret client = tWf***************************
4. Configuration du connecteur dans Predict
-
Connectez-vous avec un utilisateur disposant d'un profil Manager
▶️ Predict : https://predict.sparklane.fr
- Accédez depuis le menu à l'espace paramètres onglet Intégrations et créez une nouvelle intégration Microsoft Dynamics 365
-
Saisissez les informations obtenues à l'étape précédente.
▶️ Actif = coché
Libellé = Ce libellé permet à l’utilisateur d’identifier le connecteur
Azure Tenant Domain = exemple : demosparklane.onmicrosoft.com
Adresse de Dynamics 365 = exemple : https://demo-sparklane.crm12.dynamics.com/
Identifient client de l'application = exemple : 35axxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Secret client de l’application = exemple : tWf*************************** -
Testez l'authentification en cliquant sur "Accorder une autorisation d'accès"
⚠️ Si votre navigateur est connecté à une autre instance Office 365, veillez à vous déconnecter au préalable.
▶️ 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 Dynamics.
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.
5. 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
6. Lier votre connecteur à une étape
Ajouter une intégration à une catégorie permet d'envoyer automatiquement dans comptes dans votre CRM.
▶️ Découvrez notre article dédié : 💡 Comment créer des parcours de comptes
7. Test de création d'un prospect depuis Predict
Vous pouvez tester la création d'un prospect depuis une liste existante ou créer une liste spécifique depuis la recherche.
▶️ Découvrez notre article dédié : 💡 Recherchez une société
-
Envoi des informations du compte (consommation de crédits Etablissement)
- Depuis la liste de comptes, cliquez sur le bouton "Changer d'étape" à droite du compte qui vous intéresse puis sur "Envoyer au CRM" :
-
- Depuis la page de compte ouverte dans une liste, cliquez sur le bouton "Changer d'étape" en haut à droite de l'interface puis sur "Envoyer au CRM" :
-
Envoi des informations du compte + contact :
- Depuis l'onglet "Contacts" d'une page de compte ouverte dans une liste, en cliquant sur le petit nuage :
-
- Depuis la page Contacts, en cliquant sur les 3 petits points puis "Envoyer vers le CRM". Pour information, en envoyant depuis cette page "Contacts" les données de comptes/contacts seront envoyées hors contexte de liste.
-
- Depuis l'extension Sparklane, en cliquant sur le petit nuage (en haut à droite)
- Depuis l'extension Sparklane, en cliquant sur le petit nuage (en haut à droite)
▶️ 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 Sparklane ou du support Sparklane.