Exemple de code pour téléphone logiciel à l'aide de l'Environnement d'intégration du canal de Dynamics 365 2.0

Article
12/08/2023

Téléchargez l'exemple d'intégration de téléphone logiciel pour l'Environnement d'intégration du canal Microsoft Dynamics 365 version 2.0.

Note

L'exemple de code n'est pas pris en charge sur Internet Explorer et les navigateurs qui n'ont pas le support de webRTC. Pour plus d'informations, voir : WebRTC.

Conditions préalables

Omnicanal pour Dynamics 365 Customer Service
Un abonnement Azure valide est requis pour publier l’exemple d’application dans Azure.

Note

Si vous n’avez pas d’abonnement Azure, vous pouvez créer un compte gratuit.

Publier un exemple d’application dans Azure

Ouvrez la solution SampleInteg.sln à l’aide de Visual Studio 2017.
Dans Explorateur de solutions, cliquez avec le bouton droit sur la solution et générez la solution complète.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet SampleInteg, puis sélectionnez Publier.
Sélectionnez Démarrer pour lancer l’Assistant Publier.
Choisissez Service d’application comme cible de publication.
Sélectionnez Créer et sélectionnez Publier.
Fournissez un nom d’application. Par exemple, SampleInteg.
Fournissez un abonnement valide, un groupe de ressources, et les détails du plan d’hébergement.
Sélectionnez Créer pour créer le service d’application Azure, et enregistrez l’URL du service d’application pour une utilisation future.

Par exemple, https://sampleinteg.azurewebsites.net

Créer la fonction à utiliser avec le service d'application

Créez un exemple de code pour la fonction client-voice.
Reportez-vous à la fonction du fichier Lisez-moi fourni avec l’exemple d’intégration de téléphone logiciel dans le Portail Dynamics 365 Insider.
Utilisez l’exemple de code pour la fonction capability-token.
Reportez-vous à la fonction du fichier Lisez-moi fourni avec l’exemple d’intégration de téléphone logiciel dans le Portail Dynamics 365 Insider.

Note

Enregistrez l’URL pour la fonction capability-token que vous obtenez à partir de l’exemple de code ci-dessus. Par exemple, l'URL est https://sampleinteg.sample/capability-token.

Configurer l'exemple d'application dans Dynamics 365

Notez l'URL de base de l'organisation Dynamics 365 où toutes les ressources Web sont enregistrées. Pour un organisation en ligne, elle doit avoir le format https://<orgname>.crmXX.dynamics.com. Par exemple : https://sampleorg.crm10.dynamics.com
Obtenez la solution Environnement d'intégration du canal Dynamics 365. Pour plus d'informations, voir Obtenir l'Environnement d'intégration du canal Dynamics 365.

Configurez le fournisseur de canal en fournissant des détails comme le montre la matrice. Pour plus d'informations, consultez Configurer le fournisseur de canal.

Champ	Description
Nom	Nom du fournisseur de canal. Exemple : Contoso
Unique Name	Un identifiant unique au format <préfixe>_<nom>. IMPORTANT : Voici les conditions à remplir par le nom unique : Le préfixe ne peut être qu'alphanumérique et sa longueur doit être comprise entre 3 et 8 caractères. Le préfixe et le nom doivent être séparés par un trait de soulignement.
Label	L’étiquette s’affiche comme titre sur le widget. Exemple : Contoso
URL du canal	L’URL du canal Est dans le format : `<azure_app_service_url>?base=<crm_base_url>` Remarque : pour cet exemple, l’URL est `https://sampleinteg.azurewebsites.net?base=https://sampleorg.crm10.dynamics.com`.
Activer la communication sortante	Oui
Ordre des canaux	0
Version de l'API	2.0
Domaines approuvés	Domaine (URL) qui peut accéder aux API de l'Environnement d'intégration du canal.
Sélectionner les applications Unified Interface pour le canal	Liste des applications Unified Interface où le canal est affiché pour les agents.
Sélectionner les rôles pour le canal	Rôles de sécurité sont présents dans Dynamics 365. Remarque : si vous n’attribuez pas de rôles, le fournisseur de canal s’affiche pour tous les utilisateurs auxquels l’application Dynamics 365 Unified Interface est attribuée.

Lancez l'application Unified Interface pour afficher le widget de communication à gauche.

Important

Toutes les URL doivent être HTTPS.
Si vous utilisez un certificat auto-signé pour l’application Azure ou l’organisation Dynamics 365, certains navigateurs risquent de rejeter la connexion et échouer à charger l’exemple de téléphone. En tant que solution, ouvrez l’application Azure dans un autre onglet et acceptez le certificat une seule fois.
Vérifiez que l'accès au microphone et au haut-parleur n'est pas est bloqué par la stratégie du navigateur.

Importer les données de configuration

Téléchargez l'outil de migration de configuration. L'outil Migration de la configuration est disponible en tant que package NuGet.
Lancez l'outil Migration de la configuration. Doublez-cliquez sur DataMigrationUtility.exe dans le dossier : [your folder]\Tools\ConfigurationMigration\.
Dans l'écran principale, sélectionnez Importer les données, puis sélectionnez Continuer.
Dans l'écran de connexion, entrez les informations d'authentification pour vous connecter à l'instance Dynamics 365 à partir de laquelle vous voulez importer les données. S'il y a plusieurs organisations sur le serveur Dynamics 365 et que vous souhaitez sélectionner l'organisation vers laquelle importer les données de configuration, activez la case à cocher Toujours afficher la liste des organisations disponibles. Sélectionnez Connexion.
S'il y a plusieurs organisations et si vous avez activé la case à cocher Toujours afficher la liste des organisations disponibles, l'écran suivant vous demande de choisir l'organisation à laquelle vous voulez vous connecter. Sélectionnez une organisation Dynamics 365 à laquelle vous connecter.
Indiquez le fichier de données (data.zip) à importer. Accédez au fichier de données et sélectionnez-le. Sélectionnez Importer les données.
Cette étape est applicable uniquement si les données que vous importez contiennent les données utilisateur du système source. Entrez les données utilisateur de mappage sur le système cible. Vous pouvez mapper toutes ces données à l’utilisateur qui exécute le processus d’importation ou les mapper à des utilisateurs spécifiques en utilisant un fichier de mappage d’utilisateurs (.xml). Si vous choisissez la dernière option, vous devrez spécifier un fichier de mappage d’utilisateurs existant, ou alors l’outil pourra le générer pour vous. Si vous créez un nouveau fichier, entrez le nom d'utilisateur de mappage dans le paramètre Nouveau pour chaque utilisateur sur le serveur source. Lorsque vous avez terminé, sélectionnez le fichier de mappage d'utilisateurs dans l'outil, puis sélectionnez OK.
L'écran suivant affiche le statut d'importation de vos enregistrements. L'importation des données s'effectue en plusieurs temps. Les données de base sont importées d'abord et les données connexes sont mises en file d'attente. Les données connexes dans les phases successives, afin de gérer les dépendances ou liaisons de données. Ce mécanisme garantit une importation précises et cohérente des données.
Sélectionnez Terminer pour fermer cet outil.

Voir aussi

Obtenir l’Environnement d’intégration du canal Dynamics 365

Partager via