L’intégration Microsoft Dynamics 365 permet d’intégrer des données de contacts et clients potentiels provenant de ce système dans des projets Dialog Insight. Son but est de récupérer vos contacts ou prospects dans votre plateforme Dynamics pour être utilisé dans la création de campagnes, la segmentation, la personnalisation et la multitude de fonctionnalités offertes de la plateforme Dialog Insight. L’ajout des données en temps réel dans le projet DI se fait lorsqu’un contact est ajouté ou modifié dans le système tiers. Un premier import est nécessaire pour récupérer l’état initial des données contacts ou prospects de Microsoft Dynamics 365 dans un projet unique dédié à cette intégration. Notez qu’aucune donnée n’est envoyée dans la solution Microsoft Dynamics.
Préalables
- Créer un compte Portal Azure
- Utiliser un projet avec une clé unique de type no. de client. Il est possible de choisir un autre type de clé unique (courriel ou autre), mais il sera plus complexe de gérer les doublons dans votre projet puisque la clé unique utilisée des contacts récupérés de Dynamics 365 est un numéro de client (de type varchar 36).
- Utiliser un projet dédié à Microsoft Dynamics pour éviter les conflits avec d'autres intégrations ou sources. Idéalement, utiliser un projet pour récupérer les contacts et un autre pour les prospects.
Étape 1 : Configurer un Service Bus Azure
Ce système sert à récupérer les évènements dans une file d’attente pour être récupérés un à la fois par le système Dialog Insight, si vous voulez récupérer les contacts ET les prospects (leads). Vous devez configurer un Service Bus pour les deux.
Note : Il est fortement conseillé, qu’un membre de votre équipe TI s’occupe du Service Bus d’Azure. Cette configuration demande un certain niveau de compréhension technique. Vous pouvez aussi nous demander de l’aide pour vous accompagner dans ce processus.
1.1 Sur Portal Azure, dirigez-vous vers la création de Service Bus. Il est possible de trouver l’emplacement en recherchant le mot « bus » dans la barre de recherche.
1.2 Si vous ne disposez pas d’un Service Bus namespace, il faut en créer un. Si vous en avez déjà un, sélectionnez-le et passez à l’étape suivante.
Dans la page affichée, cliquez sur Create service bus namespace ou + Create :
Configurez le nom d’espace (namespace) du Service Bus :
1.3 Dirigez-vous dans la page de la ressource :
1.4 Créez une nouvelle queue :
- Saisissez un nom. Le nom associé à l’objet qui représente l’échange de données, ex. Contact.
- Entrez un maximum delivery count qui représente le nombre de fois qu’il essayera d’envoyer le même message sans succès avant d’abandonner.
1.5 Une fois la nouvelle queue créée, créez une politique d’accès avec les droits Send pour le plugin Dynamics :
- Ajoutez un nom à la politique.
- Cochez la case Send.
- Cliquez sur Create.
1.6 Créez une politique d’accès avec les droits Listen pour la plateforme Dialog Insight. Dirigez-vous dans la page de la nouvelle queue. Sélectionnez dans le menu de gauche Shared access policies et cliquez sur le bouton + Add pour ajouter une nouvelle politique d’accès :
- Ajoutez un nom à la politique.
- Cochez la case Listen.
- Cliquez sur Create.
1.7 Prenez en note le champ Primary Connection String pour les deux politiques d’accès (ou une seule si vous ne synchronisez pas les leads) que vous venez de créer. Ce champ sera utilisé dans le reste du processus.
Étape 2 : Configurer le plugin Dialog Insight
Cette composante de l’intégration capture les modifications et les ajouts de contacts et clients potentiels en temps réel et les envois dans l’instance d’Azure Service Bus d’où notre service les récupère pour les intégrer dans la plateforme.
Avant de commencer, assurez-vous d'avoir accès au compte Microsoft Dynamics 365 dans l’outil Plugin Registration Tool.
Note : Il est fortement conseillé qu’un membre de votre équipe TI s’occupe de cette configuration.
2.1 Suivez la documentation pour télécharger et installer le plugin Registration Tool.
2.2 Quand l’installation est terminée, dirigez-vous dans le dossier Tools/PluginRegistration.
2.3 Ouvrez l’application PluginRegistration.
2.4 Cliquez sur + CREATE NEW CONNECTION et entrez vos informations de connexion :
Si vous utilisez une connexion SSO, laissez le champ username et password, puis cliquez sur Login.
2.5 Enregistrez le Endpoint du Service Bus Azure.
Cliquez sur l’onglet Register et choisissez l’option Register New Service Endpoint :
Saisissez la Connection string récupérée à l’étape 1.7 pour la politique d’accès Send et cliquez sur le bouton Next :
Enregistrez un endpoint pour les contacts et un autre pour les leads :
Assurez-vous d’avoir le nom de la queue du Service Bus qui correspond à ce que vous voulez synchroniser (Contacts ou Leads).
2.7 Connectez-vous à Dynamics 365 et rendez-vous à :
[organizationUri]/api/data/v9.0/serviceendpoints?$select=name,description,serviceendpointid
Vous devriez avoir une réponse qui ressemble à ceci :
Il faut extraire du JSON le serviceendpointid pour les contacts et pour les leads selon le cas.
2.8 Enregistrez un New Assembly :
Vous n'avez qu'à réaliser l'étape 2.8 une seule fois, même si vous synchronisez les deux sources (contacts et leads).
Téléchargez le fichier DialogInsight.SynchronizationPlugin.dll disponible en pièce jointe à la fin de cet article.
Téléversez ce fichier en cliquant sur Load Assembly :
2.9 Enregistez les steps pour les données à synchroniser.
Sélectionnez le plugin dans la liste :
Entrez les steps suivants pour les Contacts :
Step 1 : Create contact
Step 2 : Update contact
Step 3 : Delete contact
Voici un exemple avec Create contact :
Dans la section Unsecure Configuration, copiez le serviceendpointid correspondant à Contacts ou Leads selon le cas.
Si vous synchronisez également les leads, créez les steps suivantes :
Step 1 : Create lead
Step 2 : Update lead
Step 3 : Delete lead
Pour le Update contact et le Update lead, faites un clic droit et sélectionnez Register New Image. Ajoutez « Postimage » dans les champs Name et Entry Alias : 
Cliquez sur les 3 points de paramètres et choisissez tous les attributs sauf traversedpath.
Pour le Delete contact ET pour le Delete lead, créez une PreImage :
Étape 3 : Connecter l'intégration dans Dialog Insight
Cette composante de l’intégration permet de définir dans quelle instance d’Azure Service Bus récupérer les données et de faire la liaison des champs entre Microsoft Dynamics 365 et DI.
3.1 Rendez-vous dans la liste des intégrations (Projet → Gestion des données → Intégrations) et cliquez sur le + au bout de la ligne de l'intégration Dynamics 365, puis sur Créer une connexion :
3.2 Entrez la chaîne de connexion Listen de l'instance Azure Service Bus : 
3.3 Ajoutez une source de données pour les Contacts et les Leads selon le cas:
Si vous utilisez un projet avec une structure multi-projets (voir les préalables), assurez-vous d'être dans le bon projet enfant lorsque vous choisissez la source.
3.4 Configurez l'assignation des champs :
Pour chaque champ, indiquez la source dans Dynamics 365 et la destination dans DI :
S'il s'agit de la clé unique du projet DI, cochez Clé primaire.
3.5 Réalisez votre premier import manuel. Exportez la table Contacts ou Leads, puis importez-la dans le projet DI correspondant. Vous pourriez aussi attendre un changement à la table dans Dynamics 365, ce qui déclenchera une synchronisation des données vers DI. Lorsque les données sont synchronisées, le statut de la source changera à en « En ligne ». La synchronisation se fera alors en temps réel. 