Installer Agent Embedded dans Microsoft Dynamics CIF v2

Ces instructions concernent l’Environnement d’intégration du canal (CIF) Microsoft Dynamics version 2. Si vous utilisez CIF version 1, apprenez à installer Agent Embedded dans Microsoft Dynamics CIF v1.

Cette page explique comment installer CXone Mpower Agent Embedded dans Microsoft Dynamics. Une fois installé, les agents peuvent l’utiliser pour gérer les interactions directement dans Microsoft Dynamics.

Ce processus d’installation est effectué dans Microsoft Dynamics. Si vous n’avez pas accès à une section de Microsoft Dynamics mentionnée dans ces étapes, contactez l’administrateur Microsoft Dynamics de votre organisation pour vous assurer que vous disposez des autorisations nécessaires.

Créer un profil d’expérience de l’agent

Vous devez d’abord créer un profil d’expérience d’agent, ou profil d’application, pour Agent Embedded.

1. Ouvrez Microsoft Power Apps.

2. Accédez à Applications > Toutes les applications.

3. Cliquez sur Centre d’administration du service clientèle.

4. Dans le menu de gauche, accédez à Expérience de l’agent > Espaces de travail.

5. Dans Profils d’expérience de l’agent, cliquez sur Gérer.

6. Cliquez sur Nouveau.

7. Remplissez les champs du formulaire Nouveau profil.

   1. Attribuez un nom au profil d’expérience de l’agent.

   2. Pour Nom unique, saisissez une valeur qui suit ce format : prefix_name. Par exemple, CXone_appProfile.

   3. Pour fournir des informations supplémentaires sur le profil, saisissez une Description.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom du profil d’expérience de l’agent tel qu’il apparaît dans la liste des profils.
   Nom unique	Un identifiant unique pour le profil. Il doit suivre le format suivant : prefix_name. Le préfixe doit comporter entre 3 et 8 caractères et ne peut pas inclure de caractères spéciaux. Vous pouvez cliquer sur Vérifier pour vérifier si votre saisie répond aux exigences.
   Description	La description du profil telle qu’elle apparaît dans la liste des profils.

8. Assurez-vous que le privilège Lire le modèle de session (prvReadmsdyn_sessiontemplate) est attribué au profil d'expérience de l'agent. Les rôles Administrateur du gestionnaire de profils d'application et Utilisateur du profil d'application disposent tous deux de ce privilège.

9. Cliquez sur Créer.

Ajouter des utilisateurs au profil d’expérience de l’agent

1. Dans le profil d’expérience de l’agent que vous venez de créer, localisez la section Utilisateurs, puis cliquez sur Modifier.

2. Cliquez sur Ajouter des utilisateurs.

3. Sélectionnez les utilisateurs qui utiliseront Agent Embedded. Vous pouvez rechercher des utilisateurs dans la fenêtre Rechercher des enregistrements. Une fois que vous avez sélectionné tous les utilisateurs souhaités, cliquez sur Ajouter.

Créer un modèle d’onglet d’application

Si vous ne l’avez pas encore fait, créez un modèle d’onglet d’application pour Agent Embedded. Le modèle d’onglet de l’application détermine l’onglet qui s’ouvre au début d’une nouvelle session dans Agent Embedded.

1. Dans le centre d’administration du service client Microsoft Power Apps, accédez à Expérience de l’agent > Espaces de travail dans le menu de gauche.

2. Dans l’onglet Modèles d’application, cliquez sur Gérer.

3. Cliquez sur Nouveau.

4. Remplissez les champs du formulaire du nouveau modèle d’onglet Application.

   1. Attribuez un nom au modèle d’onglet d’application.

   2. Pour Nom unique, saisissez une valeur sans espace.

   3. Dans le champ Type de page, sélectionnez Enregistrement d’entité.

   4. Dans le champ Peut fermer, sélectionnez Oui.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom du modèle d’onglet de l’application.
   Nom unique	Un identifiant unique pour le modèle. Il doit suivre le format suivant : prefix_name. Le préfixe doit comporter entre 3 et 8 caractères et ne peut pas inclure de caractères spéciaux. Vous pouvez cliquer sur Vérifier pour vérifier si votre saisie répond aux exigences.
   Titre	Le titre de Agent Embedded qui apparaît aux agents.
   Type de page	Le type de page qui apparaît sur le modèle. Les valeurs possibles sont : Contrôle Personnaliser Dashboard Liste des entités Enregistrement d’entité Rechercher Site Web tiers Ressource Web
   Description	Une description du modèle.
   Peut fermer	Deux valeurs possibles : Oui : Le modèle peut être fermé. Non : Le modèle reste toujours ouvert dans Microsoft Dynamics.

Créer un modèle de session

Pour afficher Agent Embedded dans l'espace de travail Microsoft Dynamics, vous devez créer un modèle de session pour Agent Embedded.

Vous pouvez créer un ou deux modèles de session. Si vous créez un modèle de session, il apparaît pour les agents en tout temps, qu'ils gèrent ou non des interactions. Si vous créez deux modèles de session, ils incluent :

• Modèle de session par défaut : Apparaît lorsque l’agent n’est pas en train de traiter une interaction.

• Modèle de session d’interaction : Apparaît lorsque l’agent est en train de traiter une interaction. Vous pouvez configurer ce modèle de session pour qu’il affiche des onglets qui aident les agents à traiter les interactions.

1. Dans le centre d’administration du service client Microsoft Power Apps, accédez à Expérience de l’agent > Espaces de travail dans le menu de gauche.

2. Dans Modèles de session, cliquez sur Gérer.

3. Cliquez sur Nouveau.

4. Remplissez les champs du formulaire du nouveau modèle de Session. Les modifications sont enregistrées automatiquement.

   1. Donnez au modèle de session unNom.

   2. Dans le champ Nom unique, entrez default_template si vous créez un modèle de session par défaut ou si vous ne créez qu'un seul modèle de session. Entrez interaction_template si vous créez un modèle de session d’interaction.

   3. Dans le champ Type, sélectionnez Générique.

   4. Dans le champ Titre, entrez {title}.

   5. Dans le champ Mode du panneau de communication, sélectionnez Ancré.

   6. Dans le champ Propriétaire, recherchez et sélectionnez l'unité commerciale des utilisateurs qui utiliseront ce modèle de session.

   7. Pour Onglet d'ancrage, sélectionnez le nom du modèle d'onglet d'application que vous avez créé.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom du modèle de session.
   Nom unique	Un identifiant unique pour le modèle. Il doit suivre le format suivant : prefix_name. Le préfixe doit comporter entre 3 et 8 caractères et ne peut pas inclure de caractères spéciaux. Vous pouvez cliquer sur Vérifier pour vérifier si votre saisie répond aux exigences. Cette valeur sera utilisée pour configurer le fournisseur de canal.
   Type	Le type de modèle. Les valeurs possibles sont : Entité : Affiche le champ Entité. Générique : Permet d’attribuer le modèle à un fournisseur de canal.
   Titre	Le titre de Agent Embedded qui apparaît aux agents.
   Mode du panneau de communication	Détermine la taille de Agent Embedded lorsque les agents l’ouvrent. Les valeurs possibles sont : Ancré : L’application complète apparaît. Masqué : L’application est masquée. Minimisé : L’application est minimisée.
   Description	La description du modèle.
   Icône de session	L’icône qui s’affiche pour Agent Embedded. Il doit s’agir d’un fichier de ressources Web. Uniquement disponible lorsque Type est défini sur Générique.
   Propriétaire	L’utilisateur chargé de maintenir le modèle. Vous pouvez rechercher des utilisateurs dans ce champ.
   Onglet Ancrage	Sélectionnez le nom du modèle d'onglet d'application que vous avez créé pour qu'il s'ouvre Agent Embedded automatiquement lorsque les agents se connectent. Uniquement disponible lorsque Type est défini sur Générique.

5. Pour créer un deuxième modèle de session, répétez les étapes ci-dessus.

Créer des modèles de notification

Vous pouvez éventuellement créer deux modèles de notification dans Microsoft Power Apps :

• Appel entrant CTI : Alertez les utilisateurs lorsqu’une session va être fermée dans Agent Embedded.

• Session maximale atteinte : Alertez les utilisateurs lorsque le nombre maximal de neuf sessions a été atteint.

Si vous ne souhaitez pas créer de modèles de notification, passez à la section suivante.

Créer un modèle de notification pour les appels entrants CTI

Ce modèle de notification avertit les utilisateurs de la fermeture d’une session dans Agent Embedded.

1. Dans le centre d’administration du service client Microsoft Power Apps, accédez à Expérience de l’agent > Espaces de travail dans le menu de gauche.

2. Dans Modèles de notification, cliquez sur Gérer.

3. Cliquez sur Nouveau modèle de notification.

4. Remplissez les champs du formulaire du nouveau modèle de Notification. Les modifications sont enregistrées automatiquement.

   1. Attribuez un nom au modèle de notification. Par exemple, CTI : appel entrant.

   2. Dans le champ Nom unique, entrez CTI_inboundCallNotification.

   3. Dans le champ Titre, entrez {headerText}.

   4. Configurez les autres champs en fonction de vos préférences.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom du modèle de notification.
   Nom unique	Un identifiant unique pour le modèle. Il doit suivre le format suivant : prefix_name. Le préfixe doit comporter entre 3 et 8 caractères et ne peut pas inclure de caractères spéciaux. Vous pouvez cliquer sur Vérifier pour vérifier si votre saisie répond aux exigences.
   Titre	Le titre de Agent Embedded qui apparaît aux agents.
   Icône	L’icône qui s’affiche pour Agent Embedded. Il doit s’agir d’un fichier de ressources Web.
   Attribution automatique d’éléments de travail	Lorsque cette option est activée, les interactions sont automatiquement attribuées aux agents. Il est recommandé de désactiver cette option.
   Afficher le compte à rebours	Sélectionnez Oui pour afficher un compte à rebours aux agents par le biais d’une notification (recommandé). Sélectionnez Non pour masquer le minuteur.
   Compte à rebours (secondes)	Si vous avez sélectionné Oui pour Afficher le compte à rebours, saisissez le nombre de secondes pendant lesquelles vous souhaitez que la notification du minuteur s’affiche. La valeur recommandée est 5.
   Bouton Accepter	Le texte sur lequel les agents cliquent pour accepter les interactions. Le texte recommandé est Oui.
   Afficher le bouton Rejeter	Lorsqu’elle est activée, l’option permettant de rejeter une interaction est présentée aux agents. Il est recommandé d’activer cette option.
   Bouton Rejeter	Le texte sur lequel les agents cliquent pour rejeter les interactions. Le texte recommandé est Rejeter.
   Afficher les notifications de bureau	Choisissez d’activer ou non les notifications de bureau pour Agent Embedded. L’option recommandée est Jamais.
   Propriétaire	L’utilisateur chargé de maintenir le modèle. Vous pouvez rechercher des utilisateurs dans ce champ.

Créer un modèle de notification pour le nombre maximal de sessions atteint

Ce modèle de notification alerte les utilisateurs lorsque le nombre maximal de neuf sessions a été atteint.

1. Dans le centre d’administration du service client Microsoft Power Apps, accédez à Expérience de l’agent > Espaces de travail dans le menu de gauche.

2. Dans Modèles de notification, cliquez sur Gérer.

3. Cliquez sur Nouveau modèle de notification.

4. Remplissez les champs du formulaire du nouveau modèle de Notification. Les modifications sont enregistrées automatiquement.

   1. Attribuez un nom au modèle de notification. Par exemple, Nombre maximal de sessions atteint.

   2. Dans le champ Nom unique, entrez max_session_reached.

   3. Dans le champ Titre, entrez {headerText}.

   4. Configurez les autres champs en fonction de vos préférences.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom du modèle de notification.
   Nom unique	Un identifiant unique pour le modèle. Il doit suivre le format suivant : prefix_name. Le préfixe doit comporter entre 3 et 8 caractères et ne peut pas inclure de caractères spéciaux. Vous pouvez cliquer sur Vérifier pour vérifier si votre saisie répond aux exigences.
   Titre	Le titre de Agent Embedded qui apparaît aux agents.
   Icône	L’icône qui s’affiche pour Agent Embedded. Il doit s’agir d’un fichier de ressources Web.
   Attribution automatique d’éléments de travail	Lorsque cette option est activée, les interactions sont automatiquement attribuées aux agents. Il est recommandé de désactiver cette option.
   Afficher le compte à rebours	Sélectionnez Oui pour afficher un compte à rebours aux agents par le biais d’une notification (recommandé). Sélectionnez Non pour masquer le minuteur.
   Compte à rebours (secondes)	Si vous avez sélectionné Oui pour Afficher le compte à rebours, saisissez le nombre de secondes pendant lesquelles vous souhaitez que la notification du minuteur s’affiche. La valeur recommandée est 15.
   Bouton Accepter	Le texte sur lequel les agents cliquent pour accepter les interactions. Le texte recommandé est OK.
   Afficher le bouton Rejeter	Lorsqu’elle est activée, l’option permettant de rejeter une interaction est présentée aux agents. Il est recommandé de désactiver cette option.
   Afficher les notifications de bureau	Choisissez d’activer ou non les notifications de bureau pour Agent Embedded. L’option recommandée est Jamais.
   Propriétaire	L’utilisateur chargé de maintenir le modèle. Vous pouvez rechercher des utilisateurs dans ce champ.

Configurer le fournisseur de canal

1. Dans le centre d’administration du service client Microsoft Power Apps, accédez à Expérience de l’agent > Espaces de travail dans le menu de gauche.

2. Dans Profils d'expérience d'agent, sélectionnez le profil d'expérience d'agent que vous avez créé auparavant.

3. Cliquez sur Modifier à côté de Fournisseurs de chaînes.

4. Cliquez sur Nouveau à côté de Fournisseurs de canaux vocaux tiers.

5. Remplissez les champs du formulaire. Les modifications sont enregistrées automatiquement.

   1. Attribuez un nom au fournisseur de canal.

   2. Dans le champ Nom unique, saisissez une valeur sans espace.

   3. Dans le champ Étiquette, saisissez le nom tel que vous souhaitez qu’il apparaisse aux utilisateurs.

   4. Pour URL du canal, entrez votre URL Agent Embedded, suivie de _msd&base=, puis de votre URL d'instance Microsoft Dynamics. Votre URL Agent Embedded est l’une des URL suivantes :

      • Si vous n'êtes pas sur FedRAMP : https://cxagent.nicecxone.com/login?app=cxa

      • Si vous êtes sur FedRAMP : https://cxagent.nicecxone-gov.com/login?app=cxa

      Par exemple, si vous n'êtes pas sur FedRAMP et que votre URL d'instance Microsoft Dynamics est https://my.dynamics.com, votre URL de canal sera https://cxagent.nicecxone.com/login?app=cxa_msd&base=https://my.dynamics.com.

   5. Pour Activer la communication sortante, sélectionnez Oui.

   6. Pour Ordre des canaux, saisissez 1.

   7. Dans le champ Paramètres personnalisés, ajoutez les attributs et valeurs suivants, séparés par des esperluettes (&) :

      • mode=1
      • width=450
      • sessionTemplate=default_template : La valeur de cet attribut doit être égale au nom unique du modèle de session par défaut que vous avez créé.
      • notificationTemplate=CTI_inboundCallNotification : la valeur de cet attribut doit être égale au nom unique du modèle de notification d'appel entrant CTI que vous avez créé.
      • maxSessionTemplate=max_session_reached : La valeur de cet attribut doit être égale au nom unique du modèle de notification Nombre maximal de sessions atteintes que vous avez créé.
      • omniSessionTemplate=interaction_template : La valeur de cet attribut doit être égale au nom unique du modèle de session d'interaction que vous avez créé.

      Vous pouvez copier et coller ce qui suit pour l'utiliser comme modèle. Faites correspondre la valeur de chaque attribut de modèle au nom unique du modèle correspondant.

      mode=1&sessionTemplate=default_template&notificationTemplate=CTI_inboundCallNotification&maxSessionTemplate=max_session_reached&omniSessionTemplate=interaction_template

      À l'exception de mode=1 et sessionTemplate, tous les paramètres personnalisés énumérés ici sont facultatifs. Cependant, si vous avez créé plusieurs modèles de session, vous devez ajouter le paramètre omniSessionTemplate. Ça doit venir après le paramètre sessionTemplate. Si vous avez créé un seul modèle de session, vous devez utiliser uniquement le paramètre sessionTemplate.

   8. Dans le champ Activer Analytics, sélectionnez Oui.

   En savoir plus sur les champs de cette étape

   Champ	Détails
   Nom	Le nom du fournisseur de canal.
   Nom unique	Un identifiant unique pour le fournisseur de canal. Il doit suivre le format suivant : prefix_name. Le préfixe doit comporter entre 3 et 8 caractères et ne peut pas inclure de caractères spéciaux. Vous pouvez cliquer sur Vérifier pour vérifier si votre saisie répond aux exigences.
   Étiquette	Le titre de Agent Embedded qui apparaît aux agents.
   URL du canal	Il comprend trois composants : Tout d’abord, l’URL de votre Agent Embedded. Deuxièmement, _msd&base=. Troisièmement, l’URL de votre instance Microsoft Dynamics. Par exemple : https://cxagent.nicecxone.com/login?app=cxa_msd&base=https://my.dynamics.com.
   Activer la communication sortante	Active la fonctionnalité « cliquer pour composer » dans Agent Embedded pour les numéros de téléphone dans Microsoft Dynamics.
   Ordre des canaux	Détermine la priorité du fournisseur de canal. S’il est réglé sur 1, le fournisseur de canal sera utilisé avant les autres fournisseurs de canaux. Par exemple, si Agent Embedded est réglé sur 1 et qu’un autre application d’agent est réglé sur 2, Agent Embedded sera utilisé en premier pour les interactions.
   Version API	Coïncide avec votre version de l’Environnement d’intégration du canal. La valeur doit être 2.
   Paramètres personnalisés	Espace pour des paramètres supplémentaires. Ajoutez ces paramètres : mode=1 width=450 sessionTemplate=default_template : La valeur de cet attribut doit être égale au nom unique du modèle de session par défaut que vous avez créé. notificationTemplate=CTI_inboundCallNotification : la valeur de cet attribut doit être égale au nom unique du modèle de notification d'appel entrant CTI que vous avez créé. maxSessionTemplate=max_session_reached : La valeur de cet attribut doit être égale au nom unique du modèle de notification Nombre maximal de sessions atteintes que vous avez créé. omniSessionTemplate=interaction_template : La valeur de cet attribut doit être égale au nom unique du modèle de session d'interaction que vous avez créé. Chaque paramètre doit être séparé par une esperluette (&).
   Activer Analytics	Lorsque cette option est activée, elle permet à Microsoft Dynamics de recueillir des données analytiques sur le fournisseur de canal.

Mise à jour du profil d’expérience de l’agent

1. Dans le centre d’administration du service client Microsoft Power Apps, accédez à Expérience de l’agent > Espaces de travail dans le menu de gauche.

2. Dans Profils d’expérience de l’agent, cliquez sur Gérer.

3. Sélectionnez le profil d’expérience de l’agent que vous avez précédemment créé.

4. Sous Fournisseurs de canaux, assurez-vous que le fournisseur de canal que vous avez créé est répertorié à côté de Fournisseurs de canaux vocaux tiers. S’il n’apparaît pas, cliquez sur Modifier, puis sélectionnez-le dans la liste. Les modifications sont enregistrées automatiquement.