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 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 TargetType de comptes pris en charge : Sélectionner : Comptes dans cet annuaire d’organisation uniquement
URI de redirection : saisir : Web https://target.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 Target,
du secret client du Connecteur Target.
🗉 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 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 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. 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.