Dans cet article
Vue d'ensemble
dropdown icon
Propriétés de premier niveau de la mise en page JSON
    Titre de l'application
    logo
    Illustration de la page des tâches
    Arrêter de naviguer sur Accepter la tâche
    Le glisser-déposer est activé
    Minuteur de notifications
    Nombre maximum de notifications
    Minuteur de notification du navigateur
    Configuration WXM
    Application de chat pour ordinateur
    Actions des en-têtes
    zone
    En-tête avancé
dropdown icon
Page d'accueil
    Configuration de la mise en page d'accueil
dropdown icon
Navigation (pages personnalisées)
    Attributs des onglets persistants
Configuration des widgets persistants
Widgets d'en-tête
Volet d'information auxiliaire
Widgets sans tête
Partager des données depuis votre ordinateur vers des widgets
Aperçu de la campagne
Screen Pop
Exemples de cas d'utilisation
Localisation

Créez un agencement de bureau personnalisé

list-menuDans cet article
list-menuUn commentaire ?

Cet article vous aide à créer une mise en page personnalisée en modifiant un fichier JSON et propose des exemples de cas d'utilisation pour vous aider à démarrer avec des widgets tels que le widget Customer Experience Management Metrics et le widget Customer Experience Journey. Pour travailler efficacement avec des mises en page de bureau personnalisées, vous devez bien comprendre la structure HTML, le modèle d'arborescence des documents dans un navigateur et le format JSON.

Vue d'ensemble

La fonction Desktop Layout vous permet de configurer le bureau du centre d'appels Webex en fonction de vos besoins professionnels. Vous pouvez personnaliser des éléments tels que le logo, le titre et les widgets. Vous pouvez créer une mise en page de bureau et l'attribuer à une équipe. Cette mise en page génère l'expérience d'agent sur le bureau pour tous les agents qui se connectent en tant que membres de cette équipe.

Il existe deux types de mises en page :

  • Disposition globale : Cette mise en page est une mise en page générée par le système qui est attribuée par défaut lorsque vous créez une équipe. Pour plus d'informations, voir Gérer les équipes. Lorsque vous créez une équipe, la mise en page globale est automatiquement définie comme disposition du bureau pour l'équipe. Vous ne pouvez pas supprimer cette mise en page.

  • Mise en page personnalisée : une mise en page qui offre une expérience de bureau personnalisée. Vous pouvez créer une mise en page personnalisée pour une ou plusieurs équipes.

Si vous attribuez une nouvelle mise en page de bureau lorsqu'un agent est connecté, celui-ci doit recharger la page pour voir la nouvelle mise en page.

Le Webex Contact Center Desktop prend en charge trois personnages :

  • Agent

  • Superviseur

  • Un superviseur et un agent

Le fichier de mise en page JSON comporte des sections distinctes pour chacun des personnages. L'administrateur doit configurer les paramètres de chaque personnage dans la section correspondante du fichier de mise en page JSON. Pour plus d'informations sur un exemple de fichier de mise en page JSON, voir Propriétés de premier niveau de la mise en page JSON.

Lorsque Cisco ajoute une nouvelle fonctionnalité à la disposition des ordinateurs de bureau, la mise en page non modifiée est automatiquement mise à jour avec les nouvelles fonctionnalités. La nouvelle disposition du bureau est automatiquement mise à la disposition des équipes existantes qui l'utilisent telle qu'elle n'a pas été modifiée. Les utilisateurs d'ordinateurs de bureau qui utilisent la mise en page non modifiée bénéficient des nouvelles fonctionnalités basées sur la mise en page lorsqu' ils se connectent ou rechargent le navigateur.

Si vous utilisez le fichier .json de Default Desktop Layout.json sans aucune modification, il est considéré comme une mise en page non modifiée. Cependant, si vous téléchargez le fichier .json de Default Desktop Layout.json et que vous le chargez à nouveau, il est considéré comme une mise en page modifiée, même si le contenu ou le nom du fichier ne sont pas modifiés.

Pour les équipes qui utilisent une mise en page de bureau personnalisée, les administrateurs doivent régulièrement actualiser la définition de la mise en page pour y intégrer de nouvelles fonctionnalités. Lorsque les administrateurs consultent une mise en page non modifiée ou qu'une équipe utilise une mise en page non modifiée, un message s'affiche indiquant que les nouvelles fonctionnalités du bureau sont automatiquement appliquées.

Sur le bureau, il existe deux types de widgets : ceux basés sur des iframes et ceux basés sur des composants Web. L'en-tête, la navigation (page personnalisée), la zone persistante, la zone sans en-tête et le panneau auxiliaire sont les zones personnalisables d'un bureau. Ce ne sont pas des widgets.

La liste suivante détaille les espaces que vous pouvez configurer. Les images illustrent la disposition du bureau :

  1. Zone Titre et logo : Cet espace affiche le logo et le nom du centre d'appels Webex (par défaut) en haut à gauche de votre écran.

  2. Zone d'en-tête horizontale : Cet espace comporte une zone configurable remplie de widgets personnalisés. Ces widgets peuvent afficher, par exemple, des informations en ligne et des menus déroulants. Comme la hauteur de cet en-tête n'est que de 64 pixels, la hauteur du widget ne peut pas dépasser la hauteur de l'en-tête.

  3. Espace de travail : Cet espace change en fonction de la sélection dans la barre de navigation ou lorsqu'un agent interagit avec des clients. Lorsqu'un agent est en communication, cette zone affiche le panneau de contrôle des interactions et d'informations auxiliaires (qui inclut des widgets personnalisés et des widgets permanents). Lorsqu'un agent interagit par e-mail, par chat ou sur les réseaux sociaux, cette zone affiche la zone de travail et le volet d'informations auxiliaires (qui inclut la zone des widgets permanents).

    La page personnalisée s'affiche sur l'interface du bureau, dans le volet de l'espace de travail. Vous pouvez accéder à la page personnalisée via les icônes de la barre de navigation. Chaque page personnalisée peut contenir un ou plusieurs widgets personnalisés.

    Custom Widget est une application tierce configurée au format JSON. Vous pouvez placer le widget personnalisé sur la page personnalisée, l'onglet personnalisé (volet Informations auxiliaires) ou sur l'en-tête horizontal du bureau.

  4. Zone de la barre de navigation : utilisez cet espace pour ajouter des éléments de navigation afin d'accéder à des pages personnalisées.

Sample Webex Contact Center Desktop user interface for voice, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
Exemple d'interface utilisateur de bureau pour la voix
Sample Webex Contact Center Desktop user interface for new digital channels, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
Exemple d'interface utilisateur de bureau pour les nouvelles chaînes numériques

Propriétés de premier niveau de la mise en page JSON

Rôles

La mise en page JSON par défaut comporte les trois rôles suivants.

  • Agent : pour configurer la disposition du bureau à afficher lorsqu'un agent se connecte au Webex Contact Center Desktop pour gérer les activités des agents.

  • Superviseur : définir la disposition du bureau à afficher lorsqu'un superviseur se connecte au Webex Contact Center Desktop afin de gérer uniquement les fonctionnalités du superviseur.

    Lorsqu'un superviseur se connecte au bureau, la disposition du bureau spécifiée pour l'équipe principale est appliquée. Si vous ne fournissez pas d'équipe principale, c'est la mise en page globale qui s'applique. Par défaut, les rapports APS sont désactivés.

  • SupervisorAgent : pour définir la disposition du bureau à afficher lorsqu'un superviseur se connecte au Webex Contact Center Desktop afin de gérer à la fois les fonctionnalités du superviseur et les activités des agents.

Vous pouvez ajouter ou modifier des widgets pour chaque rôle dans le persona correspondant dans le fichier de mise en page JSON correspondant.

Voici les propriétés de premier niveau de la mise en page JSON en fonction du rôle :

{
    "agent": {
        "version": "0.1.0",
        "appTitle": "Webex Contact Center",
        "logo": "",
        "taskPageIllustration": "https://www.abc.com/image/logo.jpg",
        "stopNavigateOnAcceptTask": false,
        "dragDropEnabled": false,
        "notificationTimer": 8,
        "maximumNotificationCount": 3,
        "browserNotificationTimer": 8,
        "wxmConfigured": false,
        "desktopChatApp": {
            "webexConfigured": false,
        }
        "headerActions": ["outdial", "notification"],
        "area": {
            "advancedHeader": {
                ...
            },
            "panel": {
                ...
            },
            "navigation": {
                ...
            },
            "persistent": {
                ...
            },
            "headless": {
                ...
            }
        },
    },
    "supervisor": {
        "version": "0.1.0",
        "appTitle": "Webex Contact Center",
        "logo": "",
        "taskPageIllustration": "https://www.abc.com/image/logo.jpg",
        "stopNavigateOnAcceptTask": false,
        "dragDropEnabled": false,
        "notificationTimer": 8,
        "maximumNotificationCount": 3,
        "browserNotificationTimer": 8,
        "wxmConfigured": false,
        "desktopChatApp": {
            "webexConfigured": false,
        }
        "headerActions": ["outdial", "notification"],
        "area": {
            "advancedHeader": {
                ...
            },
            "panel": {
                ...
            },
            "navigation": {
                ...
            },
            "persistent": {
                ...
            },
            "headless": {
                ...
            },
            "homePage": {
                ...
            }
        },
    }
    "supervisorAgent": {
        "version": "0.1.0",
        "appTitle": "Webex Contact Center",
        "logo": "",
        "taskPageIllustration": "https://www.abc.com/image/logo.jpg",
        "stopNavigateOnAcceptTask": false,
        "dragDropEnabled": false,
        "notificationTimer": 8,
        "maximumNotificationCount": 3,
        "browserNotificationTimer": 8,
        "wxmConfigured": false,
        "desktopChatApp": {
            "webexConfigured": false,
        }
        "headerActions": ["outdial", "notification"],
        "area": {
            "advancedHeader": {
                ...
            },
            "panel": {
                ...
            },
            "navigation": {
                ...
            },
            "persistent": {
                ...
            },
            "headless": {
                ...
            }
        },
    }
},
  • Les modifications apportées aux propriétés de mise en page JSON prennent effet lorsque le navigateur Desktop sera actualisé.
  • Si une fonctionnalité que vous avez activée en format JSON n'est pas disponible sur le bureau, contactez le support Cisco pour l'activer.
  • Toutes les propriétés de la mise en page JSON font la distinction entre majuscules et minuscules.

Titre de l'application

Indiquer un titre sur l'en-tête horizontal du bureau. Le titre par défaut est Webex Contact Center.

Exemple :

"appTitle": "Webex Contact Center"

L'AppTitle par défaut est passé de Contact Center Desktop à Webex Contact Center. Cela n'a aucun impact sur les mises en page personnalisées existantes qui utilisent l'ancien AppTitle par défaut (Contact Center Desktop). Pour utiliser le nouvel AppTitle, vous devez modifier la mise en page personnalisée. Cependant, la nouvelle mise en page globale utilise l'AppTitle par défaut en tant que Webex Contact Center.

Le titre peut être du texte, une image ou une chaîne vide. Le texte du titre apparaît sur deux lignes. Si le texte dépasse la deuxième ligne, une icône en forme de point de suspension s'affiche et l'info-bulle affiche le titre complet. Les styles ne peuvent pas être appliqués au titre.

Vous pouvez soit utiliser des URI de données (Uniform Resource Identifier), soit héberger une image de titre personnalisée sur un réseau de diffusion de contenu (CDN), un bucket Amazon Web Services (AWS) Simple Storage Service (S3) ou un service d'hébergement similaire, puis spécifier l'URL de l'image hébergée. Les formats d'image de titre pris en charge sont PNG, JPG, JPEG, GIF, SVG et WebP. La taille d'image de titre prise en charge est de 184 x 32 pixels (largeur x hauteur).

logo

Pour spécifier l'URL du logo de l'entreprise. Si vous ne fournissez pas d'URL, le logo du centre d'appels Webex apparaît par défaut.

Exemple :

"logo": "https://my-cdn.com/logo.png"

Vous pouvez héberger une image de logo personnalisée sur un CDN, un bucket Amazon Web Services (AWS) Simple Storage Service (S3) ou un service d'hébergement similaire, puis spécifier l'URL de l'image hébergée. Les formats d'image du logo pris en charge sont PNG, JPG, JPEG, GIF, SVG et WebP. La taille d'image du logo prise en charge est de 96 x 32 pixels (largeur x hauteur).

Tableau 1. Matrice d'affichage pour AppTitle et logo en fonction de la configuration de la mise en page du bureau
État Exemple Titre de l'application logo
Si AppTitle et le logo ne sont pas configurés
"appTitle": "",
  "logo": "",
Sans titre Logo par défaut
Si AppTitle et le logo sont configurés
"appTitle": "ABC Company",
  "logo": "https://my-cdn.com/abclogo.png",
Texte configuré Logo configuré
Si AppTitle est configuré mais que le logo ne l'est pas
"appTitle": "ABC Company",
  "logo": "",
Texte configuré Logo par défaut

Si AppTitle n'est pas configuré et que le logo l'est

"appTitle": "",
  "logo": "https://my-cdn.com/abclogo.png",
Sans titre Logo configuré
Si AppTitle est configuré et que le logo n'est pas préféré
"appTitle": "ABC Company",
  "logo": "no-logo",
Texte configuré Pas de logo

Si AppTitle n'est pas configuré et que le logo n'est pas préféré

"appTitle": "",
  "logo": "no-logo",
Sans titre Pas de logo
Si AppTitle est ajouté en tant qu'image et que le logo est configuré
"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "https://my-cdn.com/abclogo.png",
Image configurée Logo configuré

Si AppTitle est ajouté en tant qu'image et que le logo n'est pas configuré

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "",
Image configurée Logo par défaut

Si AppTitle est ajouté en tant qu'image et que le logo n'est pas préféré

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "no-logo",
Image configurée Pas de logo
  • La taille d'image personnalisée est ajustée en fonction du format d'image. Le texte du titre personnalisé configuré précédemment peut désormais apparaître sur deux lignes sur le bureau. Pour éviter cela, vous pouvez modifier le texte personnalisé du titre.
  • Si le titre et le logo ne sont pas configurés dans l'en-tête horizontal du bureau, cet espace est utilisé par les widgets d'en-tête. Les widgets d'en-tête doivent être correctement configurés pour utiliser l'espace du titre et du logo.
  • Le titre et le logo réunis ne peuvent pas dépasser la largeur maximale de 304 pixels (rembourrage compris). Si la largeur du logo est inférieure à 96 pixels, la largeur restante peut être utilisée pour le titre.
  • Si la taille d'image personnalisée est supérieure à la taille autorisée, elle est ajustée en fonction du rapport hauteur/largeur de l'en-tête horizontal. Si la taille d'image personnalisée est inférieure à la taille autorisée, la taille réelle de l'image est conservée dans l'en-tête horizontal.

Illustration de la page des tâches

Pour spécifier une illustration personnalisée pour la page des tâches en fonction des préférences de l'organisation et de l'alignement de la marque. Lorsqu'un agent se connecte, la page des tâches affiche l'illustration configurée en arrière-plan. Par défaut, la page des tâches apparaît sans illustration.

Exemple :

"taskPageIllustration": "https://www.abc.com/image/logo.jpg",

Vous pouvez utiliser des URI de données ou héberger une illustration personnalisée sur un réseau de diffusion de contenu (CDN), un bucket Amazon Web Services (AWS) Simple Storage Service (S3) ou un service d'hébergement similaire, puis spécifier l'URL de l'illustration hébergée. L'illustration peut être configurée au niveau mondial ou au niveau de l'équipe en fonction de la définition de la mise en page. Assurez-vous de configurer la bonne URL pour éviter que l'image cassée ne s'affiche sur le bureau.

Les formats d'illustration des pages de tâches pris en charge sont PNG, JPG, JPEG, GIF, SVG et WebP. La taille d'illustration recommandée est de 400 x 400 pixels (largeur x hauteur). Si la taille de l'illustration personnalisée est supérieure à la taille recommandée, la taille de l'illustration est ajustée en fonction du rapport hauteur/largeur de la page des tâches. Si la taille de l'illustration personnalisée est inférieure à la taille recommandée, la taille réelle de l'illustration est conservée sur la page des tâches.

Webex Contact Center interface example of a custom illustration retraining the actual size.
Exemple d'illustration personnalisée conservant la taille réelle
Webex Contact Center interface example of a custom illustration adjusted based on the aspect ratio.
Exemple d'illustration personnalisée ajustée en fonction du rapport hauteur/largeur

Arrêter de naviguer sur Accepter la tâche

Pour déterminer s'il faut se concentrer sur une tâche qui vient d'être acceptée, lorsque l'agent accepte la nouvelle tâche alors qu'il travaille sur une tâche précédente. La valeur par défaut est False.

Exemple :

"stopNavigateOnAcceptTask": false

Si la valeur est définie comme vraie, lorsque l'utilisateur accepte une nouvelle tâche sur le bureau, le focus est maintenu sur la tâche précédente et ne passe pas à la nouvelle tâche acceptée. Ce paramètre empêche l'utilisateur de perdre des données lorsqu'il accepte une nouvelle demande.

Par exemple, imaginez que l'agent 1 discute avec le client 1 et qu'il passe simultanément un appel vocal avec le client 2. Pendant l'appel vocal, l'agent 1 met à jour les coordonnées du client 2 dans le volet Interaction Control. Actuellement, l'Agent 1 a deux tâches actives dans le volet Liste des tâches, et l'accent est mis sur le volet Contrôle des interactions. Lorsque l'agent 1 accepte une nouvelle demande de chat du client 3, l'accent reste mis sur le volet de contrôle des interactions avec le client 2 et non sur la demande de chat récemment acceptée.

Pour rester concentrée sur la tâche précédente et ne pas passer à la nouvelle tâche acceptée, sélectionnez la mise en page personnalisée avec la valeur de la propriété StopNavigateOnAcceptTask définie sur true.

Si la valeur de la propriété StopNavigateOnAcceptTask n'est pas saisie dans la mise en page JSON, le Desktop se concentre sur la tâche nouvellement acceptée. Le comportement est similaire à celui lorsque la valeur de la propriété StopNavigateOnAcceptTask est définie sur false.

  • Le réglage s'applique à toutes les tâches (voix et canaux numériques) effectuées sur le bureau, comme l'acceptation d'une tâche, une conférence, une consultation ou un transfert, et pour les appels sortants, les appels de campagne sortants, la clôture automatique, etc.
  • Le paramètre ne s'applique pas si l'utilisateur de l'ordinateur est sur la page d'accueil et qu'aucune tâche n'est active dans le volet Liste des tâches. Dans ce cas, lorsqu'une nouvelle tâche est acceptée, l'attention passe de la page d'accueil à la tâche qui vient d'être acceptée.

Le glisser-déposer est activé

Pour activer le glisser-déposer et le redimensionnement des widgets sur les pages personnalisées, définissez la valeur sur true. La valeur par défaut est False.

Exemple :

"dragDropEnabled": false

Pour plus d'informations sur l'activation de la fonction glisser-déposer pour les onglets du volet d'informations auxiliaires, voir Volet d'informations auxiliaires.

Minuteur de notifications

Pour définir la durée (en secondes) au bout de laquelle les notifications du bureau seront automatiquement supprimées. La notification apparaît en haut à droite du bureau. Le délai d'attente par défaut est de 8 secondes. La plage valide pour les valeurs de temporisation est de 1 à 10 secondes. Pour que les modifications du délai d'attente prennent effet, le navigateur doit être actualisé une fois les modifications apportées.

Exemple :

"notificationTimer": 8

Nombre maximum de notifications

Pour définir le nombre de notifications à afficher simultanément sur le bureau. La valeur par défaut est 3. La plage des notifications sur ordinateur va de 1 à 10. Les notifications de bureau sont empilées. S'il y a de nombreuses notifications, elles apparaissent avec un léger retard selon les paramètres de NotificationTimer.

Exemple :

"maximumNotificationCount": 3

Minuteur de notification du navigateur

Pour définir la durée (en secondes) au bout de laquelle les notifications du navigateur sur le bureau seront automatiquement supprimées. Toaster est une notification native du navigateur qui n'apparaît que si le bureau n'est pas la fenêtre ou l'onglet actif du navigateur. La fenêtre ou l'onglet du navigateur de bureau est inactif lorsque

  • Vous travaillez sur d'autres fenêtres ou onglets de navigateur.

  • Vous travaillez sur d'autres applications.

  • Vous avez réduit la fenêtre du navigateur de bureau.

La notification apparaît en haut à droite du bureau. Le délai d'attente par défaut est de 8 secondes. La plage recommandée pour les valeurs de temporisation est de 5 à 15 secondes. Pour que les modifications du délai d'attente prennent effet, le navigateur doit être actualisé une fois les modifications apportées.

Exemple :

"browserNotificationTimer": 8

Le délai d'attente configuré pour les notifications du navigateur dépend du système d'exploitation et des paramètres du navigateur. La valeur du délai d'attente est respectée dans le navigateur Chrome sur les systèmes d'exploitation Windows, Chrome OS et macOS. Cependant, les autres navigateurs pris en charge ne respectent pas régulièrement le délai de notification configuré.

Configuré avec WXM

(Facultatif) Pour configurerWebex Experience Management, définissez la valeur sur true. La valeur par défaut est False.

Exemple :

"wxmConfigured": true

Application de chat pour ordinateur

Pour configurer plusieurs applications de chat proposées par Cisco, comme l'application Webex.

Configuration WebEx

L'application Webex ainsi que ses fonctionnalités de messagerie et de réunion peuvent être configurées sur le bureau. Cette configuration permet aux agents de collaborer avec d'autres agents, superviseurs et experts en la matière (PME) de leur organisation sans quitter le bureau.

Pour configurer l'application Webex sur le bureau :

  • DansCisco Webex Control Hub, lorsque vous ajoutez des services à un utilisateur, cochez la case Messagerie avancée (Utilisateurs > Gérer les utilisateurs > Services > Messagerie). Pour plus d'informations, voir Gérer les comptes utilisateurs dans l'administration Cisco Webex du site.

  • Dans la mise en page personnalisée du bureau, définissez la valeur de la propriété WebExConfigurated sur true.

    Exemple :

    "desktopChatApp": {
        "webexConfigured": true
    },

    La valeur par défaut de la propriété WebExConfigurated est false.

    L'application Webex est disponible pour les rôles d'agent, de superviseur et de SupervisorAgent uniquement si vous définissez la valeur de la propriété WebExConfigurated sur true pour chacun de ces rôles. L'agent, le superviseur ou le SupervisorAgent n'arrive pas à se déconnecter de l'application Webex.

    Pour afficher l'icône Icône Webex (Webex) sur l'en-tête horizontal du bureau, entrez la valeur webex dans la propriété HeaderActions. Pour plus d'informations, voir HeaderActions.

    Pour activer l'application Webex pour une équipe en particulier, sélectionnez la mise en page personnalisée avec la valeur de propriété WebExConfigurated définie sur true. Pour plus d'informations, voir Créer une équipe.

Vous pouvez également configurer l'application Webex dans le volet Informations auxiliaires, la page personnalisée et le widget personnalisé. Pour plus d'informations, voir Volet d'information auxiliaire.

Notification de l'application Webex

Les valeurs spécifiées à l'aide des propriétés NotificationTimer et BrowserNotificationTimer pour le minuteur de notification sont applicables à l'application Webex. Le délai d'expiration par défaut est de 8 secondes pour ces propriétés. Pour plus d'informations, consultez NotificationTimer et BrowserNotificationTimer.

Actions des en-têtes

Pour modifier l'ordre des icônes sur l'en-tête horizontal du bureau. L'ordre par défaut est le suivant :

  1. Icône Webex(Webex)

  2. Utiliser le téléphone comme indicateur audio(Appel extérieur)

  3. Icône de notification.(Centre de notifications)

Définissez la valeur de la propriété HeaderActions comme suit :

Nom de l'icône

Valeur de la propriété HeaderActions

Application Webex

webex

Appel extérieur

extérieur

Centre de notifications

notification

Exemple :

« HeaderActions » : [« webex », « outdial », « notification »],

La valeur de la propriété HeaderActions distingue les majuscules et minuscules.

Pour modifier l'ordre par défaut des icônes, entrez la propriété HeaderActions et les valeurs correspondantes dans la mise en page personnalisée.

Exemple :

« HeaderActions » : [« notification », « outdial », « Webex »],
  • Si vous ne saisissez pas la propriété et les valeurs HeaderActions dans la mise en page personnalisée, les icônes s'affichent dans l'ordre par défaut.
  • Pour supprimer les icônes d'en-tête et les fonctionnalités associées du bureau, définissez une valeur vide pour la propriété HeaderActions (« HeaderActions » : []). Cependant, si vous avez ajouté l'application Webex au volet d'informations auxiliaires, à une page personnalisée ou en tant que widget personnalisé, l'agent peut toujours accéder à l'application Webex même si l'application Webex n'est pas disponible dans l'en-tête horizontal du bureau.
  • Si la valeur de la propriété WebExConfigured est définie sur false, l'icône de l'application Webex ne s'affiche pas sur l'en-tête horizontal du bureau, même si la valeur Webex est ajoutée dans la propriété HeaderActions. Pour plus d'informations, voir WebExConfigured.

zone

La propriété de la zone est la section principale de la mise en page du bureau. Vous pouvez définir la disposition en fonction de la zone.

"area": {
    "header": {
        ...
    },
    "advancedHeader: {
        {
          "comp": "widget-1",
          "attributes": { ... },
          "script": ....
        }
    },
    "panel": {
        ...
    },
    "navigation": {
        ...
    },
    "persistent": {
        ...
    },
    "headless": {
        ...
    }
},

Vous pouvez configurer les objets de zone suivants :

  • Panneau : représente le deuxième panneau ou le panneau le plus à droite du volet Informations auxiliaires.

  • Navigation : représente les pages personnalisées et les éléments de navigation qui y sont liés.

  • Persistant : représente les widgets permanents au niveau de la page qui s'affichent sur toutes les pages du bureau.

  • Headless : représente les widgets qui n'ont pas d'interface visuelle mais qui exécutent une logique en arrière-plan.

Si la propriété AdvancedHeader est configurée, les propriétés header et HeaderActions doivent être supprimées.

En-tête avancé

Pour personnaliser la visibilité et modifier l'ordre des icônes sur l'en-tête horizontal du bureau. L'ordre par défaut est le suivant :

  1. Icône Webex(Webex)

  2. Utiliser le téléphone comme indicateur audio(Appel extérieur)

  3. Icône de notification.(Centre de notifications)

  4. Sélecteur d'état des agents du Webex Contact Center.(Agent State Selector)

Définissez la valeur de la propriété AdvancedHeader comme suit :

Nom de l'icône

Valeur de la propriété HeaderActions

Application Webex

agentx-webex

Appel extérieur

agentx-outdial

Centre de notifications

agentx-notification

Sélecteur d'état des agents

agentx-state-Selector

Exemple :

"advancedHeader": [
        {
          "comp": "agentx-webex"
        },
        {
          "comp": "agentx-outdial"
        },
        {
          "comp": "agentx-notification"
        },
        {
          "comp": "agentx-state-selector"
        }
        {
          "comp": "widget-1",
          "attributes": { ... },
          "script": ....
        }
      ]

La valeur de la propriété AdvancedHeader distingue les majuscules et minuscules.

Pour modifier l'ordre par défaut des icônes, entrez la propriété AdvancedHeader et les valeurs correspondantes dans la mise en page personnalisée.

Les widgets apparaissent dans le menu déroulant de gauche à droite.

  • Si vous ne saisissez pas la propriété AdvancedHeader dans la mise en page personnalisée, l'en-tête par défaut s'affiche.

  • Lorsque l'en-tête avancé est activé, vous devez déplacer les widgets de l'en-tête existant vers l'en-tête avancé, comme indiqué dans l'exemple.

  • Lorsque l'en-tête avancé est activé, l'ancien en-tête ne s'affiche pas.

  • Chaque icône de widget possède un rembourrage et une marge par défaut qui sont définis par le biais du CSS et ne peuvent pas être personnalisés sur le bureau.

  • L'emplacement du logo, du titre et des icônes de profil est fixe et ne peut pas être personnalisé.

  • Pour supprimer les icônes d'en-tête et les fonctionnalités associées du bureau, définissez une valeur vide pour le composant associé dans la propriété AdvancedHeader (« AdvancedHeader » : []).

    Si vous avez ajouté l'application Webex au volet d'informations auxiliaires, à une page personnalisée ou en tant que widget personnalisé, l'agent peut toujours accéder à l'application Webex, même si l'application Webex n'est pas disponible dans l'en-tête horizontal du bureau.

  • Si vous ajoutez un widget avec une étiquette longue, un nom d'étiquette tronqué s'affiche en fonction de l'espace disponible.

    Vous pouvez utiliser l'attribut TextContent pour ajouter un libellé à un widget.

    Exemple :

    {
              "comp": "timer-widget",
              "attributes": { "duration": "08:00:00" },
              "textContent": "Count Down Timer for Current Shift",
              "script": "https://wxcc-demo.s3.amazonaws.com/widgets/timer-widget.js"
            }

    L'étiquette « Compte à rebours pour le quart de travail en cours » sera tronquée et affichée en fonction de l'espace disponible.

    • Évitez d'ajouter des widgets avec une étiquette trop longue.

    • Lorsqu'un widget apparaît dans la liste déroulante, seule l'icône du widget est cliquable.

  • Si la valeur de la propriété WebExConfigured est définie sur false, l'icône de l'application Webex ne s'affiche pas sur l'en-tête horizontal du bureau, même si la valeur Webex est ajoutée dans la propriété AdvancedHeader. Pour plus d'informations, voir WebExConfigured.

Page d'accueil

Lorsque vous vous connectez à l'ordinateur, vous accédez à la page d'accueil.

La page d'accueil ne s'applique qu'aux superviseurs et au personnage de SupervisorAgent.

Vous pouvez consulter les widgets suivants sur la page d'accueil. Les widgets d'analyse sont fournis par défaut, mais l'administrateur peut également configurer des widgets permanents et personnalisés. Pour plus d'informations, voir Propriétés de premier niveau de la mise en page JSON.

Widgets d'analyse

Par défaut, le widget Analyzer s'affiche sur la page d'accueil de l'ordinateur.

Configuration de la mise en page d'accueil

Vous pouvez configurer la page d'accueil du bureau pour qu'elle affiche une mise en page en fonction des préférences de votre organisation et de l'alignement de votre marque. Modifiez le champ Page d'accueil pour configurer la page d'accueil. Vous pouvez configurer les éléments suivants pour qu'ils s'affichent sur la page d'accueil lorsqu'un utilisateur se connecte à l'ordinateur de bureau :

  • Un message de bienvenue

  • L'icône Tâche sur la barre de navigation pour accéder au volet des tâches. L'icône de la tâche apparaît pour le rôle de superviseur et de superviseur et d'agent lorsque la fonction de surveillance des appels est activée. Le volet des tâches affiche les demandes des clients entrantes, les interactions clients actives et passées et les demandes de surveillance actives.

  • Filtrez les sections telles que le nom de la file d'attente, le type de chaîne et les équipes gérées.

Le tableau suivant décrit les propriétés de page requises pour configurer la page d'accueil :

Tableau 2. Mise en page dynamique de la page d'accueil : propriétés de la page

Immobilier

Description et code

page > UseFlexLayout

Flex Layout est un nouveau composant Web. Cela ne modifie pas les widgets existants. La nouvelle mise en page flexible utilise le même format de configuration de manière simplifiée. Il est rétrocompatible et n'a aucun impact sur les widgets existants. Vous devez configurer la mise en page JSON. Pour configurer la mise en page JSON, indiquez la hauteur et la largeur du widget. Le widget est affiché dans l'ordre dans lequel il est configuré dans la mise en page JSON. Les widgets ont une marge par défaut de 8 pixels.

La mise en page JSON est basée sur les dimensions (largeur x hauteur) et les coordonnées (X, Y et Z) des widgets.

La mise en page flexible prend en charge des fonctionnalités telles que le redimensionnement individuel des widgets, l'optimisation des widgets, etc.

La hauteur de chaque widget est mesurée en pixels. 1 unité de hauteur = 40 pixels. La largeur du widget dépend du nombre de colonnes du conteneur et du nombre de colonnes qui changent en fonction de la largeur du conteneur.

Les widgets s'affichent de gauche à droite. Le moteur de mise en page avancé utilise une logique personnalisée pour ajuster l'espace horizontal et vertical des widgets. Au départ, la mise en page se charge horizontalement. Après le chargement horizontal, le widget se charge verticalement et garantit une utilisation optimale de l'espace.

Configurez les widgets en fonction de la taille de l'écran. Vous pouvez augmenter ou diminuer la largeur des widgets, en fonction de la taille de l'écran. Cela rend les widgets plus lisibles et plus faciles à utiliser.

La mise en page flexible propose des points d'arrêt standard tels que grand, moyen, petit et très petit.

  • Les gros widgets ont une résolution de 1360 pixels ou plus. Pour les widgets de grande taille, indiquez la valeur de la colonne comme 12.

  • Les widgets Medium ont une résolution de 1 070 à 1 360 pixels. Pour les widgets de taille moyenne, indiquez la valeur de la colonne comme 10.

  • Les petits widgets ont une résolution de 850 à 1 070 pixels. Pour les petits widgets, indiquez la valeur de colonne comme 6.

  • Les très petits widgets ont une résolution de 500 pixels. Pour les très petits widgets, indiquez la valeur de la colonne comme 4.

Ces pixels peuvent varier en fonction du système d'exploitation et du navigateur.

"page": {
          "id": "landing",
          "useFlexLayout": true,
          "widgets": {
            "comp1": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 1",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px; color: white;"
              }
            },
            "comp2": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 2",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px;color: white;"
              }
            }
          }

page > comp

Assurez-vous de fournir un composant personnalisé unique.

"comp": "page-title",

Le composant page-title représente le titre de niveau 2 <h2>de l'élément HTML personnalisé.

page > PageHeader

Veillez à spécifier une chaîne de titre qui peut être statique, dynamique ou les deux.

Le composant page-title représente le titre de niveau 2 de <h2>l'élément HTML personnalisé.

  • Chaîne statique : Par exemple, Hey, Welcome !

    "comp": "page-title",
    "attributes": {
        "pageTitle": "Hey, Welcome!"
    }
  • Chaîne dynamique : pour récupérer la valeur depuis le STORE. Jane Doe, par exemple.

    "comp": "page-title",
    "attributes": {
        "pageTitle": "$STORE.agent.agentName"
    }

  • Les deux : la combinaison de cordes statiques et dynamiques. Par exemple, Hey Jane Doe, Welcome !

    "comp": "page-title",
    "attributes": {
        "pageTitle": "Hey {$STORE.agent.agentName}, Welcome!"
    }

    Vous devez placer la partie dynamique de la chaîne entre crochets fermés {} et le préfixer avec la structure $.

page > Sous-en-tête de la page

Veillez à ajouter un sous-en-tête qui s'affiche sur le bureau. L'utilisateur peut ajouter Go to Analyzer dans le sous-en-tête.

  • Bloc de code pour Sub Header

    "useFlexLayout": true,
              "pageSubHeader": {
                "comp": "div",
                "attributes": {
                  "style": "display: flex; float:right;margin:16px 0px 16px 16px"
                },
                "children": [
                  {
                    "comp": "div",
                    "children": [
                      {
                        "comp": "md-label",
                        "textContent": "$I18N.pageSubHeader.queueName",
                        "attributes": {
                          "style": "margin-bottom:8px;"
                        }
  • Bloc de code pour accéder à l'analyseur dans le sous-en-tête

    {
                    "comp": "div",
                    "children": [
                      {
                        "comp": "agentx-more-actions-wrapper",
                        "properties": {
                          "actionList": [
                            {
                              "comp": "agentx-wc-goto-analyzer"
                            }
                          ]
                        }
                      }

Navigation (pages personnalisées)

Dans cette section, vous pouvez ajouter des pages qui apparaissent dans la barre de navigation de gauche. Vous indiquez une icône de navigation et une URL unique pour que le widget apparaisse dans la barre de navigation. Nous vous recommandons d'utiliser un préfixe spécifique pour l'URL afin d'éviter les conflits. Pour plus de détails, consultez la section Propriétés de navigation.

Vous pouvez également avoir une collection de widgets qui peuvent être affichés sur cette page. La page peut contenir un seul widget qui apparaît à l'écran ou une collection de widgets dans une grille. Pour plus de détails sur la disposition des grilles, consultez la section des propriétés de mise en page.

Vous n'avez pas besoin d'ajouter de zone dynamique à l'arborescence des widgets. Cela signifie que vous pouvez glisser-déposer et redimensionner les widgets sur les pages personnalisées lorsque vous activez cette option.

Exemple :

{
    "nav": {
        "label": “Custom Page”,
        "icon": "stored-info",
        "iconType": "momentumDesign",
        "navigateTo": "dynamic-tabs",
        "align": "top",
        "isDefaultLandingPage": true
             },    
    "page": {
        "id": “my - custom - page“,
        "useFlexLayout": true,
        "widgets": {
            “
            comp1”: {
                "comp": "md-tabs",
                "children": [{
                        "comp": "md-tab",
                        "textContent": "Shift Timer",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel"
                        },
                        "children": [{
                            "comp": “my - custom - timer”,
                            “source”: http: //my-cdn.com/my-custom-timer.js
                                "wrapper": {
                                    "title": "Shift Timer",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                        }]
                    },
                    {
                        "comp": "md-tab",
                        "textContent": "Stock Market",
                        "responsive": "false"
                        "attributes": {
                            "slot": "tab"
                        },
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel"
                        },
                        "children": [{
                            "comp": "agentx-wc-iframe",
                            "responsive": "false"
                            "attributes": {
                                "src": "https://widget-kad.s3.amazonaws.com/Trading.htm"
                            },
                            "wrapper": {
                                "title": "Stock Market",
                                "maximizeAreaName": "app-maximize-area"
                            }
                        }],
                    },
                    {
                        "comp": "md-tab",
                        "textContent": "Widget3",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "textContent": "Three Content",
                        "attributes": {
                            "slot": "panel"
                        }
                    }
                ]
            },
            “comp2”: {
                "comp": “my - google - maps - component“,
                “source”: "https://my-cdn.com/my-google.maps.js
                "wrapper": {
                    "title": "Google Map",
                    "maximizeAreaName": "app-maximize-area"
                }
            }
        },
        "layout": {
            "areas": [
                ["left", "right"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        }
    }
},

Le tableau suivant décrit les propriétés de navigation et de page ainsi que leurs propriétés secondaires :

Tableau 3. nav Informations sur la propriété

Immobilier

Description et code

navigation > étiquette

Cette propriété indique l'identifiant de navigation de la page. Le lecteur d'écran lit cette propriété et elle apparaît dans l'infobulle.

Ces paramètres sont nécessaires pour afficher votre page personnalisée dans la barre de navigation.

type Navigation.Item = {
    label: string;
    iconType: "momentumDesign" | "other";
    icon: string;
    align: "top" | "bottom";
    navigateTo: string;
    iconSize ? : number;
    isResponsive ? : boolean;
};

La propriété label est le titre de la page personnalisée.

nav > IconType

Cette propriété représente le type d'icône qui s'affiche dans la barre de navigation de la page personnalisée.

Les types d'icônes suivants sont disponibles :

  • MomentumDesign : Vous pouvez choisir toutes les icônes disponibles dans la collection : https://momentum-design.github.io/momentum-design/en/tokens/icons/. L'avantage d' utiliser Momentum, c'est qu'il propose quelques icônes avec une version « active ».

    Cas d'utilisation d'une version active :

    Par exemple, si vous choisissez une annonce de type icône Momentum, vous pouvez voir l'icône par défaut dans la barre de navigation. Lorsque vous accédez à la page personnalisée (liée à l'icône), celle-ci passe automatiquement à la version active pour l'annonce. Assurez-vous de vérifier si une version active de cette même icône figure dans la bibliothèque d'icônes.

  • Autre : Vous pouvez fournir une URL d'image personnalisée (hébergée sur un CDN) qui apparaîtra dans la barre de navigation. Si vous utilisez une icône personnalisée noire ou blanche, elle n'est pas visible lorsque vous passez du mode clair au mode foncé.

navigation > icône

Cette propriété représente le nom de l'icône dans la bibliothèque Momentum ou l'URL du CDN.

type Navigation.Item ={
   icon:“announcement”;
}; 
// OR //
type Navigation.Item ={
   icon:“https://my-cdn.com
   /my-navigation-icon.png”;
};

navigation > aligner

Cette propriété vous permet d'aligner l'icône en haut ou en bas de la barre de navigation.

Actuellement, la propriété n'autorise que l'alignement par le haut.

nav > IsDefaultLandingPage

Cette propriété indique la page d'accueil par défaut pour les agentsAgent Desktop. Définissez cette propriété sur true pour faire de la page de la barre de navigation la page de destination par défaut qui s'affiche pour les agents une fois connectés auAgent Desktop. Si cette propriété est définie sur true sur plusieurs pages de la barre de navigation, le système considère que la première page de la barre de navigation est la page de destination par défaut.

Si aucune page de la barre de navigation n'a cette propriété définie sur true, la page d'accueil fait office de page de destination par défaut.

Vous ne pouvez pas définir les rapports Analyzer and Agent Performance Statistics comme page d'accueil par défaut.

nav > NavigateTo

Cette propriété indique le nom de la page personnalisée. Ce nom apparaît dans la barre d'adresse lorsque l'agent navigue.

Le NavigateTo ne doit pas inclure les valeurs suivantes : images, fonts, css, build_info, help, app, i18n, icons, images-mfe-wc et sons.

type Navigation.Item = {
    navigateTo: “my - custom - page”;
};
Tableau 4. page Détails de la propriété

Immobilier

Description et code

page > identifiant

Dans les propriétés de la page, vous spécifiez l'objet de la page personnalisée (widget dynamique).

La propriété id représente un identifiant de page unique. Par exemple, my-custom-page-1. L'agent ne voit pas cet identifiant sur le bureau.

type DynamicWidgets.Page = {
    id: string;
    widgets: Record < string,
    DynamicWidget.Options > ;
    layout: Layout;
};

page > UseFlexLayout

Flex Layout est un nouveau composant Web. Cela ne modifie pas les widgets existants. La nouvelle mise en page flexible utilise le même format de configuration de manière simplifiée. Il est rétrocompatible et n'a aucun impact sur les widgets existants. Vous devez configurer la mise en page JSON. Pour configurer la mise en page JSON, indiquez la hauteur et la largeur du widget. Le widget est affiché dans l'ordre dans lequel il est configuré dans la mise en page JSON. Les widgets ont une marge par défaut de 8 pixels.

La mise en page JSON est basée sur les dimensions (largeur x hauteur) et les coordonnées (X, Y et Z) des widgets.

La mise en page flexible prend en charge des fonctionnalités telles que le redimensionnement individuel des widgets, l'optimisation des widgets, etc.

La hauteur de chaque widget est mesurée en pixels. 1 unité de hauteur = 40 pixels. La largeur du widget dépend du nombre de colonnes du conteneur et du nombre de colonnes qui changent en fonction de la largeur du conteneur.

Les widgets s'affichent de gauche à droite. Le moteur de mise en page avancé utilise une logique personnalisée pour ajuster l'espace horizontal et vertical des widgets. Au départ, la mise en page se charge horizontalement. Après le chargement horizontal, le widget se charge verticalement et garantit une utilisation optimale de l'espace.

Configurez les widgets en fonction de la taille de l'écran. Vous pouvez augmenter ou diminuer la largeur des widgets, en fonction de la taille de l'écran. Cela rend les widgets plus lisibles et plus faciles à utiliser.

La mise en page flexible propose des points d'arrêt standard tels que grand, moyen, petit et très petit.

  • Les gros widgets ont une résolution de 1360 pixels ou plus. Pour les widgets de grande taille, indiquez la valeur de la colonne comme 12.

  • Les widgets Medium ont une résolution de 1 070 à 1 360 pixels. Pour les widgets de taille moyenne, indiquez la valeur de la colonne comme 10.

  • Les petits widgets ont une résolution de 850 à 1 070 pixels. Pour les petits widgets, indiquez la valeur de colonne comme 6.

  • Les très petits widgets ont une résolution de 500 pixels. Pour les très petits widgets, indiquez la valeur de la colonne comme 4.

Ces pixels peuvent varier en fonction du système d'exploitation et du navigateur.

"page": {
          "id": "landing",
          "useFlexLayout": true,
          "widgets": {
            "comp1": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 1",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px; color: white;"
              }
            },
            "comp2": {
              "comp": "div",
              "width": 4,
              "height": 4,
              "textContent": "Widget 2",
              "attributes": {
                "style": "width: max-content; margin: 80px 240px;color: white;"
              }
            }
          }

page > widgets

page > comp

Vous aide à définir vos widgets personnalisés. Pour placer plusieurs widgets, spécifiez les options des widgets dans l'ordre. Assurez-vous de donner un nom de zone unique à chaque widget. Utilisez-le dans la section mise en page plus tard.

"widgets": {
    "comp1": {
        ...
    }
    "comp2": {
        ...
    }
}

Cette propriété représente le nom de l'élément HTML personnalisé (appelé composant Web ou tout autre élément, si vous souhaitez l'utiliser comme enveloppe). Pour plus d'informations, voir Exemples de cas d'utilisation. Entrez le nom de votre élément personnalisé ici, sans crochets angulaires (« < » or « > »). Par exemple, « mon élément personnalisé ».

Chaque entrée de la section des widgets prend en charge le format suivant :

type Options = {
    comp: string;
    script ? : string;
    properties ? : Record < string,
    any > ;
    attributes ? : Record < string,
    string > ;
    children ? : Options[];
    textContent ? : string;
    style ? : Partial < CSSStyleDeclaration > ;
    wrapper ? : {
        title: string;
        maximizeAreaName: string;
    };
};

page > script

(Facultatif) Cette propriété n'est requise que lorsque vous chargez le widget ou le composant depuis un emplacement distant, tel qu'un CDN.

"comp1": {
    "comp": "widget-one",
    "script": "http:/my-cdn.com /
        dynamic - widgets / widget - one.js ",
}

Ne modifiez pas l'URL du script pour le même composant. Si vous devez modifier l'URL du script pour le même composant, procédez comme suit :

  • Demandez à l'agent de vider le cache du navigateur et de le Agent Desktop recharger.

  • Conservez l'URL existante. Importez dynamiquement la nouvelle URL du bundle en utilisant le code JavaScript hébergé dans l'URL existante.

    Exemple :

    (function() {
              var script = document.createElement("script");
                  script.src = <Your JS Script URL>
                  script.type = "text/javascript";
                  script.async = true;
                  document.getElementsByTagName ("head").item(0).appendchild(script);
    
                } ) ()

page > propriétés

Vous pouvez spécifier les propriétés que vous devez transmettre pour le composant Web.

"properties": {
    "user": "admin",
},

page > responsive

Détermine si un composant Web ou un widget basé sur un iFrame ajouté dans la mise en page personnalisée au niveau de la page ou de la maquette est réactif. Les composants Web réactifs rendent votre page Web visuellement attrayante sur tous les appareils et sont faciles à utiliser. Vous devez utiliser des widgets iFrame réactifs.

Configurez cette propriété avec l'une des valeurs suivantes :

  • C'est vrai : active la réactivité du widget. Par défaut, tous les widgets sont réactifs en fonction de la taille de l'écran, de l'orientation et des zones de visualisation progressives de l'appareil utilisé.

  • Faux : désactive la réactivité du widget. Si les widgets ne sont pas disponibles sur d'autres appareils, marquez-les comme ne répondant pas.

{
    "comp": "md-tab",
    "responsive": true,
    "attributes": {
        "slot": "tab",
        "class": "widget-pane-tab"
    },
    "children": [{
        "comp": "slot",
        "attributes": {
            "name": "SCREEN_POP_TAB"
        }
    }],
    "visibility": "SCREEN_POP"
}, {
    "comp": "md-tab-panel",
    "responsive": false,
    "attributes": {
        "slot": "panel",
        "class": "widget-pane"
    },
    "children": [{
        "comp": "slot",
        "attributes": {
            "name": "CALL_GUIDE"
        }
    }],
    "visibility": "CALL_GUIDE"
},

Les widgets qui ne répondent pas ne peuvent garantir la meilleure expérience utilisateur et ne s'affichent pas dans une vue plus petite. L'agent doit agrandir la fenêtre du navigateur pour voir tous les widgets configurés comme ne répondant pas.

page > attributs

Vous pouvez spécifier les attributs des composants Web dans cette section.

"attributes": {
         "disabled": "false",
},

page > visibilité

Spécifie si les widgets proposés par Cisco et ajoutés dans la mise en page personnalisée au niveau de la page ou au niveau de la composition sont visibles ou non.

Les widgets proposés par Cisco sont l'historique des contacts, la transcription du SVICisco Webex Experience Management, le guide des appels de la campagne de prévisualisation et Screen Pop.

  • Les valeurs des propriétés de visibilité sont intégrées et définies dans le fichier JSON par défaut du Desktop Layout. L'administrateur ne peut pas modifier les valeurs des propriétés de visibilité des widgets proposés par Cisco.

  • La valeur de la propriété de visibilité NOT_RESPONSIVE est obsolète. Vous pouvez continuer à l'utiliser uniquement pour des raisons de rétrocompatibilité. Aucune valeur définie comme NOT_RESPONSIVE précédemment ne nécessite aucune modification, car les fonctionnalités restent les mêmes.

    Pour définir un widget nouvellement créé comme réactif ou non réactif, vous devez utiliser la propriété responsive. Pour plus d'informations, voir Responsive Property.

page > enfants

Cette propriété est au cœur de l'aménagement. Dans la section pour enfants, vous pouvez imbriquer autant de niveaux que nécessaire si le widget basé sur les composants Web vous permet de réussir. Pour que cela soit possible, le développeur doit gérer le contenu des emplacements par programmation. Pour plus d'informations, consultez le Cisco Webex Contact CenterDesktop Developer Guide.

Pour en savoir plus sur la transmission des valeurs STORE en tant que propriétés, voir Partager des données depuis un ordinateur vers des widgets.

"children": [{
        "comp": "div",
        "textContent": "Test"
    },
    {
        "comp": "div",
        "textContent": “Test”
    },
    {
        "comp": "div",
        "textContent": "Test"
    },
    {
        "comp": "div",
        "textContent": "Test"
    },
    {
        "comp": "div",
        "children": [{
                "comp": "div",
                "textContent": “Test”
            },
            {
                "comp": "div",
                "textContent": "Test"
            },
            {
                "comp": "div",
                "textContent": "Test"
            }
        ]
    }
],

L'avantage de la section « pour enfants » est que vous pouvez utiliser des composants Web existants dans votre spécification de mise en page, qui fait déjà partie du pack Desktop. Voici quelques-uns des composants Web de l'offre Desktop Bundle :

  • agentx-wc-iframe : Un widget qui vous permet de placer n'importe quelle page Web dans un iFrame en tant que widget.

  • zone dynamique : un composant qui vous permet d'activer la fonction glisser-déposer pour les agents ailleurs que sur des pages personnalisées. Les pages personnalisées peuvent également avoir cette fonctionnalité si vous activez le glisser-déposer par défaut.

  • N'importe quel composant de la bibliothèque momentum-ui-web-component. Pour plus d'informations, consultez GitHub. Par exemple :

    • md-tabs : emballage de conteneurs à onglets

    • md-tab : en-tête à onglet unique

    • md-tab-panel : contenu à onglet unique

Pour plus d'informations sur les attributs de l'onglet persistant, voir Attributs des onglets persistants.

page > Contenu du texte

Vous aide à ajouter du contenu textuel.

"textContent": "My Text Content",

page > style

Vous aide à attribuer un style CSS particulier à votre composant.

"style": {
    "backgroundColor": "#CBD",
    "overflow": "scroll"
},

page > emballage

Le Widget Wrapper vous permet d'ajouter une barre d'outils en haut de votre widget. La barre d'outils peut contenir un titre et l'icône Maximiser l'icône (Agrandir) en haut du widget. Lorsque le widget occupe une petite place sur la page, l'icône d'agrandissement permet à l'agent de voir le widget dans son espace de travail complet.

Assurez-vous d'utiliser la valeur par défaut « app-maximize-area ». Actuellement, seule la valeur par défaut est disponible. Si la mise en page est configurée à l'aide de UseFlexLayout, vous pouvez activer l'icône de maximisation/restauration dans l'en-tête du widget en ajoutant l'attribut IsMaximizable à la configuration du widget et en lui donnant la valeur true.

"wrapper": {
    "title": My Widget Title ",
    "maximizeAreaName": "app-maximize-area" "isMaximizable":true 
}

page > emballage > identifiant

(Facultatif) L'enveloppe du composant Web vous permet de mettre à jour le titre du widget dynamique à l'aide d'un identifiant unique. Entrez la valeur de propriété de l'identifiant du wrapper du widget sous la forme unique-id-to-update-title.

"wrapper": {
    "title": My Widget Title ",
    "id": "unique-id-to-update-title",
    "maximizeAreaName": "app-maximize-area"
}

Assurez-vous d'utiliser le même identifiant unique pour le CustomEvent JavaScript. Pour plus d'informations, consultez la section Événements asynchrones du chapitre consacré au module de contact des agents du Cisco Webex Contact CenterDesktop Developer.

Pour mettre à jour le titre du widget basé sur l'iFrame, utilisez le contenu de l'iFrame du même domaine. Voici un exemple :

<
script type = "text/javascript" >
    var title = "";
window.addEventListener("update-title-event", function(e) {
    title = e.detail.title;
});
document.querySelector('#customEvent').onclick = function() {
    const e = new CustomEvent("update-title-event", {
        bubbles: true,
        detail: {
            title: "new title"
        }
    });
    window.parent.dispatchEvent(e);
}; <
/script> <
button id = "customEvent" > New Title < /button> <
    iframe src = "https://blog.logrocket.com/the-ultimate-guide-to-iframes/" > < /iframe>

page > agentx-wc-iframe

Vous permet d'intégrer une page Web dans un iFrame qui apparaît sous forme de widget sur le bureau. Vous pouvez utiliser le widget iFrame appelé « agentx-wc-iframe ».

"comp1": {
    "comp": "agentx-wc-iframe",
    "attributes": {
        "src": "https://blog.logrocket.com /
            the - ultimate - guide - to - iframes / "
    },
    "wrapper": {
        "title": "AgentX iFrame",
        "maximizeAreaName": "app-maximize-area"
    }
},

page > mise en page

Vous permet d'organiser les widgets sur une page.

Le format suivant représente une disposition en grille :

type Layout = {
    areas: string[][];
    size: {
        rows: number[];
        cols: number[];
    };
};

Ici, vous pouvez définir la grille avec les noms des zones que vous avez définis dans la section des widgets.

L'exemple suivant montre comment la disposition en trois lignes et trois colonnes est spécifiée :

"layout": {
    "areas": [
        [
            "comp1",
            "comp1",
            "comp3"
        ],
        [
            "comp2",
            "comp2",
            "comp3"
        ],
        [
            "comp4",
            "comp4",
            "comp4"
        ]
    ],
    "size": {
        "cols": [1, 1, 1],
        "rows": [1, 1, 1]
    }
}
Distribution égale d'un plan 3 x 3
Equal distribution of a 3x3 layout for Webex contact Center Desktop layout configuration.

Dans la section des tailles, les chiffres représentent la fraction d'espace qu'un widget peut occuper par rapport aux autres widgets. Les trois colonnes occupent la même fraction d'espace. Avec 100 % de largeur disponible, chaque widget occupe 33,33 % de l'espace horizontal.

Avec une largeur de colonne égale
Equal column width layout for Webex Contact Center Desktop layout configuration.

Autre exemple d'utilisation, si vous définissez « cols » : [1, 2, 2], cela signifie que l'espace global est divisé par 5 (1+2+2) et que le premier widget occupe 20 % de l'espace horizontal. Les deuxième et troisième widgets prennent 40 % chacun. Pour plus d'informations, voir Concepts de base de la mise en page en grille.

Unequal column width layout for Webex Contact Center Desktop layout configuration.
Après avoir modifié la largeur des colonnes

page > ROOT

L'imbrication des mises en page s'appelle une sous-mise en page. Si vous avez des mises en page imbriquées dans votre configuration de mise en page, vous devez avoir un seul objet « ROOT » comme parent pour les sous-mises en page. Sinon, votre configuration de mise en page peut être plate si aucune imbrication n'est requise.

Cette sous-mise en page permet de mieux contrôler le comportement de redimensionnement de la mise en page. La propriété de mise en page doit être de type Record<string, Layout>. La propriété de mise en page vous permet de disposer les widgets sur une page.

{
    "id": "some-id",
    "widgets": {
        "c1": {
            "comp": "div",
            "textContent": "c1"
        },
        "c2": {
            "comp": "div",
            "textContent": "c2"
        },
        "c3": {
            "comp": "div",
            "textContent": "c3"
        },
        "c4": {
            "comp": "div",
            "textContent": "c4"
        },
        "c5": {
            "comp": "div",
            "textContent": "c5"
        }
    },
    "layout": {
        "ROOT": {
            "areas": [
                ["c1", "sub1"],
                ["c2", "sub2"],
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1, 1]
            }
        },
        "sub1": {
            "areas": [
                ["c3", "c4"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        },
        "sub2": {
            "areas": [
                ["c1"],
                ["c5"]
            ],
            "size": {
                "cols": [1],
                "rows": [1, 1]
            }
        }
    }
}

Cette configuration crée une grille au format ROOT avec deux sous-grilles que vous pouvez redimensionner indépendamment.

Sub-layout appearance for Webex Contact Center Desktop layout configuration.
Apparence des sous-mises en page

Le redimensionnement d'un composant affecte les composants de ce sous-modèle.

Sub-layout appearance, after resizing both sub-layouts, for Webex Contact Center Desktop layout configuration.
Après avoir redimensionné les deux sous-mises en page

Soyez au courant des cas suivants :

Boucle infinie : si vous incluez la mise en page ROOT dans la sous-mise en page de ROOT, cela provoque une erreur « pile d'appels dépassée » et crée une boucle infinie.

{
    "layout": {
        "ROOT": {
            "areas": [
                ["c1", "c2"],
                ["c3", "ROOT"],
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1, 1]
            }
        }
    }
Sub-layout appearance with infinite loop for Webex Contact Center Desktop layout configuration.
Sous-mise en page avec boucle infinie

Même sous-mise en page (N) fois : si vous incluez la sous-mise en page dans votre grille plusieurs fois avec le même nom, et si vous redimensionnez l'une d'entre elles, toutes les sous-mises en page seront redimensionnées automatiquement.

Si ce n'est pas le comportement souhaité, renommez chacune des sous-mises en page avec un nom unique.

{
    "layout": {
        "ROOT": {
            "areas": [
                ["c1", "sub1"],
                ["c2", "sub1"],
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1, 1]
            }
        },
        "sub1": {
            "areas": [
                ["c3", "c4"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        }
    }
}
Sub-layout appearance with N times for Webex Contact Center Desktop layout configuration.
Sous-mise en page avec N fois

Attributs des onglets persistants

Pour que les onglets des pages personnalisées et des widgets personnalisés soient permanents, saisissez les attributs de md-tabs dans la mise en page personnalisée.

Exemple : définir les onglets comme persistants

{
    "comp": "md-tabs",
    "attributes": {
        "persist-selection": true,
        "tabs-id": "unique-id for all the tabs together in the container"
    },
}

Immobilier

Description

sélection persistante

Pour configurer md-tabs pour qu'il soit persistant. La valeur par défaut est True.

identifiant des onglets

Identification unique pour tous les onglets contenus dans le contenant.

Lorsque vous configurez md-tabs pour qu'il soit persistant (persist-selection : true), il Agent Desktop conserve la sélection des onglets même si un agent passe d'une page ou d'un widget à l'autre sur le bureau.

  • La propriété de sélection persistante ne s'applique pas aux onglets du volet Informations auxiliaires et de la page des rapports sur les statistiques de performance des agents, car le comportement des onglets persistants est déjà défini sur le bureau.
  • L'onglet sélectionné revient à l'onglet par défaut lorsque vous vous déconnectez du bureau, que vous rechargez ou actualisez le navigateur ou que vous effacez le cache du navigateur.

Configuration des widgets persistants

Vous pouvez configurer n'importe quel widget personnalisé pour qu'il soit permanent. Les widgets permanents s'affichent sur toutes les pages du bureau. Les widgets permanents s'affichent sous la forme d'un nouvel onglet dans le volet Informations auxiliaires uniquement lorsque vous avez une demande de contact ou une conversation active. Par exemple, le widget Sample Persistent.

Les widgets permanents ne s'affichent pas sur la page d'accueil de la même manière que sur les autres pages. Toutefois, si vous interagissez activement, les widgets permanents s'affichent sur la page d'accueil dans le volet Informations auxiliaires. Par exemple, lorsque vous avez répondu à un appel, le panneau de contrôle des interactions s'affiche et le widget Sample Persistent s'affiche dans le volet Informations auxiliaires.

Exemple :

"area": {
    "persistent": [{
            "comp": "md-tab",
            "attributes": {
                "slot": "tab"
            },
            "children": [{
                    "comp": "md-icon",
                    "attributes": {
                        "name": "emoticons_16"
                    }
                },
                {
                    "comp": "span",
                    "textContent": "Custom Page Widget"
                }
            ]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel"
            },
            "children": [{
                "comp": "dynamic-area",
                "properties": {
                    "area": {
                        "id": "dw-panel-two",
                        "widgets": {
                            "comp1": {
                                "comp": "agentx-wc-iframe",
                                "attributes": {
                                    "src": "https://blog.logrocket.com/the-ultimate-guide-to-iframes/"
                                },
                                "wrapper": {
                                    "title": "AgentX iFrame",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            },
                            "comp2": {
                                "comp": "uuip-widget-two",
                                "script": "./dynamic-widgets/widget-two.js",
                                "attributes": {
                                    "title": "WIDGET 2 content"
                                },
                                "wrapper": {
                                    "title": "Widget 2 title",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            }
                        },
                        "layout": {
                            "areas": [
                                ["comp1", "comp2"]
                            ],
                            "size": {
                                "cols": [1, 1],
                                "rows": [1]
                            }
                        }
                    }
                }
            }]
        }
    ]
}

Lorsque vous personnalisez un widget, vous pouvez choisir l'une des options suivantes :

  • Hébergez une application sur une page Web qui peut être intégrée à un iframe.

  • Créez un widget personnalisé.

Les exigences techniques requises pour les widgets sont décrites dans la documentation sur le développement des widgets de bureau. En tant qu'éditeur de mise en page, assurez-vous de disposer des informations suivantes :

  • Quel est le nom de l'élément HTML personnalisé (appelé composant Web) ?

  • Quelle est l'URL de la source du réseau de diffusion de contenu (CDN) qui héberge le bundle JavaScript ?

Widgets d'en-tête

L'en-tête est utilisé pour afficher des informations en ligne, pour ajouter des menus déroulants, etc. Comme l'espace vertical du conteneur d'en-tête est limité, la hauteur totale de l'en-tête n'est que de 64 pixels. Pour plus d'informations sur l'alignement de la mise en page, consultez la section des propriétés de la mise en page.

Exemple :

"header":{
   "id":"header",
   "widgets":{
      "head1":{
         "comp":"header-widget-one",
         "script":"https://my-cdn.com/dynamic-widgets/header-widget-one.js",
      },
      "head2":{
         "comp":"header-widget-two",
         "script":"https://my-cdn.com/dynamic-widgets/header-widget-two.js",
      }
   },
   "layout":{
      "areas":[[ "head1", "head2" ]], 
      "size": { "cols": [1, 1], "rows": [1] } 
      } 
}

Pour ajouter une info-bulle à un widget d'en-tête, insérez md-tooltip sur le composant. Entrez les informations de l'info-bulle dans la propriété du message.

Exemple :

"header": {
    "id": "dw-header",
    "widgets": {
        "head1": {
            "comp": "md-tooltip",
            "attributes": {
                "message": "Netlify"
            },
            "children": [{
                "comp": "agentx-wc-iframe",
                "attributes": {
                    "src": "https://keen-jackson-8d352f.netlify.app"
                }
            }]
        },

    },
}

Vous devez ajouter les attributs de style, d'affichage et de hauteur pour configurer tous les widgets via iFrame, dans la zone des widgets personnalisables de l'en-tête. La meilleure valeur d'ajustement de l'attribut de hauteur est de 64 pixels.

Assurez-vous d'ajouter les attributs de style aux widgets d'en-tête existants pour qu'ils se chargent comme prévu dans l'iFrame.

Exemple :

"head1": {
    "comp": "agentx-wc-iframe",
    "attributes": {
        "src": "https://widget-kad.s3.amazonaws.com/Headers/Timer/Timer.htm",
        "style": "height:64px;display:flex;"
    }


},

Nous vous recommandons de n'utiliser qu'une seule ligne avec plusieurs colonnes pour l'en-tête, car la hauteur de l'en-tête n'est que de 64 pixels. Pour plus d'informations sur l'alignement, consultez la section des propriétés de mise en page.

Volet d'information auxiliaire

Le volet Informations auxiliaires du bureau affiche les onglets qui incluent les widgets (par défaut) proposés par Cisco et les widgets personnalisés. Les widgets suivants proposés par Cisco apparaissent dans les onglets prédéfinis :

  • Historique des contacts

  • Transcription IVR

  • Parcours de l'expérience client

  • Screen Pop

Vous pouvez utiliser le volet Informations auxiliaires pour :

  • Ajouter des onglets

  • Modifier l'ordre de tabulation

  • Supprimer les onglets prédéfinis

  • Marquer les onglets personnalisés comme déplaçables

  • Ajouter des info-bulles aux onglets personnalisés

  • Ajouter l'option Réinitialiser l'ordre des onglets

Exemple :

"panel": {
    "comp": "md-tabs",
    "attributes": {
        "class": "widget-tabs"
    },
    "children": [{
            "comp": "md-tab",
            "attributes": {
                "slot": "tab",
                "class": "widget-pane-tab"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY_TAB"
                }
            }]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel",
                "class": "widget-pane"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY"
                }
            }]
        },
        {
            "comp": "md-tab",
            "attributes": {
                "slot": "tab",
                "class": "widget-pane-tab"
            },
            "children": [{
                    "comp": "md-icon",
                    "attributes": {
                        "name": "pop-out_16"
                    }
                },
                {
                    "comp": "span",
                    "textContent": "Screen Pop"
                }
            ],
            "visibility": "SCREEN_POP"
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel",
                "class": "widget-pane"
            },
            "children": [{
                "comp": "#SCREEN_POP"
            }],
        },
        {
            "comp": "md-tab",
            "attributes": {
                "slot": "tab"
            },
            "children": [{
                    "comp": "md-icon",
                    "attributes": {
                        "name": "emoticons_16"
                    }
                },
                {
                    "comp": "span",
                    "textContent": "Custom Widget"
                }
            ]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel"
            },
            "children": [{
                "comp": "dynamic-area",
                "properties": {
                    "area": {
                        "id": "dw-panel-two",
                        "widgets": {
                            "comp1": {
                                "comp": "agentx-wc-iframe",
                                "attributes": {
                                    "src": "https://blog.logrocket.com/the-ultimate-guide-to-iframes/"
                                },
                                "wrapper": {
                                    "title": "AgentX iFrame",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            },
                            "comp2": {
                                "comp": "widget-one",
                                "script": "https://my-cdn.com/dynamic-widgets/widget-one.js",
                                "wrapper": {
                                    "title": "Widget title",
                                    "maximizeAreaName": "app-maximize-area"
                                }
                            }
                        },
                        "layout": {
                            "areas": [
                                ["comp1"],
                                ["comp2"]
                            ],
                            "size": {
                                "cols": [1],
                                "rows": [1, 1]
                            }
                        }
                    }
                }
            }]
        }
    ]
},

Vous pouvez configurer le widget Customer Experience Journey après avoir activé les mesures de gestion de l'expérience client sur leManagement Portal.

Dans le volet Informations auxiliaires, ajoutez de nouveaux onglets pour placer vos widgets personnalisés. Aucune règle particulière ne s'applique ici et l'imbrication des composants se déroule comme prévu et décrit dans la section pour enfants. Pour plus d'informations, consultez la rubrique Enfants de la page.

Voici les exemples spécifiques pour personnaliser les en-têtes de vos onglets :

Exemple pour placer des icônes et des étiquettes dans la propriété pour enfants

{
    "comp": "md-tab",
    "attributes": {
        "slot": "tab",
        "class": "widget-pane-tab"
    },
    "children": [{
            "comp": "md-icon",
            "attributes": {
                "name": "transcript_16"
            }
        },
        {
            "comp": "span",
            "textContent": “My Widget Tab”
        }
    ],
},

Exemple pour placer une image (en CSS) et des libellés dans la propriété des enfants

{
    "comp": "md-tab",
    "attributes": {
        "slot": "tab"
    },
    "children": [{
        "comp": "span",
        "attributes": {
            "style": "align-items: center; display: flex;"
        },
        "children": [{
                "comp": "img",
                "attributes": {
                    "src": “http: //my-cdn.com/icon.svg”,
                        "width": 16,
                    "height": 16,
                    "style": "margin-right: 0.5rem;"
                }
            },
            {
                "comp": "span",
                "textContent": “My Widget Tab”
            }
        ]
    }],
},

La liste déroulante Plus d'onglets apparaît automatiquement lorsque le volet Informations auxiliaires contient plusieurs onglets.

Vous devez ajouter une info-bulle personnalisée pour plus de lisibilité et d'accessibilité. Pour ajouter une info-bulle à un onglet personnalisé, insérez md-tooltip sur le composant. Entrez les informations de l'info-bulle dans la propriété du message et appliquez les valeurs des propriétés de style, comme indiqué dans l'exemple suivant.

"comp": "md-tooltip",
"attributes": {
    "class": "widget-tabs",
    "message": "Sample Tab 1",
    "style": "max-width: 252px; min-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; display: inline-block; margin-bottom: -10px;"
},

Pour un onglet personnalisé, nous recommandons une largeur maximale de 252 pixels et une largeur minimale de 110 pixels.

Pour activer la fonction glisser-déposer dans l'onglet personnalisé, ajoutez la propriété suivante dans les attributs :

"comp": "md-tabs",
"attributes": {
    "class": "widget-tabs",
    "draggable": true,
    "comp-unique-id": "sample-dynamic-custom-tabs"
},
  • draggable : définissez la valeur de la propriété déplaçable sur true.

  • comp-unique-id : entrez une valeur unique pour identifier le composant.

    Exemple :

    "comp-unique-id": "sample-dynamic-custom-tabs"
    

Si vous activez le glisser-déposer pour un onglet personnalisé, l'agent peut faire glisser l'onglet vers la position requise dans le volet Informations auxiliaires. Pour rétablir l'ordre de tabulation par défaut des onglets, ajoutez la propriété suivante :

"comp": "agentx-wc-more-actions-widget",
"attributes": {
    "slot": "settings",
    "class": "widget-pane",
    "tabs-unique-id": "sample-dynamic-custom-tabs"
},
  • agentx-wc-more-actions-widget : Entrez le composant qui s'affiche sous forme d'icône Plus d'actions () dans le volet Informations auxiliaires. Icône Plus d'actions

  • slot="settings": Enter an attribute within the component that is displayed as the Reset Tab Order option in the More Actions drop-down list. Les agents peuvent rétablir l'ordre par défaut des onglets du volet Informations auxiliaires en cliquant sur Icône Plus d'actions > Réinitialiser l'ordre des onglets.

  • tabs-unique-id : entrez la même valeur unique que celle définie pour la propriété comp-unique-id afin de mapper et de réinitialiser les composants md-tabs.

L'exemple de code suivant utilise les fonctions Plus d'actions et Réinitialiser l'ordre des tabulations.

"comp": "agentx-wc-more-actions-widget",
"attributes": {
    "slot": "settings",
    "class": "widget-pane",
    "tabs-unique-id": "sample-dynamic-custom-tabs"
},
"children": [{
    "comp": "div",
    "attributes": {
        "textContent": "custom action",
        "slot": "custom-action"
    },
    "children": [{
            "comp": "agentx-wc-notes-header-widget"
        },
        {
            "comp": "agentx-wc-menu-notification"
        }
    ]
}],

}
Webex Contact Center more actions menu example, showing the 'Reset Tab Order' option.

Par défaut, l'info-bulle, l'icône en forme de point de suspension et la réinitialisation de l'ordre de tabulation pour les onglets prédéfinis sont définis.

La liste déroulante Plus d'actions peut être étendue pour ajouter des composants ou des widgets personnalisés après l'option Réinitialiser l'ordre des onglets. Voici un exemple de jeu de valeurs de propriétés de style qui peuvent être appliquées à des composants supplémentaires.

"comp": "md-tooltip",
"attributes": {
    "class": "widget-tabs",
    "message": "Sample Element",
    "style": "max-width: 252px; min-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; display: inline-block; margin-bottom: -10px;"
},
Webex Contact Center more actions menu example, showing additional, custom options that can be added after the 'Reset Tab Order' option.

La fonction glisser-déposer n'est pas prise en charge pour les composants ou widgets personnalisés supplémentaires ajoutés à la liste déroulante Plus d'actions.

Widgets sans tête

Dans la section headless, vous pouvez ajouter des widgets qui sont masqués et qui n'apparaissent pas sur leAgent Desktop. Ces widgets sont utilisés pour exécuter la logique en arrière-plan. Cette section est utile pour déclencher des événements qui se produisent sur le bureau et pour exécuter une logique spécifique au widget. Par exemple, ouvrir une fenêtre contextuelle CRM personnalisée pour recevoir un SMS à son arrivée.

Exemple :

"headless":{
   "id":"headless",
   "widgets":{
      "comp1":{
         "comp":"headless-widget-one",
         "script":"https://my-cdn.com/dynamic-widgets/headless-widget-one.js",
      },
      "comp2":{
         "comp":"headless-widget-two",
         "script":"https://my-cdn.com/dynamic-widgets/headless-widget-two.js",
      }
   },
   "layout":{
      "areas":[[ "comp1", comp2" ]], 
      "size": { "cols": [1, 1], "rows": [1] } 
      } 
}

Partager des données depuis votre ordinateur vers des widgets

Pour recevoir des données en temps réel via des propriétés ou des attributs d'un widget personnalisé, attribuez les valeurs STORE appropriées dans la configuration JSON de mise en page.

De plus, pour accéder aux données par le biais d'abonnés au SDK JavaScript, vous pouvez également les transmettre via des propriétés ou des attributs. Si votre composant est conçu pour réagir à des modifications de propriétés ou d'attributs, vous recevez des mises à jour de données en temps réel auprès de Agent Desktop ce que l'on appelle un fournisseur de données.

Actuellement, nous n'avons qu'un seul fournisseur de données dans un magasin de clés. Pour plus d'informations, consultez la section Data Provider—Widget Properties and Attributs du Cisco Webex Contact CenterDesktop Developer Guide.

Aperçu de la campagne

L'administrateur crée des campagnes, configure le mode de numérotation (aperçu) et attribue les campagnes aux équipes. Si un agent fait partie de l'équipe à laquelle des campagnes sont attribuées, il peut passer un appel sortant en avant-première de la campagne. Pour plus d'informations, voir Configuration des modes de campagnes vocales sortantes dans Webex Contact Center.

L'administrateur configure les éléments suivants dans la mise en page personnalisée pour permettre à un agent de prévisualiser le contact de la campagne.

Contact de la campagne

L'administrateur ajoute le widget Campaign Contact dans le conteneur d'en-tête de la mise en page personnalisée. Le contact de la campagne affiche les coordonnées du client en fonction des propriétés définies. Pour plus d'informations sur l'alignement de la mise en page, consultez la ligne de propriétés de mise en page du tableau des détails des propriétés de la page.

Exemple :


"advancedHeader": [
  {
    "comp": "agentx-preview-campaign",
    "properties": {
      "isCampaignManagementEnabled": "$STORE.agent.isCampaignManagementEnabled",
      "agentDbId": "$STORE.agent.acqueonAgentId",
      "lcmUrl": "$STORE.agent.lcmUrl",
      "isCallInProgress": "$STORE.agentContact.isActiveCall",
      "outdialEntryPointId": "$STORE.agent.outDialEp",
      "teamId": "$STORE.agent.getAcqueonTeamId",
      "campaignManagerAdditionalInfo": "$STORE.agent.campaignManagerAdditionalInfo",
      "orgId": "$STORE.agent.orgId",
      "dialerProxyHost": "$STORE.envVaribles.serviceUrls.dialerProxyHost",
      "isProgressiveCampaignEnabled": "$STORE.app.featuresFlags.isProgressiveCampaignEnabled"    }
  },
  {
    "comp": "agentx-webex"
  },
  {
    "comp": "agentx-outdial"
  },
  {
    "comp": "agentx-notification"
  },
  {
    "comp": "agentx-state-selector"
  }
] 

Guide des appels

Le widget Call Guide s'affiche dans le volet Informations auxiliaires du bureau. Le guide des appels affiche les questions et réponses au niveau de la campagne. L'agent est invitée à lire la série de questions du guide des appels et à soumettre les réponses.

Exemple :

"panel":{
   "comp":"md-tabs",
   "attributes":{
      "class":"widget-tabs"
   },
   "children":[
      {
         "comp":"md-tab",
         "attributes":{
            "slot":"tab",
            "class":"widget-pane-tab"
         },
         "children":[
            {
               "comp":"md-icon",
               "attributes":{ "name":"icon-note_16"
               }
            },
            {
               "comp":"span", "textContent":"Call Guide"
            }
         ],
         "visibility":"CALL_GUIDE"
      },
      {
         "comp":"md-tab-panel",
         "attributes":{
            "slot":"panel", "class":"widget-pane"
         },
         "children":[
            {
               "comp": "acqueon-call-guide",
               "script": "http://localhost:5555//index.js", // include CDN link here
               "wrapper":{
                  "title":"Call Guide", "maximizeAreaName":"app-maximize-area"
               },
               "properties":{
                  "lcmKey":"$STORE.agentContact.getCallGuideProps.LCMKey",
                  "agentDbId":"$STORE.agent.acqueonAgentId",
                  "lcmUrl":"$STORE.agent.lcmUrl",
                  "campaignManagerAdditionalInfo":"$STORE.agent.campaignManagerAdditionalInfo"
                  "orgId": "$STORE.agent.orgId",
                  "dialerProxyHost": "$STORE.envVaribles.serviceUrls.dialerProxyHost",
                  "isProgressiveCampaignEnabled": "$STORE.app.featureFlags.isProgressiveCampaignEnabled"
               }
            }
         ],
         "visibility":"CALL_GUIDE"
      }
   ]
}
  • Les références des propriétés comp suivantes ont changé. agentx dans la valeur de la propriété est remplacé par acqueon :
    • agentx-preview-campaign est renommé acqueon-preview-campaign
    • agentx-call-guide est renommé acqueon-call-guide
  • Vous devez héberger List and Campaign Manager (LCM) sur un CDN, puis spécifier l'URL dans la propriété du script.

Screen Pop

Dans la mise en page du bureau, vous pouvez configurer Screen Pop de l'une des manières suivantes :

  • En tant que page personnalisée

  • En tant que widget de la page personnalisée

  • Sous forme d'onglet dans le volet Informations auxiliaires

Le Screen Pop s'affiche sur le bureau en fonction des facteurs suivants :

Pour la chaîne Voice :

  • La configuration définie dans la mise en page du bureau

  • L'activité Screen Pop définie dans le Flow Designer

Pour les nouvelles chaînes numériques :

  • La configuration définie dans la mise en page du bureau

  • Le nœud Screen Pop défini dans le Connect Flow Builder

Pour plus d'informations sur la configuration de Screen Pop, voir Screen Pop.

Configuration de Screen Pop dans la barre de navigation

Vous pouvez configurer Screen Pop en tant que page personnalisée ou comme l'un des widgets d'une page personnalisée. Pour accéder à la page personnalisée Screen Pop, cliquez sur l'icône Screen Pop dans la barre de navigation. Pour accéder au widget Screen Pop sur la page personnalisée, cliquez sur l'icône personnalisée dans la barre de navigation. Pour plus d'informations sur les propriétés de navigation, voir Navigation (pages personnalisées).

Exemple : Screen Pop en tant que page personnalisée

{
    "nav": {
        "label": "Screen Pop",
        "icon": "pop-out",
        "iconType": "momentum",
        "navigateTo": "/screenpop",
        "align": "top"
    },
    "page": {
        "id": "agentx-wc-screen-pop",
        "widgets": {
            "comp1": {
                "comp": "agentx-wc-screen-pop",
                "properties": {
                    "screenPopUrl": "$STORE.session.screenpop.screenPopSelector"
                }
            }
        },
        "layout": {
            "areas": [
                ["comp1"]
            ],
            "size": {
                "cols": [1],
                "rows": [1]
            }
        }
    },
    "visibility": "SCREEN_POP"
}

Exemple : écran qui apparaît sous forme de widget sur la page personnalisée

"comp1": {
    "comp": "agentx-wc-screen-pop",
    "properties": {
        "screenPopUrl": "$STORE.session.screenpop.screenPopSelector"
    }

Si le Screen Pop n'est pas configuré dans le Flow Designer, la page personnalisée apparaît vide. Pour plus d'informations sur la configuration de Screen Pop dans le Flow Designer, voir Screen Pop.

Configuration de Screen Pop dans le volet d'informations auxiliaire

Vous pouvez configurer Screen Pop pour qu'il apparaisse sous forme d'onglet dans le volet Informations auxiliaires.

Par défaut, Screen Pop apparaît comme un nouveau sous-onglet dans l'onglet Screen Pop du volet Informations auxiliaires si Screen Pop est configuré pour être affiché en tant que Inside Desktop dans le Flow Designer.

Ajoutez l'attribut suivant dans la section du panneau pour inclure Screen Pop en tant qu'onglet dans le volet Informations auxiliaires. Pour plus d'informations sur les détails du panneau, voir Volet d'information auxiliaire.

Exemple : écran qui apparaît sous forme d'onglet dans le volet d'informations auxiliaires

 {
         "comp":"md-tab",
         "attributes":{
            "slot":"tab",
            "class":"widget-pane-tab"
         },
         "children":[
            { "comp": "md-icon", "attributes": { "name": "pop-out_16" }},
            { "comp": "span", "textContent": "Screen Pop" }], 
          "visibility": "SCREEN_POP" 
        }, 
        { 
          "comp": "md-tab-panel", 
          "attributes": { "slot": "panel", "class": "widget-pane" }, 
          "children": [{ "comp": "#SCREEN_POP"
            }
         ],
      }

L'option d'affichage Screen Pop définie dans le Flow Designer a priorité sur la configuration définie dans Desktop Layout.

Par exemple, supposons que vous avez configuré les paramètres Screen Pop suivants :

  • Flow Designer : affiche les paramètres tels qu'ils apparaissent dans le nouvel onglet du navigateur
  • Disposition du bureau : sous forme d'onglet dans le volet Informations auxiliaires

Lorsque l'événement pour lequel la fenêtre contextuelle est configurée se produit, celle-ci s'affiche en dehors du bureau, c'est-à-dire dans un nouvel onglet de navigateur.

Exemples de cas d'utilisation

Les sections suivantes fournissent quelques exemples à titre de référence :

Configurer et accéder au widget de mesures de gestion de l'expérience client depuis la barre de navigation

Exemple :

{
    "nav": {
        "label": "Customer Experience Management Metrics",
        "icon": "/app/images/wxm.bcd45cc3.svg",
        "iconType": "other",
        "navigateTo": "wxm-metrics",
        "align": "top"
    },
    "page": {
        "id": "wxm-metrics",
        "widgets": {
            "comp1": {
                "comp": "agentx-wc-cloudcherry-widget",
                "attributes": {
                    "metrics": true
                },
                "properties": {
                    "userModel": "$STORE.app.userModel",
                    "spaceId": "",
                    "metricsId": "",
                    "teamId": "$STORE.agent.teamName",
                    "ani": "$STORE.agentContact.taskSelected.ani",
                    "isDarkMode": "$STORE.app.darkMode"
                },
                "wrapper": {
                    "title": "Customer Experience Journey",
                    "maximizeAreaName": "app-maximize-area"
                }
            }
        },
        "layout": {
            "areas": [
                ["comp1"]
            ],
            "size": {
                "cols": [1],
                "rows": [1]
            }
        }
    }
},

Pour obtenir le SpaceID et le MetricsID, consultez la documentation. Webex Experience Management

Utilisation des onglets sur la page personnalisée

Exemple :

{
    "nav": {
        "label": "Dynamic Tabs",
        "icon": "stored-info",
        "iconType": "momentum",
        "navigateTo": "dynamic-tabs",
        "align": "top"
    },
    "page": {
        "id": "page-id-tabs",
        "widgets": {
            "comp1": {
                "comp": "md-tabs",
                "children": [{
                        "comp": "md-tab",
                        "textContent": "One",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel"
                        },
                        "children": [{
                            "comp": "widget-two",
                            "script": "http:/my-cdn.com/dynamic-widgets/widget-two.js"
                        }]
                    },
                    {
                        "comp": "md-tab",
                        "textContent": "Two",
                        "attributes": {
                            "slot": "tab"
                        }
                    },
                    {
                        "comp": "md-tab-panel",
                        "textContent": "Two Content",
                        "attributes": {
                            "slot": "panel"
                        }
                    }
                ]
            },
            "comp2": {
                "comp": "widget-two",
                "script": " http:/my-cdn.com/dynamic-widgets/widget-two.js"
            }
        },
        "layout": {
            "areas": [
                ["comp1", "comp2"]
            ],
            "size": {
                "cols": [1, 1],
                "rows": [1]
            }
        }
    }
}

Volet d'informations auxiliaires par défaut avec historique des contacts et écran contextuel

Exemple :

"panel": {
    "comp": "md-tabs",
    "attributes": {
        "class": "widget-tabs"
    },
    "children": [{
            "comp": "md-tab",
            "attributes": {
                "slot": "tab",
                "class": "widget-pane-tab"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY_TAB"
                }
            }]
        },
        {
            "comp": "md-tab-panel",
            "attributes": {
                "slot": "panel",
                "class": "widget-pane"
            },
            "children": [{
                "comp": "slot",
                "attributes": {
                    "name": "CONTACT_HISTORY"
                }
            }]
        },
    ]
}, {
    "comp": "md-tab",
    "attributes": {
        "slot": "tab",
        "class": "widget-pane-tab"
    },
    {
        "comp": "md-tab",
        "attributes": {
            "slot": "tab",
            "class": "widget-pane-tab"
        },
        "children": [{
            "comp": "slot",
            "attributes": {
                "name": "SCREEN_POP_TAB"
            }
        }],
        "visibility": "SCREEN_POP"
    },
    {
        "comp": "md-tab-panel",
        "attributes": {
            "slot": "panel",
            "class": "widget-pane"
        },
        "children": [{
            "comp": "slot",
            "attributes": {
                "name": "SCREEN_POP"
            }
        }],
        "visibility": "SCREEN_POP"
    }
},

Volet d'information auxiliaire avec widget Customer Experience Journey

Exemple :

"panel": {
    "comp": "md-tabs",
    "attributes": {
        "class": "widget-tabs"
    },
    "children": [{
                "comp": "md-tab",
                "attributes": {
                    "slot": "tab"
                },
                "children": [{
                    "comp": "slot",
                    "attributes": {
                        "name": "WXM_JOURNEY_TAB"
                    }
                }],
                "visibility": "WXM_JOURNEY"
            },
            {
                "comp": "md-tab-panel",
                "attributes": {
                    "slot": "panel",
                    "class": "widget-pane"
                },
                "children": [{
                    "comp": "agentx-wc-cloudcherry-widget",
                    "properties": {
                        "userModel": "$STORE.app.userModel",
                        "spaceId": "",
                        "metricsId": "",
                        "teamId": "$STORE.agent.teamName",
                        "ani": "$STORE.agentContact.taskSelected.ani",
                        "isDarkMode": "$STORE.app.darkMode"
                    },
                    "wrapper": {
                        "title": "Customer Experience Journey",
                        "maximizeAreaName": "app-maximize-area"
                    }
                }],
                {
                    "comp": "md-tab",
                    "attributes": {
                        "slot": "tab",
                        "class": "widget-pane-tab"
                    },
                    "children": {
                        "comp": "md-tab",
                        "attributes": {
                            "slot": "tab",
                            "class": "widget-pane-tab"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "CONTACT_HISTORY_TAB"
                            }
                        }]
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel",
                            "class": "widget-pane"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "CONTACT_HISTORY"
                            }
                        }]
                    },
                    {
                        "comp": "md-tab",
                        "attributes": {
                            "slot": "tab",
                            "class": "widget-pane-tab"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "SCREEN_POP_TAB"
                            }
                        }],
                        "visibility": "SCREEN_POP"
                    },
                    {
                        "comp": "md-tab-panel",
                        "attributes": {
                            "slot": "panel",
                            "class": "widget-pane"
                        },
                        "children": [{
                            "comp": "slot",
                            "attributes": {
                                "name": "SCREEN_POP"
                            }
                        }],
                        "visibility": "SCREEN_POP"
                    }
                    "visibility": "SCREEN_POP"
                },
            },

Localisation

L' interface utilisateur de bureau prend en charge la localisation en 29 langues.

Les langues prises en charge sont les suivantes :

bulgare, catalan, chinois (Chine), chinois (Taïwan), croate, tchèque, danois, néerlandais, anglais (Royaume-Uni), anglais (États-Unis), finnois, français, allemand, hongrois, italien, japonais, coréen, norvégien, polonais, portugais (Brésil), portugais (Portugal), roumain, russe, serbe, slovaque, slovène, espagnol, suédois et turc.

La langue de l'interface utilisateur du bureau dépend des préférences linguistiques de votre navigateur. Par exemple, supposons que vous avez sélectionné la langue préférée comme le français sur le navigateur Firefox. Lorsque vous lancez le bureau dans le navigateur Firefox, l'interface utilisateur du bureau apparaît en français. Cependant, l'en-tête horizontal, la barre de navigation et les autres éléments ajoutés dans la mise en page du bureau ne sont pas localisés selon les préférences linguistiques de votre navigateur.

Localiser les composants des ordinateurs de bureau

Pour localiser les composants des ordinateurs de bureau,

  • Utilisez les clés de localisation existantes définies dans le fichier app.json. Si les touches de localisation ne sont pas réglées, la langue par défaut, l'anglais (États-Unis), est utilisée. Vous pouvez envoyer une demande de service au support Cisco pour ajouter une clé de localisation au fichier app.json.

    Exemple : clé de localisation

    {
        "common": {
            "buttonTitle": "Stop Timer"
        }
    }
  • Entrez la propriété sensible aux majuscules et minuscules suivante dans le fichier JSON Desktop Layout pour localiser un composant :

    "textContent": "$I18N.<key>",
    

    où <key>fait référence à la clé de localisation correspondante dans le fichier app.json.

Exemple : Localize Header Component

"header": {
    "id": "header",
    "widgets": {
        "head1": {
            "comp": "md-button",
            "attributes": {
                "slot": "menu-trigger",
                "style": "height: 64px"
            },
            "children": [{
                    "comp": "span",
                    "textContent": "$I18N.common.buttonTitle",
                }
            },

        },
    }

Exemple : Localiser le composant Tab dans le volet d'informations auxiliaire

"panel": {
    "comp": "md-tab",
    "attributes": {
        "slot": "tab"
    },
    "children": [{
        "comp": "span",
        "textContent": "$I18N.panelTwo.screenPopTitle"
    }]
}
Cet article était-il utile ?
Cet article était-il utile ?