- Home
- /
- Articolo
Creare un layout desktop personalizzato
Questo articolo aiuta a creare un layout personalizzato modificando un file JSON e offre esempi di casi d'uso per aiutarla a iniziare con widget come il widget Customer Experience Management Metrics e il widget Customer Experience Journey. Per lavorare in modo efficace con layout desktop personalizzati, dovrebbe avere una solida conoscenza della struttura HTML, del modello ad albero dei documenti in un browser e del formato JSON.
Panoramica
La funzione Desktop Layout Le consente di configurare Webex Contact Center Desktop secondo i suoi requisiti aziendali. Può personalizzare elementi come logo, titolo e widget. Può creare un layout desktop e assegnarlo a un team. Questo layout genera l'esperienza dell'agente sul desktop per tutti gli agenti che accedono come parte di quel team.
Esistono due tipi di layout:
-
Layout globale: Questo layout è un layout generato dal sistema che viene assegnato per impostazione predefinita quando crea un team. Per ulteriori informazioni, consulti Gestire i team. Quando crea un team, il layout globale viene impostato automaticamente come layout desktop per il team. Non può eliminare questo layout.
-
Layout personalizzato: un layout che offre un'esperienza desktop personalizzata. Può creare un layout personalizzato per uno o più team.
Se assegna un nuovo layout del desktop quando un agente ha effettuato l'accesso, l'agente deve ricaricare la pagina per vedere il nuovo layout.
Il Webex Contact Center Desktop supporta tre persone:
-
Agente
-
Supervisore
-
Supervisore e agente
Il file di layout JSON ha sezioni separate per ciascuna persona. L'amministratore deve configurare le impostazioni per ogni persona nella sezione corrispondente del file di layout JSON. Per ulteriori informazioni su un file di layout JSON di esempio, vedere JSON Layout Top-Level Properties.
Quando Cisco aggiunge una nuova funzionalità al layout del desktop, il layout non modificato viene aggiornato automaticamente con le nuove funzionalità. Il layout desktop aggiornato è automaticamente disponibile per i team esistenti che utilizzano il layout desktop non modificato. Gli utenti Desktop che utilizzano il layout desktop non modificato ricevono le nuove funzionalità basate sul layout quando accedono o ricaricano il browser.
Se sta utilizzando il file Default Desktop Layout.json senza
alcuna modifica, viene considerato un layout non modificato. Tuttavia, se
scarica il file Default Desktop Layout.json e lo carica
nuovamente, viene considerato un layout modificato anche se il contenuto o il nome del file non vengono modificati.
Per i team che utilizzano un layout desktop personalizzato, gli amministratori devono aggiornare periodicamente la definizione del layout per incorporare nuove funzionalità. Quando gli amministratori visualizzano un layout non modificato o un team che utilizza un layout non modificato, viene visualizzato un messaggio che indica che le nuove funzionalità del desktop vengono applicate automaticamente.
Nel Desktop, ci sono due tipi di widget: basati su iframe e basati su componenti web. L'intestazione, la navigazione (pagina personalizzata), l'area persistente, l'area senza testa e il pannello ausiliario sono l'area personalizzabile di un desktop. Questi non sono widget.
L'elenco seguente descrive in dettaglio gli spazi che può configurare. Le immagini illustrano il layout del Desktop:
-
Area Titolo e logo: Questo spazio mostra il logo e il nome del Webex Contact Center (impostazione predefinita) nell'angolo in alto a sinistra dello schermo.
-
Area dell'intestazione orizzontale: questo spazio ha un'area configurabile popolata con widget personalizzati. Questi widget possono visualizzare, ad esempio, informazioni in linea e menu a discesa. Poiché l'altezza di questa intestazione è di soli 64 pixel, l'altezza del widget non può superare l'altezza dell'intestazione.
-
Area di lavoro: questo spazio cambia in base alla selezione sulla barra di navigazione o quando un agente interagisce con i clienti. Quando un agente è impegnato in una chiamata, quest'area visualizza il pannello di controllo delle interazioni e delle informazioni ausiliarie (che include widget personalizzati e widget permanenti). Quando un agente interagisce tramite e-mail, chat o canali social, quest'area mostra l'area dell'area di lavoro e il riquadro delle informazioni ausiliarie (che include l'area persistente dei widget).
La pagina personalizzata viene visualizzata sull'interfaccia desktop nel riquadro dell'area di lavoro. Può accedere alla pagina personalizzata tramite le icone sulla barra di navigazione. Ogni pagina personalizzata può contenere uno o più widget personalizzati.
Custom Widget è un'applicazione di terze parti configurata nel layout JSON. Può posizionare il widget personalizzato nella pagina personalizzata, nella scheda personalizzata (riquadro Informazioni ausiliarie) o nell'intestazione orizzontale del desktop.
-
Area della barra di navigazione: usi questo spazio per aggiungere elementi di navigazione per accedere alle pagine personalizzate.


Proprietà di primo livello del layout JSON
Ruoli
Il layout JSON predefinito ha i seguenti tre ruoli.
-
Agente: per impostare il layout del desktop da visualizzare quando un agente accede a Webex Contact Center Desktop per gestire le attività dell'agente.
-
Supervisore: per impostare il layout del desktop da visualizzare quando un supervisore accede al desktop del Webex Contact Center per gestire solo le funzionalità del supervisore.
Quando un supervisore accede al desktop, viene applicato il layout del desktop specificato per il team principale. Se non fornisce un team principale, si applica il layout globale. Per impostazione predefinita, i report APS sono disabilitati.
-
SupervisorAgent: per impostare il layout del desktop da visualizzare quando un supervisore accede al Webex Contact Center Desktop per gestire sia le funzionalità del supervisore che le attività dell'agente.
Può aggiungere o modificare i widget per ogni ruolo nella persona corrispondente del file di layout JSON pertinente.
Le seguenti sono le proprietà di primo livello per il layout JSON in base al ruolo:
{
"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": {
...
}
},
}
},
- Le modifiche apportate alle proprietà del layout JSON hanno effetto quando il browser Desktop viene aggiornato.
- Se una funzionalità da Lei abilitata sul layout JSON non è disponibile sul desktop, contatti l'assistenza Cisco per abilitare la funzione.
- Tutte le proprietà nel layout JSON fanno distinzione tra maiuscole e minuscole.
Titolo dell'app
Per specificare un titolo nell'intestazione orizzontale del Desktop. Il titolo predefinito è Webex Contact Center.
Esempio:
"appTitle": "Webex Contact Center"
L'AppTitle predefinito viene modificato da Contact Center Desktop a Webex Contact Center. Non c'è alcun impatto sui layout personalizzati esistenti che utilizzano il vecchio AppTitle predefinito (Contact Center Desktop). Per utilizzare il nuovo AppTitle, deve modificare il layout personalizzato. Tuttavia, il nuovo layout globale utilizza l'AppTitle predefinito come Webex Contact Center.
Il titolo può essere testo, un'immagine o una stringa vuota. Il testo del titolo appare su due righe. Se il testo si estende oltre la seconda riga, viene visualizzata un'icona con i puntini di sospensione e il suggerimento mostra il titolo completo. Gli stili non possono essere applicati al titolo.
Può utilizzare gli URI di dati (Uniform Resource Identifier) o ospitare un'immagine del titolo personalizzata su una rete di distribuzione di contenuti (CDN), un bucket Amazon Web Services (AWS) Simple Storage Service (S3) o un servizio di hosting simile, quindi specificare l'URL dell'immagine ospitata. I formati di immagine del titolo supportati sono PNG, JPG, JPEG, GIF, SVG e WebP. La dimensione dell'immagine del titolo supportata è 184 x 32 pixel (larghezza x altezza).
logo
Per specificare un URL per il logo aziendale. Se non fornisce un URL, per impostazione predefinita viene visualizzato il logo del Webex Contact Center.
Esempio:
"logo": "https://my-cdn.com/logo.png"
Può ospitare un'immagine del logo personalizzata su un CDN, un bucket Amazon Web Services (AWS) Simple Storage Service (S3) o un servizio di hosting simile, quindi specificare l'URL dell'immagine ospitata. I formati di immagine del logo supportati sono PNG, JPG, JPEG, GIF, SVG e WebP. La dimensione dell'immagine del logo supportata è 96 x 32 pixel (larghezza x altezza).
| Condizione | Esempio | Titolo dell'app | logo |
|---|---|---|---|
| Se AppTitle e il logo non sono configurati |
|
Senza titolo | Logo predefinito |
| Se AppTitle e il logo sono configurati |
|
Testo configurato | Logo configurato |
| Se AppTitle è configurato e il logo non è configurato |
|
Testo configurato | Logo predefinito |
|
Se AppTitle non è configurato e il logo è configurato
|
|
Senza titolo | Logo configurato |
| Se AppTitle è configurato e il logo non è preferito |
|
Testo configurato | Nessun logo |
|
Se AppTitle non è configurato e il logo non è preferito
|
|
Senza titolo | Nessun logo |
| Se AppTitle viene aggiunto come immagine e il logo è configurato |
|
Immagine configurata | Logo configurato |
|
Se AppTitle viene aggiunto come immagine e il logo non è configurato
|
|
Immagine configurata | Logo predefinito |
|
Se AppTitle viene aggiunto come immagine e il logo non è preferito
|
|
Immagine configurata | Nessun logo |
- La dimensione dell'immagine personalizzata viene regolata in base alle proporzioni. Il testo del titolo personalizzato configurato in precedenza può ora apparire su due righe sul desktop. Per evitare ciò, può modificare il testo del titolo personalizzato.
- Se il titolo e il logo non sono configurati nell'intestazione orizzontale del Desktop, quello spazio viene utilizzato dai widget dell'intestazione. I widget dell'intestazione devono essere configurati correttamente per utilizzare lo spazio del titolo e del logo.
- Il titolo e il logo insieme non possono superare la larghezza massima di 304 pixel (inclusa la spaziatura interna). Se la larghezza del logo è inferiore a 96 pixel, la larghezza rimanente può essere utilizzata per il titolo.
- Se la dimensione dell'immagine personalizzata è superiore a quella supportata, la dimensione dell'immagine viene regolata in base alle proporzioni nell'intestazione orizzontale. Se la dimensione dell'immagine personalizzata è inferiore a quella supportata, la dimensione effettiva dell'immagine viene mantenuta nell'intestazione orizzontale.
Illustrazione della pagina delle attività
Specificare un'illustrazione personalizzata per la pagina delle attività in base alle preferenze dell'organizzazione e all'allineamento del marchio. Quando un agente accede, la pagina delle attività mostra l'illustrazione configurata come sfondo. Per impostazione predefinita, la pagina delle attività viene visualizzata senza illustrazione.
Esempio:
"taskPageIllustration": "https://www.abc.com/image/logo.jpg",
Può utilizzare gli URI di dati o ospitare un'illustrazione personalizzata su una rete di distribuzione di contenuti (CDN), un bucket Amazon Web Services (AWS) Simple Storage Service (S3) o un servizio di hosting simile, quindi specificare l'URL dell'illustrazione ospitata. L'illustrazione può essere configurata a livello globale o di team in base alla definizione del layout. Si assicuri di configurare l'URL corretto per evitare che l'immagine danneggiata venga visualizzata sul desktop.
I formati di illustrazione delle pagine delle attività supportati sono PNG, JPG, JPEG, GIF, SVG e WebP. La dimensione dell'illustrazione consigliata è 400 x 400 pixel (larghezza x altezza). Se le dimensioni dell'illustrazione personalizzata sono maggiori di quelle consigliate, le dimensioni dell'illustrazione vengono regolate in base alle proporzioni nella pagina delle attività. Se le dimensioni dell'illustrazione personalizzata sono inferiori a quelle consigliate, le dimensioni effettive dell'illustrazione vengono mantenute nella pagina delle attività.


Interrompi la navigazione su AcceptTask
Per determinare se spostare l'attenzione su un'attività appena accettata, quando l'agente accetta la nuova attività mentre lavora su un'attività precedente. Il valore predefinito è false.
Esempio:
"stopNavigateOnAcceptTask": false
Se il valore è impostato su true, quando l'utente accetta una nuova attività sul Desktop, l'attenzione viene mantenuta sull'attività precedente e non si sposta sulla nuova attività accettata. Questa impostazione impedisce all'utente di perdere dati quando accetta una nuova richiesta.
Ad esempio, consideri che l'Agente 1 è in chat con il Cliente 1 e contemporaneamente sta effettuando una chiamata vocale con il Cliente 2. Durante la chiamata vocale, l'Agente 1 sta aggiornando i dettagli del Cliente 2 nel pannello di controllo delle interazioni. Attualmente, l'Agente 1 ha due attività attive nel riquadro Elenco attività e l'attenzione è rivolta al riquadro Interaction Control. Quando l'Agente 1 accetta una nuova richiesta di chat dal Cliente 3, l'attenzione rimane sul pannello di controllo delle interazioni con il Cliente 2 e non si sposta sulla nuova richiesta di chat accettata.
Per mantenere l'attenzione sull'attività precedente e non passare all'attività appena accettata, selezioni il layout personalizzato con il valore della proprietà stopNavigateOnAcceptTask impostato su true.
Se il valore della proprietà StopNavigateOnAcceptTask non viene immesso nel layout JSON, il Desktop sposta l'attenzione sull'attività appena accettata. Il comportamento è simile a quando il valore della proprietà stopNavigateOnAcceptTask è impostato su false.
- L'impostazione si applica a tutte le attività (canali vocali e digitali) eseguite sul desktop, come l'accettazione di un'attività, una conferenza, una consulenza o un trasferimento e per le chiamate esterne, le chiamate alla campagna in uscita, la conclusione automatica e così via.
- L'impostazione non si applica se l'utente Desktop si trova nella home page, senza attività attive nel riquadro Elenco attività. In tal caso, quando viene accettata una nuova attività, l'attenzione viene spostata dalla home page alla nuova attività accettata.
Drag Drop abilitato
Per abilitare il trascinamento e il ridimensionamento dei widget nelle pagine personalizzate, imposta il valore su true. Il valore predefinito è false.
Esempio:
"dragDropEnabled": false
Timer di notifica
Per impostare la durata (in secondi) dopo la quale le notifiche desktop sul desktop vengono automaticamente eliminate. La notifica viene visualizzata nell'angolo in alto a destra del Desktop. Il valore di timeout predefinito è 8 secondi. L'intervallo valido per i valori di timeout è 1-10 secondi. Affinché le modifiche al timeout abbiano effetto, il browser deve essere aggiornato dopo aver apportato le modifiche.
Esempio:
"notificationTimer": 8
Numero massimo di notifiche
Per impostare il numero di notifiche desktop da visualizzare contemporaneamente sul desktop. Il valore predefinito è 3. L'intervallo per le notifiche desktop è compreso tra 1 e 10. Le notifiche desktop sono cumulative. Se ci sono molte notifiche, vengono visualizzate con un leggero ritardo a seconda delle impostazioni NotificationTimer.
Esempio:
"maximumNotificationCount": 3
Timer di notifica del browser
Per impostare la durata (in secondi) dopo la quale le notifiche del browser tostapane sul Desktop vengono automaticamente eliminate. Toaster è una notifica nativa del browser che appare solo se il Desktop non è la finestra o la scheda attiva del browser. La finestra o scheda del browser Desktop è inattiva quando
-
Sta lavorando su altre finestre o schede del browser.
-
Sta lavorando su altre applicazioni.
-
Lei ha ridotto a icona la finestra del browser Desktop.
La notifica viene visualizzata nell'angolo in alto a destra del Desktop. Il valore di timeout predefinito è 8 secondi. L'intervallo consigliato per i valori di timeout è di 5-15 secondi. Affinché le modifiche al timeout abbiano effetto, il browser deve essere aggiornato dopo aver apportato le modifiche.
Esempio:
"browserNotificationTimer": 8
Il timeout configurato per le notifiche del browser dipende dal sistema operativo e dalle impostazioni del browser. Il valore di timeout è rispettato nel browser Chrome su Windows OS, Chrome OS e macOS. Tuttavia, gli altri browser supportati non rispettano in modo coerente il valore di timeout delle notifiche configurato.
Configurato WXM
(Facoltativo) Per configurareWebex Experience Management, imposta il valore su
true. Il valore predefinito è false.
Esempio:
"wxmConfigured": true
App di chat desktop
Per configurare più applicazioni di chat offerte da Cisco come l'app Webex.
WebEx configurato
L'app Webex insieme alle sue funzionalità di messaggistica e riunione possono essere configurate sul desktop. Questa configurazione consente agli agenti di collaborare con altri agenti, supervisori ed esperti in materia (PMI) della loro organizzazione senza allontanarsi dal desktop.
- L'amministratore del sito gestisce gli utenti di Webex Meeting e assegna i privilegi solo se gli utenti dispongono di Webex Enterprise Edition. Per ulteriori informazioni, vedere Gestire Webex Meetings gli utenti in Cisco Webex Control Hub.
- I supervisori e le PMI devono scaricare il Webex Client sul proprio sistema (dispositivo personale) o accedere all'app Webex utilizzando l'app Webex per il Web (https://web.webex.com/). Per ulteriori informazioni, veda Scaricare l' app.
- Può accedere all'app Webex all'interno di Agent Desktop per collaborare con altri agenti, supervisori ed esperti in materia (PMI) della sua organizzazione senza allontanarsi dal. Agent Desktop La funzione di controllo delle chiamate non è disponibile. Per ricevere ed effettuare chiamate, è necessaria l'app Webex esterna non incorporata. Per ulteriori informazioni, vedere Calling Apps.
Per configurare l'app Webex sul desktop:
-
InCisco Webex Control Hub, quando si aggiungono servizi per un utente, selezionare la casella di controllo Messaggistica avanzata (). Per ulteriori informazioni, vedere Gestire gli account utente in Amministrazione Cisco Webex del sito.
-
Nel layout desktop personalizzato, imposta il valore della proprietàWebExConfiguredsu true.Esempio:
"desktopChatApp": { "webexConfigured": true },Il valore predefinito della proprietàWebExConfiguredè false.L'app Webex è disponibile per i ruoli agente, supervisore e supervisorAgent solo se imposta il valore della proprietàL'agente, il supervisore o il supervisorAgent non può disconnettersi dall'app Webex.WebexConfiguratedsu true per ciascuno di questi ruoli.Per visualizzare l'iconaPer ulteriori informazioni, vedere HeaderActions.
(Webex) nell'intestazione orizzontale del desktop, inserire il valore webexnella proprietà headerActions.Per abilitare l'app Webex per un team specifico, seleziona il layout personalizzato con il valore della proprietàPer ulteriori informazioni, veda Creare un team.WebexConfigurated impostatosu true.
Può configurare l'app Webex anche nel riquadro Informazioni ausiliarie, nella pagina personalizzata e nel widget personalizzato. Per ulteriori informazioni, vedere il riquadro delle informazioni ausiliarie.
Notifica dell'app Webex
I valori specificati utilizzando le proprietà NotificationTimer e BrowserNotificationTimer per il timer delle notifiche sono applicabili all'app Webex. Il valore di timeout predefinito è 8 secondi per queste proprietà. Per ulteriori informazioni, vedere NotificationTimer e BrowserNotificationTimer.
Azioni dell'intestazione
Per modificare l'ordine delle icone nell'intestazione orizzontale del Desktop. L'ordine predefinito è il seguente:
-
(Webex) -
(Chiamata esterna) -
(Centro notifiche)
Imposta il valore della proprietà headerActions come segue:
|
Nome dell'icona |
Valore della proprietà HeaderActions |
|---|---|
|
App Webex |
webex |
|
Chiamata esterna |
esterno |
|
Centro notifiche |
notifica |
Esempio:
«headerActions»: ["webex», «outdial», «notifica"],
Il valore della proprietà HeaderActions fa distinzione tra maiuscole e minuscole.
Per modificare l'ordine predefinito delle icone, inserisca di conseguenza la proprietà HeaderActions e i valori nel layout personalizzato.
Esempio:
«headerActions»: ["notifica», «outdial», «webex"],
- Se non inserisce la proprietà e i valori
HeaderActionsnel layout personalizzato, le icone vengono visualizzate nell'ordine predefinito. - Per rimuovere le icone delle intestazioni e le funzionalità associate dal Desktop, imposta un valore vuoto per la proprietà HeaderActions
(
«»: []). Tuttavia, se ha aggiunto l'app Webex al riquadro Informazioni ausiliarie o a una pagina personalizzata o come widget personalizzato, l'agente può comunque accedere all'app Webex sebbene l'app Webex non sia disponibile nell'intestazione orizzontale del desktop.HeaderActions Se il valore della proprietàPer ulteriori informazioni, vedere WebExConfigured.WebexConfiguratedè impostato sufalse, l'icona dell'app Webex non viene visualizzata nell'intestazione orizzontale del desktop, anche se il valorewebexviene aggiunto nella proprietà headerActions.
zona
La proprietà area è la sezione principale del Desktop Layout. Può definire il layout in base all'area.
"area": {
"header": {
...
},
"advancedHeader: {
{
"comp": "widget-1",
"attributes": { ... },
"script": ....
}
},
"panel": {
...
},
"navigation": {
...
},
"persistent": {
...
},
"headless": {
...
}
},
Può configurare i seguenti oggetti dell'area:
-
Pannello: rappresenta il secondo pannello o il pannello più a destra nel riquadro Informazioni ausiliarie.
-
Navigazione: rappresenta le pagine personalizzate e i relativi elementi di navigazione correlati alle pagine.
-
Persistente: rappresenta i widget a livello di pagina che sono persistenti e vengono visualizzati su tutte le pagine del Desktop.
-
Headless: rappresenta i widget che non dispongono di un'interfaccia visiva, ma eseguono la logica in background.
Se la proprietà AdvancedHeader è configurata, le proprietà header e headerActions devono essere rimosse.
Intestazione avanzata
Per personalizzare la visibilità e modificare l'ordine delle icone nell'intestazione orizzontale del Desktop. L'ordine predefinito è il seguente:
-
(Webex) -
(Chiamata esterna) -
(Centro notifiche) -
(Agente di selezione dello stato)
Imposta il valore della proprietà AdvancedHeader come segue:
|
Nome dell'icona |
Valore della proprietà HeaderActions |
|---|---|
|
App Webex |
agente x-webex |
|
Chiamata esterna |
agente x-outdial |
|
Centro notifiche |
notifica agente x |
|
Agente, selettore di stato |
agentx-state-selector |
Esempio:
"advancedHeader": [
{
"comp": "agentx-webex"
},
{
"comp": "agentx-outdial"
},
{
"comp": "agentx-notification"
},
{
"comp": "agentx-state-selector"
}
{
"comp": "widget-1",
"attributes": { ... },
"script": ....
}
]
Il valore della proprietà AdvancedHeader fa distinzione tra maiuscole e minuscole.
Per modificare l'ordine predefinito delle icone, inserisca di conseguenza la proprietà AdvancedHeader e i valori nel layout personalizzato.
I widget scorrono nel menu a discesa da sinistra a destra.
-
Se non inserisce la proprietà
AdvancedHeadernel layout personalizzato, viene visualizzata l'intestazione predefinita. -
Quando l'intestazione avanzata è abilitata, deve spostare i widget dall'intestazione esistente all'intestazione avanzata come nell'esempio.
-
Quando l'intestazione avanzata è abilitata, la vecchia intestazione non verrà visualizzata.
-
Ogni icona del widget ha un padding e un margine predefiniti definiti tramite CSS e non possono essere personalizzati tramite desktop.
-
La posizione del logo, del titolo e delle icone del profilo è fissa e non può essere personalizzata.
-
Per rimuovere le icone dell'intestazione e le funzionalità associate dal Desktop, imposta un valore vuoto per il componente associato nella proprietà AdvancedHeader (
«AdvancedHeader»: []).Se ha aggiunto l'app Webex al riquadro Informazioni ausiliarie o a una pagina personalizzata o come widget personalizzato, l'agente può comunque accedere all'app Webex sebbene l'app Webex non sia disponibile nell'intestazione orizzontale del desktop.
-
Se aggiunge un widget con un'etichetta lunga, viene visualizzato un nome di etichetta troncato in base allo spazio disponibile.
Può usare l'attributo
textContentper aggiungere un'etichetta a un widget.Esempio:
{ "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'etichetta «Conto alla rovescia per il turno corrente» verrà troncata e visualizzata in base allo spazio disponibile.
-
Evita di aggiungere widget con un'etichetta lunga.
-
Quando un widget scorre nel menu a discesa, è possibile fare clic solo sull'icona del widget.
-
-
Se il valore della proprietàPer ulteriori informazioni, vedere WebExConfigured.WebExConfiguratedè impostato sufalse, l'icona dell'app Webex non viene visualizzata nell'intestazione orizzontale del desktop, anche se il valorewebexviene aggiunto nella proprietà AdvancedHeader.
Pagina principale
Quando accede al Desktop, arriva sulla Home Page.
La home page è applicabile solo ai Supervisori e ai Supervisori Agenti.
Può visualizzare i seguenti widget nella Home Page. I widget Analyzer sono forniti per impostazione predefinita, ma l'amministratore può anche configurare widget permanenti e personalizzati. Per ulteriori informazioni, vedere JSON Layout Top-Level Properties.
Widget dell'analizzatore
Per impostazione predefinita, il widget Analyzer viene visualizzato nella home page del desktop.
Configurazione del layout della home page
Può configurare la home page del desktop per visualizzare un layout basato sulle preferenze della sua organizzazione e sull'allineamento del marchio. Modifica il campo Homepage per configurare la home page. Può configurare i seguenti componenti in modo che vengano visualizzati nella home page quando un utente accede al desktop:
-
Un messaggio di benvenuto
-
L'icona dell'Attività nella barra di navigazione per accedere al riquadro Attività. L'icona Attività viene visualizzata per i ruoli Supervisore e Supervisore e Agente con la funzione di monitoraggio delle chiamate abilitata. Il riquadro attività mostra le richieste dei clienti in arrivo, le interazioni attive e passate con i clienti e le richieste di monitoraggio attive.
-
Filtra sezioni come Nome della coda, Tipo di canale e Team gestiti.
La tabella seguente descrive le proprietà della pagina necessarie per configurare la Home Page:
|
Proprietà |
Descrizione e codice |
|---|---|
|
pagina > UseFlexLayout |
Il layout flessibile è un nuovo componente web. Non modifica i widget esistenti. Il nuovo layout flessibile utilizza lo stesso formato di configurazione del layout in modo semplificato. È retrocompatibile e non ha alcun impatto sui widget esistenti. Deve configurare il layout JSON. Per configurare il layout JSON, fornisca l'altezza e la larghezza del widget. Il widget viene visualizzato nella stessa sequenza in cui è configurato all'interno del layout JSON. I widget hanno un margine predefinito di 8 px. Il layout JSON si basa sulle dimensioni (larghezza x altezza) e sulle coordinate (X, Y e Z) dei widget. Il layout flessibile supporta funzionalità come il ridimensionamento dei singoli widget, la massimizzazione dei widget e così via. L'altezza dei singoli widget è misurata in pixel. 1 unità di altezza = 40 pixel. La larghezza del widget dipende dal numero di colonne nel contenitore e dal numero di colonne che cambiano in base alla larghezza del contenitore. I widget vengono visualizzati da sinistra a destra. Il motore di layout avanzato utilizza una logica personalizzata per applicare la regolazione dello spazio sia orizzontale che verticale dei widget. Inizialmente, il layout viene caricato orizzontalmente. Dopo il caricamento orizzontale, il widget si carica verticalmente e garantisce che l'utilizzo dello spazio sia ottimale. Configura i widget in base alle dimensioni dello schermo. Può aumentare o diminuire la larghezza dei widget, in base alle dimensioni dello schermo. Questo rende i widget più leggibili e utilizzabili. Il layout flessibile fornisce punti di interruzione standard come grande, medio, piccolo ed extra piccolo.
Questi pixel possono variare in base al sistema operativo e al browser.
|
|
pagina > comp |
Si assicuri di fornire un componente personalizzato unico.
Il componente del |
|
pagina > PageHeader |
Si assicuri di specificare una stringa del titolo che può essere statica, dinamica o entrambe. Il componente del
|
|
pagina > PageSubheader |
Si assicuri di aggiungere il sottotitolo che viene visualizzato sul desktop. L'utente può aggiungere Go to Analyzer nel sottotitolo.
|
Navigazione (pagine personalizzate)
In questa sezione, può aggiungere pagine che appaiono nella barra di navigazione a sinistra. Lei specifica un'icona di navigazione e un URL univoco per far apparire il widget sulla barra di navigazione. Si consiglia di utilizzare un prefisso specifico per l'URL per evitare conflitti. Per maggiori dettagli, consulti la sezione delle proprietà di navigazione.
Può anche avere una raccolta di widget che possono essere visualizzati in questa pagina. La pagina può avere un singolo widget che appare sullo schermo o una raccolta di widget in una griglia. Per maggiori dettagli sulla disposizione della griglia, vedere la sezione sulle proprietà del layout.
Non è necessario aggiungere un wrapper ad area dinamica all'albero dei widget. Ciò significa che può trascinare e ridimensionare i widget sulle pagine personalizzate quando abilita questa opzione.
Esempio:
{
"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]
}
}
}
},
La tabella seguente descrive le proprietà di navigazione e pagina insieme alle relative proprietà secondarie:
|
Proprietà |
Descrizione e codice |
|---|---|
|
nav > etichetta |
Questa proprietà indica l'identificatore di navigazione della pagina. Lo screen reader legge questa proprietà e viene visualizzata nel tooltip. Questi parametri sono necessari per visualizzare la sua pagina personalizzata sulla barra di navigazione.
La proprietà |
|
navigatore > Tipo di icona |
Questa proprietà rappresenta il tipo di icona visualizzata nella barra di navigazione della pagina personalizzata. Sono disponibili i seguenti tipi di icone:
|
|
nav > icona |
Questa proprietà rappresenta il nome dell'icona nella libreria Momentum o nell'URL del CDN.
|
|
navigazione > allinea |
Questa proprietà La aiuta ad allineare l'icona nella parte superiore o inferiore della barra di navigazione. Attualmente, la proprietà consente solo l'allineamento superiore. |
|
nav > Pagina di destinazione predefinita | Questa proprietà specifica la pagina di destinazione predefinita per gli agenti inAgent Desktop. Imposta questa proprietà su true per rendere la pagina della barra di navigazione la pagina di destinazione predefinita che appare per gli agenti dopo aver effettuato l'accesso alAgent Desktop. Se più di una pagina della barra di navigazione ha questa proprietà impostata su true, il sistema considera la prima pagina della barra di navigazione la pagina di destinazione predefinita. Se nessuna pagina della barra di navigazione ha questa proprietà impostata su true, la Home page funge da pagina di destinazione predefinita. Non può impostare i report di Analyzer and Agent Performance Statistics come pagina di destinazione predefinita. |
|
navigatore > NavigateTo |
Questa proprietà specifica il nome della pagina personalizzata. Questo nome appare nella barra degli indirizzi quando l'agente naviga. Il NavigateTo non deve includere i seguenti valori: images, fonts, css, build_info, help, app, i18n, icons, images-mfe-wc e sounds.
|
|
Proprietà |
Descrizione e codice |
|---|---|
|
pagina > id |
Nella proprietà La proprietà
|
|
pagina > UseFlexLayout |
Il layout flessibile è un nuovo componente web. Non modifica i widget esistenti. Il nuovo layout flessibile utilizza lo stesso formato di configurazione del layout in modo semplificato. È retrocompatibile e non ha alcun impatto sui widget esistenti. Deve configurare il layout JSON. Per configurare il layout JSON, fornisca l'altezza e la larghezza del widget. Il widget viene visualizzato nella stessa sequenza in cui è configurato all'interno del layout JSON. I widget hanno un margine predefinito di 8 px. Il layout JSON si basa sulle dimensioni (larghezza x altezza) e sulle coordinate (X, Y e Z) dei widget. Il layout flessibile supporta funzionalità come il ridimensionamento dei singoli widget, la massimizzazione dei widget e così via. L'altezza dei singoli widget è misurata in pixel. 1 unità di altezza = 40 pixel. La larghezza del widget dipende dal numero di colonne nel contenitore e dal numero di colonne che cambiano in base alla larghezza del contenitore. I widget vengono visualizzati da sinistra a destra. Il motore di layout avanzato utilizza una logica personalizzata per applicare la regolazione dello spazio sia orizzontale che verticale dei widget. Inizialmente, il layout viene caricato orizzontalmente. Dopo il caricamento orizzontale, il widget si carica verticalmente e garantisce che l'utilizzo dello spazio sia ottimale. Configura i widget in base alle dimensioni dello schermo. Può aumentare o diminuire la larghezza dei widget, in base alle dimensioni dello schermo. Questo rende i widget più leggibili e utilizzabili. Il layout flessibile fornisce punti di interruzione standard come grande, medio, piccolo ed extra piccolo.
Questi pixel possono variare in base al sistema operativo e al browser.
|
|
pagina > widget pagina > comp |
La aiuta a definire i suoi widget personalizzati. Per inserire più widget, specifichi le opzioni dei widget in sequenza. Si assicuri di assegnare a ciascun widget un nome di area univoco. Lo usi più tardi nella sezione del layout.
Questa proprietà rappresenta il nome dell'elemento HTML personalizzato (noto come componente Web o qualsiasi altro elemento, se desidera utilizzarlo come wrapper). Per ulteriori informazioni, vedere Esempi di casi d'uso. Inserisca qui il nome del suo elemento personalizzato senza parentesi angolari («<» or «>»). Ad esempio, «my-custom-element». Ogni voce nella sezione dei widget supporta il seguente formato:
|
|
pagina > script |
(Facoltativo) Questa proprietà è richiesta solo quando carica il widget o il componente da una postazione remota come un CDN.
Non modifichi l'URL dello script per lo stesso componente. Se deve modificare l'URL dello script per lo stesso componente, effettui una delle seguenti operazioni:
|
|
pagina > proprietà |
Può specificare le proprietà che deve passare per il componente Web.
|
|
pagina > reattivo |
Determina se un componente web o un widget basato su iFrame aggiunto nel layout personalizzato a livello di Configura questa proprietà con uno dei seguenti valori:
I widget che non rispondono non possono garantire la migliore esperienza utente e non vengono visualizzati nella visualizzazione più piccola. L'agente deve aumentare le dimensioni della finestra del browser per visualizzare tutti i widget configurati come non reattivi. |
|
pagina > attributi |
Può specificare gli attributi del componente Web in questa sezione.
|
|
pagina > visibilità |
Specifica se i widget offerti da Cisco aggiunti nel layout personalizzato a livello di I widget offerti da Cisco sono Cronologia contatti, trascrizione IVRCisco Webex Experience Management, Preview Campaign Call Guide e Screen Pop.
|
|
pagina > bambini |
Questa proprietà è la parte principale del layout. Nella sezione Per sapere come passare i valori STORE come proprietà, vedere Condividere dati dal desktop ai widget.
Il vantaggio della sezione dell'array «children» è che può utilizzare i componenti Web esistenti nelle sue specifiche di layout, che fanno già parte del pacchetto Desktop. Alcuni componenti Web del pacchetto Desktop includono:
Per ulteriori informazioni sugli attributi per la scheda persistente, vedere Attributi per le schede permanenti. |
|
pagina > TextContent |
La aiuta ad aggiungere i suoi contenuti testuali.
|
|
pagina > stile |
La aiuta ad assegnare un particolare stile CSS al suo componente.
|
|
pagina > involucro |
Il wrapper del widget Le consente di aggiungere una barra degli strumenti sopra il suo widget. La barra degli strumenti può contenere un titolo e l'icona Si assicuri di utilizzare il valore predefinito come «app-maximize-area». Attualmente, è disponibile solo il valore predefinito.
|
|
pagina > involucro > id |
(Facoltativo) Il wrapper del widget del componente web Le consente di aggiornare il titolo dinamico del widget utilizzando un identificatore univoco. Inserisca il valore della proprietà
Si assicuri di utilizzare lo stesso identificatore univoco per JavaScript CustomEvent. Per ulteriori informazioni, vedere la sezione Asynchronous Events nel capitolo Agent Contact Module di Desktop Developer. Cisco Webex Contact Center Per aggiornare il titolo del widget basato su iFrame, usi il contenuto iFrame dello stesso dominio. Quello che segue è un esempio:
|
|
pagina > agentx-wc-iframe |
Le permette di incorporare una pagina web in un iFrame che appare come widget sul desktop. Può usare il widget iFrame chiamato «agentx-wc-iframe».
|
|
pagina > impaginazione | Le permette di disporre i widget su una pagina. Il seguente formato rappresenta un layout a griglia: Qui può definire la griglia con i nomi delle aree che ha definito nella sezione widget. L'esempio seguente mostra come viene specificato il layout di tre righe e tre colonne: ![]() Nella sezione delle dimensioni, i numeri rappresentano la frazione di spazio che un widget può occupare rispetto agli altri widget. Tutte e tre le colonne occupano una frazione uguale di spazio. Con il 100% della larghezza disponibile, ogni widget occupa il 33,33% dello spazio orizzontale. ![]() Un altro esempio di caso d'uso, se imposta come «cols»: [1, 2, 2], significa che lo spazio complessivo è diviso per 5 (1+2+2) e il primo widget occupa il 20% dello spazio orizzontale. Il secondo e il terzo widget occupano il 40% ciascuno. Per ulteriori informazioni, vedere Concetti di base del layout a griglia. ![]() |
|
pagina > ROOT |
L'annidamento dei layout si chiama sublayout. Nel caso in cui abbia dei layout annidati nella sua configurazione di layout, deve avere un solo oggetto «ROOT» come principale per i sublayout. Altrimenti, la sua configurazione del layout può essere piatta se non è richiesto il nesting. Questo sublayout offre un maggiore controllo sul comportamento di ridimensionamento del layout. La proprietà del layout di pagina deve essere di tipo Record<string, Layout>. La proprietà layout Le consente di disporre i widget su una pagina.
Questa configurazione crea una griglia nel layout ROOT con due griglie secondarie che può ridimensionare indipendentemente. ![]() Il ridimensionamento di un componente influisce sui componenti all'interno di quel sublayout. ![]() Sia a conoscenza dei seguenti casi: Ciclo infinito: Se include il layout ROOT come sottolayout di ROOT, provoca un errore di «stack di chiamate superato» e viene eseguito un ciclo infinito.
![]() Stesso sottolayout (N) volte: se include il sublayout nella sua griglia più di una volta con lo stesso nome e se ne ridimensiona uno, tutti i sublayout vengono ridimensionati automaticamente. Se questo non è il comportamento desiderato, rinomini ciascuno dei sublayout con un nome univoco.
![]() |
Attributi per le schede permanenti
Per impostare le schede nelle pagine personalizzate e i widget personalizzati come permanenti, inserisca gli attributi per md-tabs nel layout personalizzato.
Esempio: Imposta le schede come permanenti
{
"comp": "md-tabs",
"attributes": {
"persist-selection": true,
"tabs-id": "unique-id for all the tabs together in the container"
},
}
|
Proprietà |
Descrizione |
|---|---|
|
selezione persistente |
Impostare |
|
tabs-id |
Identificazione univoca per tutte le schede presenti nel contenitore. |
Quando imposta md-tabs come persistente (selezione persistente: true), Agent Desktop mantiene la selezione delle schede anche se un agente passa da una pagina all'altra o da un widget sul desktop.
- La proprietà
persist-selectionnon è applicabile alle schede nel riquadro Informazioni ausiliarie e nella pagina dei report delle Statistiche sulle prestazioni dell'agente, poiché il comportamento persistente delle schede è già impostato nel Desktop. - La selezione delle schede viene ripristinata sulla scheda predefinita quando esce dal Desktop, ricarica/aggiorna il browser o cancella la cache del browser.
Configurazione persistente dei widget
Può configurare qualsiasi widget personalizzato in modo che sia persistente. I widget permanenti vengono visualizzati su tutte le pagine del Desktop. I widget permanenti vengono visualizzati come una nuova scheda nel riquadro Informazioni ausiliarie solo quando ha una richiesta di contatto o una conversazione attiva. Ad esempio, il widget Sample Persistent.
I widget permanenti non vengono visualizzati nella Home page nel modo in cui vengono visualizzati nelle altre pagine. Tuttavia, se ha un'interazione attiva, i widget permanenti vengono visualizzati nella home page come parte del riquadro Informazioni ausiliarie. Ad esempio, quando ha risposto a una chiamata, viene visualizzato il riquadro Interaction Control e il widget Sample Persistent viene visualizzato come parte del riquadro Informazioni ausiliarie.
Esempio:
"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]
}
}
}
}
}]
}
]
}
Quando personalizza un widget, può scegliere una delle opzioni:
-
Ospiti un'applicazione su una pagina web che può essere incorporata in un iframe.
-
Crei un widget personalizzato.
I requisiti tecnici dei widget sono descritti nella documentazione sullo sviluppo dei widget per desktop. Come editor di layout, si assicuri di avere questi dettagli:
-
Qual è il nome dell'elemento HTML personalizzato (noto come componente Web)?
-
Qual è l'URL della fonte del Content Delivery Network (CDN) che ospita il pacchetto JavaScript?
Widget dell'intestazione
L'intestazione viene utilizzata per visualizzare informazioni in linea, aggiungere menu a discesa e così via. Poiché il contenitore dell'intestazione ha uno spazio verticale limitato, l'altezza complessiva dell'intestazione è di soli 64 pixel. Per ulteriori informazioni sull'allineamento del layout, vedere la sezione delle proprietà del layout.
Esempio:
"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] }
}
}
Per aggiungere un tooltip per un widget di intestazione, avvolga il componente con md-tooltip. Inserisca le informazioni del tooltip nella proprietà del messaggio.
Esempio:
"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"
}
}]
},
},
}
Deve aggiungere gli attributi di stile display e height per configurare qualsiasi widget tramite iFrame nell'area dei widget personalizzabile nell'intestazione. Il valore di adattamento ottimale dell'attributo height è 64 pixel.
Si assicuri di aggiungere gli attributi di stile ai widget di intestazione esistenti affinché vengano caricati come previsto nell'iFrame.
Esempio:
"head1": {
"comp": "agentx-wc-iframe",
"attributes": {
"src": "https://widget-kad.s3.amazonaws.com/Headers/Timer/Timer.htm",
"style": "height:64px;display:flex;"
}
},
Le consigliamo di utilizzare solo una riga con più colonne per l'intestazione perché l'altezza dell'intestazione è di soli 64 pixel. Per ulteriori informazioni sull'allineamento, vedere la sezione delle proprietà del layout.
Riquadro informazioni ausiliarie
Il riquadro Informazioni ausiliarie del desktop mostra le schede che includono i widget (predefiniti) e i widget personalizzati offerti da Cisco. I seguenti widget offerti da Cisco vengono visualizzati nelle schede predefinite:
-
Cronologia contatti
-
Trascrizione IVR
-
Percorso di esperienza del cliente
-
Screenpop
Può utilizzare il riquadro Informazioni ausiliarie per:
-
Aggiungere schede
-
Modificare l'ordine delle schede
-
Rimuovere le schede predefinite
-
Contrassegna le schede personalizzate come trascinabili
-
Aggiungere suggerimenti alle schede personalizzate
-
Aggiungere l'opzione Reset Tab Order
Esempio:
"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]
}
}
}
}
}]
}
]
},
Può configurare il widget Customer Experience Journey dopo aver abilitato le metriche di gestione dell'esperienza del Management Portal cliente su.
Nel riquadro Informazioni ausiliarie, aggiunga nuove schede per inserire i suoi widget personalizzati. Qui non si applicano regole speciali e l'annidamento dei componenti è come previsto e descritto nella sezione bambini. Per ulteriori informazioni, vedere la proprietà Children della pagina.
I seguenti sono esempi specifici per personalizzare le intestazioni delle sue schede:
Esempio di inserimento di icone ed etichette nella proprietà Children
{
"comp": "md-tab",
"attributes": {
"slot": "tab",
"class": "widget-pane-tab"
},
"children": [{
"comp": "md-icon",
"attributes": {
"name": "transcript_16"
}
},
{
"comp": "span",
"textContent": “My Widget Tab”
}
],
},
Esempio di inserimento di immagini (con CSS) ed etichette nella proprietà Children
{
"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”
}
]
}],
},
L'elenco a discesa Altre schede viene visualizzato automaticamente quando il riquadro Informazioni ausiliarie contiene più schede.
Deve aggiungere un tooltip personalizzato per una scheda per la leggibilità e l'accessibilità. Per aggiungere un tooltip per una scheda personalizzata, avvolga il componente con md-tooltip. Inserisca le informazioni del tooltip nella proprietà del messaggio e applichi i valori delle proprietà di stile come mostrato nell'esempio seguente.
"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;"
},
Per una scheda personalizzata, consigliamo una larghezza massima di 252 pixel e una larghezza minima di 110 pixel.
Per abilitare la funzione drag-and-drop nella scheda personalizzata, aggiunga la seguente proprietà negli attributi:
"comp": "md-tabs",
"attributes": {
"class": "widget-tabs",
"draggable": true,
"comp-unique-id": "sample-dynamic-custom-tabs"
},
-
draggable: Imposta il valore della proprietàdraggablesu true. -
comp-unique-id: Inserisca un valore univoco per identificare il componente.Esempio:
"comp-unique-id": "sample-dynamic-custom-tabs"
Se abilita il trascinamento per una scheda personalizzata, l'agente può trascinare la scheda nella posizione richiesta all'interno del riquadro Informazioni ausiliarie. Per ripristinare l'ordine predefinito delle schede, aggiunga la seguente proprietà:
"comp": "agentx-wc-more-actions-widget",
"attributes": {
"slot": "settings",
"class": "widget-pane",
"tabs-unique-id": "sample-dynamic-custom-tabs"
},
-
agentx-wc-more-actions-widget: Inserisca il componente visualizzato come icona Altre azioni () nel riquadro Informazioni ausiliarie.
-
slot="settings": Enter an attribute within the component that is displayed as the Reset Tab Order option in the More Actions drop-down list. Gli agenti possono reimpostare le schede nel riquadro Informazioni ausiliarie all'ordine predefinito facendo clic su
> Reimposta ordine delle schede. -
tabs-unique-id: Inserisca lo stesso valore univoco definito per la proprietàcomp-unique-id per mappare e reimpostare i componentimd-tabs.
Il seguente codice di esempio utilizza le funzioni Altre azioni e Reimposta ordine di tabulazione.
"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"
}
]
}],
}
Per impostazione predefinita, sono definiti la descrizione comando, l'icona con i puntini di sospensione e il ripristino dell'ordine delle schede predefinite.
L'elenco a discesa Altre azioni può essere esteso per aggiungere ulteriori componenti o widget personalizzati dopo l'opzione Reimposta ordine di tabulazione. Di seguito è riportato un esempio di valori delle proprietà di stile che possono essere applicati a componenti aggiuntivi.
"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;"
},
La funzione drag-and-drop non è supportata per i componenti o i widget personalizzati aggiuntivi aggiunti all'elenco a discesa Altre azioni.
Widget Headless
Nella sezione headless, può aggiungere widget che sono nascosti e non compaiono sul. Agent Desktop Questi widget vengono utilizzati per eseguire la logica in background. Questa sezione è utile per attivare eventi che si verificano sul Desktop ed eseguire la logica specifica del widget. Ad esempio, aprire una schermata CRM personalizzata per ricevere un SMS al suo arrivo.
Esempio:
"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] }
}
}
Condividere i dati dal desktop ai widget
Per ricevere dati in tempo reale tramite proprietà o attributi all'interno di un widget personalizzato, assegni i valori STORE appropriati nella configurazione JSON del layout.
Inoltre, per accedere ai dati tramite gli abbonati JavaScript SDK, può anche passare i dati tramite proprietà o attributi. Se il suo componente è progettato per reagire alle modifiche delle proprietà o degli attributi, riceve aggiornamenti dei dati in tempo reale daAgent Desktop, che si chiama fornitore di dati.
Attualmente, abbiamo un unico fornitore di dati sotto una chiave STORE. Per ulteriori informazioni, vedere la sezione Data Provider—Proprietà e attributi del widget nella Cisco Webex Contact CenterDesktop Developer Guide.
Anteprima della campagna
L'amministratore crea campagne, configura la modalità di chiamata (anteprima) e assegna le campagne ai team. Se un agente fa parte di un team a cui sono assegnate le campagne, può effettuare una chiamata di anteprima della campagna in uscita. Per ulteriori informazioni, vedere Configurare le modalità della campagna vocale in uscita in Webex Contact Center.
L'amministratore configura quanto segue nel layout personalizzato per abilitare il contatto di anteprima della campagna per un agente.
Contatto per la campagna
L'amministratore aggiunge il widget Campaign Contact nel contenitore dell'intestazione del layout personalizzato. Il contatto della campagna mostra le informazioni di contatto del cliente in base alle proprietà definite. Per ulteriori informazioni sull'allineamento del layout, vedere la riga delle proprietà del layout nella tabella Dettagli proprietà della pagina.
Esempio:
"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"
}
]
Guida alle chiamate
Il widget Guida alle chiamate viene visualizzato nel riquadro Informazioni ausiliarie sul desktop. La guida alle chiamate mostra le domande e le risposte a livello di campagna. All'agente viene richiesto di leggere la serie di domande nella guida alle chiamate e inviare le risposte.
Esempio:
"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"
}
]
}
- I seguenti riferimenti alle proprietà
compsono cambiati.agentxnel valore della proprietà è sostituito con acqueon:agentx-preview-campaign viene rinominato acqueon-preview-campaignagentx-call-guide viene rinominato acqueon-call-guide
- Deve ospitare List and Campaign Manager (LCM) su un CDN e quindi specificare l'URL nella proprietà
dello
script.
Screenpop
Nel layout del desktop, può configurare Screen Pop in uno dei seguenti modi:
-
Come pagina personalizzata
-
Come uno dei widget della pagina personalizzata
-
Come scheda nel riquadro Informazioni ausiliarie
Lo Screen Pop viene visualizzato sul desktop in base ai seguenti fattori:
Per il canale Voice:
-
La configurazione definita nel layout del desktop
-
L'attività Screen Pop definita in Flow Designer
Per i nuovi canali digitali:
-
La configurazione definita nel layout del desktop
-
Il nodo Screen Pop definito in Connect Flow Builder
Per ulteriori informazioni sulla configurazione di Screen Pop, veda Screen Pop.
Configurazione di Screen Pop nella barra di navigazione
Può configurare Screen Pop come pagina personalizzata o come uno dei widget in una pagina personalizzata. Per accedere alla pagina personalizzata Screen Pop, faccia clic sull'icona Screen Pop nella barra di navigazione. Per accedere al widget Screen Pop nella pagina personalizzata, faccia clic sull'icona personalizzata nella barra di navigazione. Per ulteriori informazioni sulle proprietà di navigazione, vedere Navigazione (pagine personalizzate).
Esempio: Screen Pop come pagina personalizzata
{
"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"
}
Esempio: Screen Pop come widget nella pagina personalizzata
"comp1": {
"comp": "agentx-wc-screen-pop",
"properties": {
"screenPopUrl": "$STORE.session.screenpop.screenPopSelector"
}
Se lo Screen Pop non è configurato in Flow Designer, la pagina personalizzata appare vuota. Per ulteriori informazioni sulla configurazione di Screen Pop in Flow Designer, vedere Screen Pop.
Configurazione di Screen Pop nel riquadro delle informazioni ausiliarie
Può configurare Screen Pop in modo che appaia come scheda nel riquadro Informazioni ausiliarie.
Per impostazione predefinita, Screen Pop appare come una nuova sottoscheda nella scheda Screen Pop del riquadro Informazioni ausiliarie se Screen Pop è configurato per essere visualizzato come Inside Desktop in Flow Designer.
Aggiungere il seguente attributo nella sezione del pannello per includere Screen Pop come scheda nel riquadro Informazioni ausiliarie. Per ulteriori informazioni sui dettagli del pannello, vedere il riquadro delle informazioni ausiliarie.
Esempio: Screen Pop come scheda nel riquadro delle informazioni ausiliarie
{
"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'opzione di visualizzazione Screen Pop definita in Flow Designer ha la precedenza sulla configurazione definita nel layout del desktop.
Ad esempio, consideri di aver configurato le seguenti impostazioni Screen Pop:
- Flow Designer: visualizza le impostazioni come nella nuova scheda del browser
- Layout del desktop: come scheda nel riquadro Informazioni ausiliarie
Quando si verifica l'evento per il quale è configurato Screen Pop, lo Screen Pop viene visualizzato all'esterno del desktop, cioè in una nuova scheda del browser.
Esempi di casi d'uso
-
Riquadro di informazioni ausiliarie predefinito con cronologia contatti e schermata pop-up
-
Riquadro informativo ausiliario con widget Customer Experience Journey
Configura e accede al widget delle metriche di gestione dell'esperienza del cliente dalla barra di navigazione
Esempio:
{
"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]
}
}
}
},
Per ottenere SpaceID e MetricSid, consulti la documentazione. Webex Experience Management
Utilizzo delle schede nella pagina personalizzata
Esempio:
{
"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]
}
}
}
}
Riquadro di informazioni ausiliarie predefinito con cronologia contatti e schermata a comparsa
Esempio:
"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"
}
},
Riquadro informativo ausiliario con widget Customer Experience Journey
Esempio:
"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"
},
},
Localizzazione
Le lingue supportate sono le seguenti:
Bulgaro, catalano, cinese (Cina), cinese (Taiwan), croato, ceco, danese, olandese, inglese (Regno Unito), inglese (Regno Unito), inglese (Stati Uniti), finlandese, francese, tedesco, ungherese, italiano, giapponese, coreano, norvegese, polacco, portoghese (Brasile), portoghese (Portogallo), rumeno, russo, serbo, slovacco, sloveno, spagnolo, svedese e turco.
La lingua dell'interfaccia utente del desktop si basa sulle impostazioni delle preferenze della lingua del suo browser. Ad esempio, supponiamo che Lei abbia selezionato la lingua preferita come francese nel browser Firefox. Quando avvia il Desktop nel browser Firefox, l'interfaccia utente del desktop viene visualizzata in francese (francese). Tuttavia, l'intestazione orizzontale, la barra di navigazione e gli altri componenti aggiunti nel layout del desktop non sono localizzati in base alle impostazioni delle preferenze della lingua del suo browser.
Localizzare i componenti del desktop
Per localizzare i componenti del desktop,
-
Usa le chiavi di localizzazione esistenti impostate nel
file app.json.Se le chiavi di localizzazione non sono impostate, viene utilizzata la lingua predefinita inglese (Stati Uniti). Può inviare una richiesta di servizio all'assistenza Cisco per aggiungere una chiave di localizzazione alfile app.json.Esempio: chiave di localizzazione
{ "common": { "buttonTitle": "Stop Timer" } } -
Inserisca la seguente proprietà con distinzione tra maiuscole e minuscole nel file JSON di Desktop Layout per localizzare un componente:
"textContent": "$I18N.<key>",dove <key>si riferisce alla chiave di localizzazione corrispondente nel
file app.json.
Esempio: 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",
}
},
},
}
Esempio: localizzare il componente della scheda nel riquadro delle informazioni ausiliarie
"panel": {
"comp": "md-tab",
"attributes": {
"slot": "tab"
},
"children": [{
"comp": "span",
"textContent": "$I18N.panelTwo.screenPopTitle"
}]
}
(





