Ajouter manuellement un canal personnalisé
Dynamics 365 Customer Insights - Journeys prend en charge les canaux E-mail, Push et SMS en mode natif. Pour utiliser un type de canal ou un fournisseur de SMS qui n’est pas pris en charge en mode natif, vous pouvez installer un canal personnalisé. Si le canal n’est pas déjà fourni dans AppSource, vous pouvez le créer et l’installer manuellement.
Structure du canal personnalisé
Les canaux personnalisés peuvent être mis en œuvre dans le cadre d’une solution Dataverse. Les étapes et actions suivantes sont requises pour créer un canal personnalisé :
- Définir une entité de configuration étendue pour l’instance de canal
- Définir une entité de configuration étendue pour le compte de l’instance de canal (SMS uniquement)
- Définir les parties du message (composant sensible à la solution)
- Définir la localisation pour l’interface d’administration (facultatif)
- Définir l’interface de l’éditeur de messages (facultatif)
- Définir des API personnalisées
- Définir le canal personnalisé (composant sensible à la solution)
Customer Insights - Journeys fournit des composants de base pour la création d’un canal personnalisé, notamment les API personnalisées et les entités requises comme msdyn_channeldefinition, msdyn_channelmessagepart, msdyn_channellocale, msdyn_channelinstanceaccount et msdyn_channelinstance.
Le diagramme suivant illustre les principaux composants d’un canal Customer Insights - Journeys natif et d’une solution de canal personnalisée :
Le tableau suivant décrit les exigences d’implémentation pour les canaux SMS et personnalisés.
| Composant | SMS | Personnalisé |
|---|---|---|
| Entité de configuration étendue pour l’instance de canal | Requise | Requise |
| Entité de configuration étendue pour le compte de l’instance de canal | Requise | Non pris en charge |
| Parties du message | Obligatoire ; ne doit contenir qu’une seule partie du message avec "msdyn_name" = "texte" | Requise |
| Localisation pour l’interface utilisateur d’administration | Facultatif | Facultatif |
| Interface utilisateur de l’Éditeur de message | Non autorisé ; l’éditeur de SMS Customer Insights - Journeys natif est utilisé | Facultatif ; l’éditeur Customer Insights - Journeys générique est utilisé s’il n’est pas défini |
| API personnalisées | Obligatoire | Obligatoire |
| Définition de canal | Requise | Requise |
Exemples de solution
Les exemples suivants incluent des solutions décompressées pour Dataverse et les projets de plug-ins. Pour compresser et importer les solutions, créez d’abord le projet de plug-in. Le projet copie l’assembly dans le projet de la solution. Ensuite, conditionnez la solution à l’aide de l’outil de packager de solutions.
Comment générer le projet de plug-in et compresser la solution
Générez le projet de plug-ins avec MSBuild ou Visual Studio.
La génération du projet crée une DLL dans le dossier PluginAssemblies, à l’intérieur du dossier de la solution Dataverse.
Compressez le dossier non géré avec Solution Packager en utilisant soit :
- CLI pac (par défaut)
- Packager de solution
pac solution pack --zipfile C:\tmp\SampleCustomChannelSolution.zip -f src\Solutions\Samples\SampleCustomChannel\SampleCustomChannel.Solution\unmanaged --packagetype Both