Installer CXone 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 CXone Agent Embedded dans Microsoft Dynamics CIF v1.

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

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 CXone Agent Embedded.

1. Ouvrez Microsoft Power Apps.

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

3. Cliquez sur Centre d’administration Customer Service.

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. 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 CXone 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 CXone 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 CXone Agent Embedded.

1. Dans le centre d’administration Customer Service 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 CXone 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 Tableau de bord 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

Si vous ne l’avez pas encore fait, créez un modèle de session pour CXone Agent Embedded.

1. Dans le centre d’administration Customer Service 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, saisissez cxa_embedded_poc_session_2.

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

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

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

   6. Pour l’onglet Ancrage, sélectionnez le nom du modèle de session que vous avez saisi dans le champ Nom.

   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 CXone Agent Embedded qui apparaît aux agents.
   Mode du panneau de communication	Détermine la taille de CXone 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 CXone 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 de session pour que CXone Agent Embedded s’ouvre automatiquement lorsque les agents se connectent. Uniquement disponible lorsque Type est défini sur Générique.

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 CXone 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 CXone Agent Embedded.

1. Dans le centre d’administration Customer Service 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, saisissez CTI_inboundCallNotification.

   3. Dans le champ Titre, saisissez {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 CXone Agent Embedded qui apparaît aux agents.
   Icône	L’icône qui s’affiche pour CXone 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 CXone 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 Customer Service 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, saisissez max_session_reached.

   3. Dans le champ Titre, saisissez {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 CXone Agent Embedded qui apparaît aux agents.
   Icône	L’icône qui s’affiche pour CXone 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 CXone 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 Customer Service Microsoft Power Apps, Accédez à Expérience de l’agent > Espaces de travail dans le menu de gauche.

2. Dans Fournisseur de canal vocal tiers, cliquez sur Gérer.

3. Cliquez sur Nouveau.

4. Remplissez les champs du formulaire Nouveau fournisseur Environnement d’intégration du canal v2.0. 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, saisissez votre URL CXone Agent Embedded suivie de _msd&base=, suivi de l’URL de votre instance Microsoft Dynamics. Votre URL CXone 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 l’URL de votre instance Microsoft Dynamics est https://my.dynamics.com, l’URL de votre 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 suivants, séparés par des esperluettes (&) :

      • mode=1

      • width=450

      • sessionTemplate=cxa_embedded_poc_session_2

      • notificationTemplate=CTI_inboundCallNotification

      • maxSessionTemplate=max_session_reached

      Ou copiez et collez le texte suivant :

      mode=1&sessionTemplate=cxa_embedded_poc_session_2&notificationTemplate=CTI_inboundCallNotification&maxSessionTemplate=max_session_reached

   8. Dans le champ Activer l’analyse, 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 CXone Agent Embedded qui apparaît aux agents.
   URL du canal	Il comprend trois composants : Tout d’abord, l’URL de votre CXone 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 CXone 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 CXone Agent Embedded est réglé sur 1 et qu’un autre application d’agent est réglé sur 2, CXone 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. Le nom unique du modèle de session que vous avez créé. Le nom unique du modèle de notification d’appel entrant CTI que vous avez créé. Le nom unique du modèle de notification Nombre maximal de sessions atteint que vous avez créé. Chaque paramètre doit être séparé par une esperluette (&).
   Activer l’analyse	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 Customer Service 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.