In questo articolo
Panoramica
dropdown icon
Proprietà di primo livello del layout JSON
    Titolo dell'app
    logo
    Illustrazione della pagina delle attività
    Interrompi la navigazione su AcceptTask
    Drag Drop abilitato
    Timer di notifica
    Numero massimo di notifiche
    Timer di notifica del browser
    Configurato WXM
    App di chat desktop
    Azioni dell'intestazione
    zona
    Intestazione avanzata
dropdown icon
Pagina principale
    Configurazione del layout della home page
dropdown icon
Navigazione (pagine personalizzate)
    Attributi per le schede permanenti
Configurazione persistente dei widget
Widget dell'intestazione
Riquadro informazioni ausiliarie
Widget Headless
Condividere i dati dal desktop ai widget
Anteprima della campagna
Screenpop
Esempi di casi d'uso
Localizzazione

Creare un layout desktop personalizzato

list-menuIn questo articolo
list-menuFeedback?

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:

  1. 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.

  2. 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.

  3. 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.

  4. Area della barra di navigazione: usi questo spazio per aggiungere elementi di navigazione per accedere alle pagine personalizzate.

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.
Esempio di interfaccia utente desktop per Voice
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.
Esempio di interfaccia utente desktop per nuovi canali digitali

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).

Tabella 1. Matrice di visualizzazione per AppTitle e logo in base alla configurazione del layout del desktop
Condizione Esempio Titolo dell'app logo
Se AppTitle e il logo non sono configurati
"appTitle": "",
  "logo": "",
Senza titolo Logo predefinito
Se AppTitle e il logo sono configurati
"appTitle": "ABC Company",
  "logo": "https://my-cdn.com/abclogo.png",
Testo configurato Logo configurato
Se AppTitle è configurato e il logo non è configurato
"appTitle": "ABC Company",
  "logo": "",
Testo configurato Logo predefinito

Se AppTitle non è configurato e il logo è configurato

"appTitle": "",
  "logo": "https://my-cdn.com/abclogo.png",
Senza titolo Logo configurato
Se AppTitle è configurato e il logo non è preferito
"appTitle": "ABC Company",
  "logo": "no-logo",
Testo configurato Nessun logo

Se AppTitle non è configurato e il logo non è preferito

"appTitle": "",
  "logo": "no-logo",
Senza titolo Nessun logo
Se AppTitle viene aggiunto come immagine e il logo è configurato
"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "https://my-cdn.com/abclogo.png",
Immagine configurata Logo configurato

Se AppTitle viene aggiunto come immagine e il logo non è configurato

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "",
Immagine configurata Logo predefinito

Se AppTitle viene aggiunto come immagine e il logo non è preferito

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "no-logo",
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à.

Webex Contact Center interface example of a custom illustration retraining the actual size.
Esempio di illustrazione personalizzata che mantiene le dimensioni effettive
Webex Contact Center interface example of a custom illustration adjusted based on the aspect ratio.
Esempio di illustrazione personalizzata regolata in base alle proporzioni

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

Per ulteriori informazioni sull'attivazione della funzione drag-and-drop per le schede nel riquadro Informazioni ausiliarie, vedere Riquadro delle informazioni ausiliarie.

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.

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 (Utenti > Gestione utenti > Servizi > Messaggistica). Per ulteriori informazioni, vedere Gestire gli account utente in Amministrazione Cisco Webex del sito.

  • Nel layout desktop personalizzato, imposta il valore della proprietà WebExConfigured su 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à WebexConfigurated su true per ciascuno di questi ruoli. L'agente, il supervisore o il supervisorAgent non può disconnettersi dall'app Webex.

    Per visualizzare l'icona icona Webex (Webex) nell'intestazione orizzontale del desktop, inserire il valore webex nella proprietà headerActions. Per ulteriori informazioni, vedere HeaderActions.

    Per abilitare l'app Webex per un team specifico, seleziona il layout personalizzato con il valore della proprietà WebexConfigurated impostato su true. Per ulteriori informazioni, veda Creare un team.

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:

  1. icona Webex(Webex)

  2. Usa il telefono per l'indicatore audio(Chiamata esterna)

  3. Icona di notifica.(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 HeaderActions nel 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 («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.
  • Se il valore della proprietà WebexConfigurated è impostato su false, l'icona dell'app Webex non viene visualizzata nell'intestazione orizzontale del desktop, anche se il valore webex viene aggiunto nella proprietà headerActions. Per ulteriori informazioni, vedere WebExConfigured.

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:

  1. icona Webex(Webex)

  2. Usa il telefono per l'indicatore audio(Chiamata esterna)

  3. Icona di notifica.(Centro notifiche)

  4. Selettore dello stato dell'agente Webex Contact Center.(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à AdvancedHeader nel 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 textContent per 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à WebExConfigurated è impostato su false, l'icona dell'app Webex non viene visualizzata nell'intestazione orizzontale del desktop, anche se il valore webex viene aggiunto nella proprietà AdvancedHeader. Per ulteriori informazioni, vedere WebExConfigured.

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:

Tabella 2. Layout dinamico della home page: proprietà della pagina

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.

  • I widget di grandi dimensioni hanno una risoluzione di 1360 px o più. Per i widget di grandi dimensioni, specifichi il valore della colonna come 12.

  • I widget medi hanno una risoluzione compresa tra 1070 px e 1360 px. Per i widget medi, specifichi il valore della colonna come 10.

  • I piccoli widget hanno una risoluzione compresa tra 850 px e 1070 px. Per i widget di piccole dimensioni, specifichi il valore della colonna come 6.

  • I widget extra piccoli hanno una risoluzione di 500 px. Per widget extra piccoli, specifichi il valore della colonna come 4.

Questi pixel possono variare in base al sistema operativo e al browser.

"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;"
              }
            }
          }

pagina > comp

Si assicuri di fornire un componente personalizzato unico.

"comp": "page-title",

Il componente del titolo della pagina rappresenta l'intestazione <h2>di livello 2 dell'elemento HTML personalizzato.

pagina > PageHeader

Si assicuri di specificare una stringa del titolo che può essere statica, dinamica o entrambe.

Il componente del titolo della pagina rappresenta l'intestazione di livello 2 <h2>nell'elemento HTML personalizzato.

  • Stringa statica: ad esempio, Hey, Welcome!

    "comp": "page-title",
    "attributes": {
        "pageTitle": "Hey, Welcome!"
    }
  • Stringa dinamica: per recuperare il valore dallo STORE. Ad esempio, Jane Doe.

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

  • Entrambi: la combinazione di stringhe statiche e dinamiche. Ad esempio, Hey Jane Doe, benvenuto!

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

    Deve racchiudere la parte dinamica della stringa tra parentesi graffe chiuse {} e prefissarla con la struttura $.

pagina > PageSubheader

Si assicuri di aggiungere il sottotitolo che viene visualizzato sul desktop. L'utente può aggiungere Go to Analyzer nel sottotitolo.

  • Blocco di codice per 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;"
                        }
  • Blocco di codice per Go to Analyzer in Sub Header

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

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:

Tabella 3. nav Dettagli della proprietà

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.

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

La proprietà dell'etichetta è il titolo della pagina personalizzata.

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:

  • MomentumDesign: Può scegliere qualsiasi icona disponibile nella collezione: https://momentum-design.github.io/momentum-design/en/tokens/icons/. Il vantaggio dell' uso di Momentum è che fornisce alcune icone con una versione «attiva».

    Caso d'uso di una versione attiva:

    Ad esempio, se sceglie un annuncio di tipo icona Momentum, può vedere l'icona predefinita nella barra di navigazione. Quando accede alla pagina personalizzata (collegata all'icona), l'icona passa automaticamente alla versione con annuncio attivo. Si assicuri di verificare se ha una versione attiva della stessa icona nella libreria delle icone.

  • Altro: Può fornire un URL di immagine personalizzato (ospitato su un CDN) che appare sulla barra di navigazione. Se usa un'icona personalizzata bianca o nera, l'icona non è visibile quando passa dalla modalità chiara a quella scura.

nav > icona

Questa proprietà rappresenta il nome dell'icona nella libreria Momentum o nell'URL del CDN.

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

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.

type Navigation.Item = {
    navigateTo: “my - custom - page”;
};
Tabella 4. pagina Dettagli della proprietà

Proprietà

Descrizione e codice

pagina > id

Nella proprietà della pagina, specifica l'oggetto pagina personalizzata (widget dinamico).

La proprietà id rappresenta un identificatore di pagina univoco. Ad esempio, my-custom-page-1. L'agente non riesce a vedere questo identificatore sul desktop.

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

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.

  • I widget di grandi dimensioni hanno una risoluzione di 1360 px o più. Per i widget di grandi dimensioni, specifichi il valore della colonna come 12.

  • I widget medi hanno una risoluzione compresa tra 1070 px e 1360 px. Per i widget medi, specifichi il valore della colonna come 10.

  • I piccoli widget hanno una risoluzione compresa tra 850 px e 1070 px. Per i widget di piccole dimensioni, specifichi il valore della colonna come 6.

  • I widget extra piccoli hanno una risoluzione di 500 px. Per widget extra piccoli, specifichi il valore della colonna come 4.

Questi pixel possono variare in base al sistema operativo e al browser.

"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;"
              }
            }
          }

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.

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

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:

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;
    };
};

pagina > script

(Facoltativo) Questa proprietà è richiesta solo quando carica il widget o il componente da una postazione remota come un CDN.

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

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:

  • Informi l'agente di svuotare la cache del browser e ricaricare ilAgent Desktop.

  • Conservi l'URL esistente. Importa dinamicamente il nuovo URL del pacchetto utilizzando il javascript ospitato nell'URL esistente.

    Esempio:

    (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);
    
                } ) ()

pagina > proprietà

Può specificare le proprietà che deve passare per il componente Web.

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

pagina > reattivo

Determina se un componente web o un widget basato su iFrame aggiunto nel layout personalizzato a livello di pagina o a livello di composizione è reattivo. I componenti web reattivi rendono la sua pagina web visivamente accattivante su tutti i dispositivi e sono facili da usare. Deve usare widget iFrame reattivi.

Configura questa proprietà con uno dei seguenti valori:

  • Vero: abilita la reattività del widget. Per impostazione predefinita, tutti i widget sono reattivi in base alle dimensioni progressive dello schermo, all'orientamento e alle aree di visualizzazione del dispositivo in uso.

  • Falso: disabilita la reattività del widget. Se i widget non supportano la visualizzazione su dispositivi diversi, contrassegnali come non rispondenti.

{
    "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"
},

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.

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

pagina > visibilità

Specifica se i widget offerti da Cisco aggiunti nel layout personalizzato a livello di pagina o a livello di composizione sono visibili o meno.

I widget offerti da Cisco sono Cronologia contatti, trascrizione IVRCisco Webex Experience Management, Preview Campaign Call Guide e Screen Pop.

  • I valori delle proprietà di visibilità sono integrati e definiti nel file JSON predefinito di Desktop Layout. L'amministratore non può modificare i valori delle proprietà di visibilità dei widget offerti da Cisco.

  • Il valore della proprietà di visibilità NOT_RESPONSIVE è obsoleto. Può continuare a usarlo solo per la compatibilità con le versioni precedenti. Qualsiasi valore impostato come NOT_RESPONSIVE in precedenza non richiede modifiche, poiché la funzionalità rimane la stessa.

    Per impostare un widget appena creato come reattivo o non reattivo, deve utilizzare la proprietà responsive. Per ulteriori informazioni, vedere la proprietà reattiva.

pagina > bambini

Questa proprietà è la parte principale del layout. Nella sezione bambini, può inserire tutti i livelli necessari se il widget basato su Web Component Le consente di superare i bambini. Per renderlo possibile, lo sviluppatore deve gestire in modo programmatico i contenuti suddivisi. Per ulteriori informazioni, consulti la Cisco Webex Contact CenterDesktop Developer Guide.

Per sapere come passare i valori STORE come proprietà, vedere Condividere dati dal desktop ai widget.

"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"
            }
        ]
    }
],

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:

  • agentx-wc-iframe: Un widget che Le consente di inserire qualsiasi pagina web in un iFrame come widget.

  • area dinamica: Un componente che Le consente di abilitare la funzione drag-and-drop per gli agenti in un posto diverso dalle pagine personalizzate. Le pagine personalizzate possono avere questa funzionalità anche se abilita il drag-and-drop per impostazione predefinita.

  • Qualsiasi componente della libreria momentum-ui-web-component. Per ulteriori informazioni, vedere GitHub. Ad esempio:

    • md-tabs: involucro per contenitori Tabs

    • md-tab: Intestazione a scheda singola

    • md-tab-panel: contenuto a scheda singola

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.

"textContent": "My Text Content",

pagina > stile

La aiuta ad assegnare un particolare stile CSS al suo componente.

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

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 Ingrandisci l'icona (Ingrandisci) nella parte superiore del widget. Quando il widget ha occupato un piccolo spazio sulla pagina, l'icona di ingrandimento consente all'agente di vedere il widget nell'area di lavoro completa.

Si assicuri di utilizzare il valore predefinito come «app-maximize-area». Attualmente, è disponibile solo il valore predefinito. Se il layout è configurato utilizzando useFlexLayout, può abilitare l'icona massimizza/ripristino nell'intestazione del widget aggiungendo l'attributo isMaximizable alla configurazione del widget e impostandone il valore su true.

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

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à id del wrapper del widget come unique-id-to-update-title.

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

Per aggiornare il titolo del widget basato su iFrame, usi il contenuto iFrame dello stesso dominio. Quello che segue è un esempio:

<
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>

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».

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

pagina > impaginazione

Le permette di disporre i widget su una pagina.

Il seguente formato rappresenta un layout a griglia:

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

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:

"layout": {
    "areas": [
        [
            "comp1",
            "comp1",
            "comp3"
        ],
        [
            "comp2",
            "comp2",
            "comp3"
        ],
        [
            "comp4",
            "comp4",
            "comp4"
        ]
    ],
    "size": {
        "cols": [1, 1, 1],
        "rows": [1, 1, 1]
    }
}
Distribuzione equa di un layout 3x3
Equal distribution of a 3x3 layout for Webex contact Center Desktop layout configuration.

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.

Con la stessa larghezza della colonna
Equal column width layout for Webex Contact Center Desktop layout configuration.

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.

Unequal column width layout for Webex Contact Center Desktop layout configuration.
Dopo aver modificato la larghezza della colonna

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.

{
    "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]
            }
        }
    }
}

Questa configurazione crea una griglia nel layout ROOT con due griglie secondarie che può ridimensionare indipendentemente.

Sub-layout appearance for Webex Contact Center Desktop layout configuration.
Aspetto del sub-layout

Il ridimensionamento di un componente influisce sui componenti all'interno di quel sublayout.

Sub-layout appearance, after resizing both sub-layouts, for Webex Contact Center Desktop layout configuration.
Dopo aver ridimensionato entrambi i sotto-layout

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.

{
    "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.
Layout secondario con loop 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.

{
    "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.
Layout secondario con N volte

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 md-tabs in modo che sia persistente. Il valore predefinito è true.

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-selection non è 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à draggable su 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. Icona Altre azioni

  • 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 Icona Altre azioni > Reimposta ordine delle schede.

  • tabs-unique-id: Inserisca lo stesso valore univoco definito per la proprietà comp-unique-id per mappare e reimpostare i componenti md-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"
        }
    ]
}],

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

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;"
},
Webex Contact Center more actions menu example, showing additional, custom options that can be added after the 'Reset Tab Order' option.

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à comp sono cambiati. agentx nel valore della proprietà è sostituito con acqueon:
    • agentx-preview-campaign viene rinominato acqueon-preview-campaign
    • agentx-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

Le seguenti sezioni forniscono alcuni esempi a titolo di riferimento:

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

L' interfaccia utente desktop supporta la localizzazione in 29 lingue.

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 al file 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"
    }]
}
Questo articolo è stato utile?
Questo articolo è stato utile?