I denne artikkelen
Oversikt
dropdown icon
Egenskaper for toppnivå for JSON-layout
    Apptittel
    logo
    OppgavesideIllustrasjon
    StopNavigateOnAcceptTask
    DragDropEnabled
    Varslingstimer
    Maksimalt antall varslinger
    NettleserNotificationTimer
    wxmKonfigurert
    DesktopChatApp
    OverskriftHandlinger
    området
    Avansert Header
dropdown icon
Hjemmesiden
    Startsideoppsettkonfigurasjon
dropdown icon
Navigering (egendefinerte sider)
    Attributter for vedvarende faner
Konfigurasjon av vedvarende widgeter
Header Widgets
Hjelpeinformasjonsrute
Hodeløse Widgets
Del data fra skrivebordet til widgeter
Forhåndsvisning av kampanjeanrop
Skjermpop
Eksempel på eksempler på brukstilfeller
Lokalisering

Opprett egendefinert skrivebordsoppsett

list-menuI denne artikkelen
list-menuTilbakemelding?

Denne artikkelen hjelper deg med å lage et tilpasset layout ved å redigere en JSON-fil og tilbyr eksempler på brukstilfeller for å hjelpe deg i gang med widgeter som Customer Experience Management Metrics widget og Customer Experience Journey widget. For å effektivt jobbe med tilpassede skrivebordsoppsett, bør du ha en solid forståelse av HTML-struktur, dokumenttremodellen i en nettleser og JSON-formatet.

Oversikt

Funksjonen Desktop Layout lar deg konfigurere Webex Contact Center Desktop i henhold til forretningskravene dine. Du kan tilpasse elementer som logo, tittel og widgets. Du kan opprette et skrivebordsoppsett og tilordne det til et team. Denne layouten genererer agentopplevelsen på skrivebordet for alle agenter som logger på som en del av teamet.

Det finnes to typer oppsett:

  • Global layout: Denne layouten er en systemgenerert layout som tilordnes som standard når du oppretter et team. Hvis du vil ha mer informasjon, kan du se Administrer team. Når du oppretter et team, angis Global Layout automatisk som skrivebordsoppsett for teamet. Du kan ikke slette dette oppsettet.

  • Egendefinert layout: En layout som gir en tilpasset skrivebordsopplevelse. Du kan opprette en egendefinert layout for ett eller flere team.

Hvis du tilordner et nytt skrivebordsoppsett når en agent er logget på, må agenten laste inn siden på nytt for å se den nye layouten.

Webex Contact Center Desktop støtter tre personas:

  • Agent

  • Veileder

  • Veileder og agent

JSON-layoutfilen har separate seksjoner for hver av personene. Administratoren bør konfigurere innstillingene for hver persona i den tilsvarende delen av JSON- layoutfilen. Hvis du vil ha mer informasjon om en eksempel på en JSON-layoutfil, kan du se Egenskaper for toppnivå for JSON-layout.

Når Cisco legger til en ny funksjon i skrivebordsoppsettet, oppdateres den umodifiserte layouten automatisk med de nye funksjonene. Den oppdaterte skrivebordsoppsettet er automatisk tilgjengelig for de eksisterende teamene som bruker det umodifiserte skrivebordsoppsettet. Skrivebordsbrukere som bruker det umodifiserte skrivebordsoppsettet, mottar de nye layout-baserte funksjonene når de logger på eller laster inn nettleseren på nytt.

Hvis du bruker Def ault Desktop Layout.json- filen uten noen endring, regnes den som en umodifisert layout. Hvis du imidlertid laster ned Standard Desktop Layout.json- filen og laster den opp igjen, regnes den som en endret layout selv om filinnholdet eller filnavnet ikke er endret.

For team som bruker et egendefinert skrivebordsoppsett, må administratorer periodisk oppdatere layoutdefinisjonen for å inkludere nye funksjoner. Når administratorer viser en umodifisert layout eller et team som bruker en umodifisert layout, vises en melding som indikerer at nye skrivebordsfunksjoner brukes automatisk.

I skrivebordet er det to typer widgeter - iframe-basert og webkomponentbasert. Toppteksten, navigasjonen (egendefinert side), vedvarende område, hodeløst område og aux-panelet er det tilpassbare området på et skrivebord. Dette er ikke widgets.

Følgende liste beskriver mellomrommene du kan konfigurere. Bildene illustrerer utformingen av skrivebordet:

  1. Tittel- og logo-området: Dette området viser Webex Contact Center-logoen og navnet (standard) øverst til venstre på skjermen.

  2. Horisontalt topptekstområde: Dette området har et konfigurerbart område som er fylt med egendefinerte widgeter. Disse widgetene kan for eksempel vise innebygd informasjon og rullegardinmenyer. Siden høyden på denne overskriften bare er 64 piksler, kan ikke widgethøyden krysse toppteksthøyden.

  3. Arbeidsområde: Dette området endres i henhold til valget på navigasjonslinjen eller når en agent samhandler med kunder. Når en agent er i anrop, viser dette området ruten for interaksjonskontroll og tilleggsinformasjon (som inkluderer egendefinerte widgeter og vedvarende widgeter). Når en agent samhandler på e-post, chat eller sosiale kanaler, viser dette området arbeidsområdet og tilleggsinformasjonsruten (som inkluderer det vedvarende widgetområdet).

    Egendefinert side vises på skrivebordsgrensesnittet i arbeidsområderuten. Du kan få tilgang til den tilpassede siden gjennom ikoner på navigasjonslinjen. Hver egendefinerte side kan inneholde en eller flere egendefinerte widgeter.

    Custom Widget er et tredjepartsprogram som er konfigurert i JSON-oppsettet. Du kan plassere den egendefinerte widgeten på den egendefinerte siden, den egendefinerte fanen (Hjelpeinformasjon-ruten) eller på den horisontale overskriften på skrivebordet.

  4. Navigasjonslin jeområdet: Bruk denne plassen til å legge til navigasjonselementer for å få tilgang til egendefinerte sider.

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.
Eksempel på skrivebordsgrensesnitt for stemme
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.
Eksempel på skrivebordsgrensesnitt for nye digitale kanaler

Egenskaper for toppnivå for JSON-layout

Roller

Standard JSON-oppsett har følgende tre roller.

  • Agent—for å angi at skrivebordsoppsettet skal vises når en agent logger på Webex Contact Center Desktop for å håndtere agentaktiviteter.

  • Veileder — for å angi at skrivebordsoppsettet skal vises når en veileder logger på Webex Contact Center Desktop for å håndtere kun veilederfunksjoner.

    Når en veileder logger på skrivebordet, brukes skrivebordsoppsettet som er angitt for det primære teamet. Hvis du ikke oppgir et primærteam, gjelder den globale layouten. Som standard er APS-rapporter deaktivert.

  • SupervisorAgent—for å angi at skrivebordsoppsettet skal vises når en veileder logger på Webex Contact Center Desktop for å håndtere både veilederfunksjoner og agentaktiviteter.

Du kan enten legge til eller endre widgets for hver rolle i den tilsvarende personaen til den relevante JSON-layoutfilen.

Følgende er egenskapene på toppnivå for JSON-layout basert på rollen:

{
    "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": {
                ...
            }
        },
    }
},
  • Endringene som er gjort i JSON-layoutegenskapene trer i kraft når skrivebordsnettleseren oppdateres.
  • Hvis en funksjon du har aktivert i JSON-layout, ikke er tilgjengelig på skrivebordet, kontakter du Cisco-kundestøtte for å aktivere funksjonen.
  • Alle egenskapene i JSON-layouten skiller mellom store og små bokstaver.

Apptittel

Slik angir du en tittel på den horisontale overskriften på skrivebordet. Standardtittelen er Webex Contact Center.

Eksempel:

"appTitle": "Webex Contact Center"

Standard AppTitle endres fra Contact Center Desktop til Webex Contact Center. Det påvirker ikke eksisterende egendefinerte oppsett som bruker den gamle standard AppTitle (Contact Center Desktop). Hvis du vil bruke den nye AppTitle, må du endre den egendefinerte layouten. Den nye globale layouten bruker imidlertid standard AppTitle som Webex Contact Center.

Tittelen kan enten være tekst, et bilde eller en tom streng. Tittelteksten vises i to rader. Hvis teksten strekker seg utover den andre raden, vises et ellipseikon, og verktøytipset viser hele tittelen. Stiler kan ikke brukes på tittelen.

Du kan enten bruke data-URIer (Uniform Resource Identifier) eller være vert for et tilpasset tittelbilde på et innholdsleveringsnettverk (CDN), Amazon Web Services (AWS) Simple Storage Service (S3) -bøtte eller en lignende vertstjeneste, og deretter angi URL-en til det vertsbaserte bildet. De støttede tittelbildeformatene er PNG, JPG, JPEG, GIF, SVG og WebP. Den støttede tittelbildestørrelsen er 184 x 32 piksler (bredde x høyde).

logoen

For å spesifisere en URL for firmalogoen. Hvis du ikke oppgir en nettadresse, vises Webex Contact Center-logoen som standard.

Eksempel:

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

Du kan være vert for et egendefinert logobilde på en CDN, Amazon Web Services (AWS) Simple Storage Service (S3) -bøtte eller en lignende vertstjeneste, og deretter angi URL-en til det vertsbaserte bildet. De støttede logo-bildeformatene er PNG, JPG, JPEG, GIF, SVG og WebP. Den støttede logobildestørrelsen er 96 x 32 piksler (bredde x høyde).

Tabell 1. Vis matrise for AppTitle og logo Basert på konfigurasjonen av skrivebordsoppsett
Tilstand Eksempel Apptittel logoen
Hvis AppTitle og logo ikke er konfigurert
"appTitle": "",
  "logo": "",
Ingen tittel Standard logo
Hvis AppTitle og logo er konfigurert
"appTitle": "ABC Company",
  "logo": "https://my-cdn.com/abclogo.png",
Konfigurert tekst Konfigurert logo
Hvis AppTitle er konfigurert og logoen ikke er konfigurert
"appTitle": "ABC Company",
  "logo": "",
Konfigurert tekst Standard logo

Hvis AppTitle ikke er konfigurert og logoen er konfigurert

"appTitle": "",
  "logo": "https://my-cdn.com/abclogo.png",
Ingen tittel Konfigurert logo
Hvis AppTitle er konfigurert og logo ikke foretrekkes
"appTitle": "ABC Company",
  "logo": "no-logo",
Konfigurert tekst Ingen logo

Hvis AppTitle ikke er konfigurert og logo ikke foretrekkes

"appTitle": "",
  "logo": "no-logo",
Ingen tittel Ingen logo
Hvis AppTitle legges til som et bilde og logoen er konfigurert
"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "https://my-cdn.com/abclogo.png",
Konfigurert bilde Konfigurert logo

Hvis AppTitle legges til som et bilde og logoen ikke er konfigurert

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "",
Konfigurert bilde Standard logo

Hvis AppTitle legges til som et bilde og logo ikke foretrekkes

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "no-logo",
Konfigurert bilde Ingen logo
  • Den egendefinerte bildestørrelsen justeres basert på sideforholdet. Den egendefinerte tittel teksten som er konfigurert tidligere, kan nå vises i to rader på skrivebordet. For å unngå dette kan du endre den egendefinerte tittelteksten.
  • Hvis tittel og logo ikke er konfigurert i den horisontale overskriften på skrivebordet, brukes denne plassen av topptekstwidgetene. Overskrifts-widgetene må konfigureres riktig for å bruke tittel- og logoområdet.
  • Tittelen og logoen sammen kan ikke overstige den maksimale bredden på 304 piksler (inkludert polstring). Hvis logobredden er mindre enn 96 piksler, kan den gjenværende bredden brukes til tittelen.
  • Hvis den egendefinerte bildestørrelsen er høyere enn den støttede størrelsen, justeres bildestørrelsen basert på sideforholdet i den horisontale overskriften. Hvis den egendefinerte bil destørrelsen er mindre enn den støttede størrelsen, beholdes den faktiske bildestørrelsen i den horisontale overskriften.

OppgavesideIllustrasjon

Slik angir du en egendefinert illustrasjon for oppgavesiden basert på organisasjonspreferanser og merkevarejustering. Når en agent logger på, viser oppgavesiden den konfigurerte illustrasjonen som bakgrunn. Som standard vises oppgavesiden uten illustrasjon.

Eksempel:

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

Du kan enten bruke data-URIer eller være vert for en egendefinert illustrasjon på et innholdsleveringsnettverk (CDN), Amazon Web Services (AWS) Simple Storage Service (S3) -bøtte eller en lignende vertstjeneste, og deretter angi URL-en til den vertsbaserte illustrasjonen. Illustrasjonen kan konfigureres på globalt nivå eller teamnivå basert på layoutdefinisjonen. Sørg for å konfigurere riktig URL for å forhindre at det ødelagte bildet vises på skrivebordet.

De støttede formatene for oppgavesideillustrasjon er PNG, JPG, JPEG, GIF, SVG og WebP. Anbefalt illustrasjonsstørrelse er 400 x 400 piksler (bredde x høyde). Hvis den egendefinerte illustrasjonsstørrelsen er større enn anbefalt størrelse, justeres illustrasjonsstørrelsen basert på sideforholdet på oppgavesiden. Hvis den egendefinerte illustrasjonsstørrelsen er mindre enn anbefalt størrelse, beholdes den faktiske illustrasjonsstørrelsen på oppgavesiden.

Webex Contact Center interface example of a custom illustration retraining the actual size.
Eksempel på en egendefinert illustrasjon som beholder den faktiske størrelsen
Webex Contact Center interface example of a custom illustration adjusted based on the aspect ratio.
Eksempeleksempel for en egendefinert illustrasjon justert basert på sideforholdet

StopNavigateOnAcceptTask

Slik avgjør du om fokuset skal flyttes til en nylig akseptert oppgave når agenten godtar den nye oppgaven mens han arbeider med en tidligere oppgave. Standardverdien er falsk.

Eksempel:

"stopNavigateOnAcceptTask": false

Hvis verdien er angitt som sann, når brukeren godtar en ny oppgave på skrivebordet, beholdes fokuset på forrige oppgave og flyttes ikke til den nylig godkjente oppgaven. Denne innstillingen forhindrer at brukeren mister data når han godtar en ny forespørsel.

Tenk for eksempel på at agent 1 er i chat med kunde 1 og samtidig i et taleanrop med kunde 2. Under taleanropet oppdaterer Agent 1 detaljene for kunde 2 i Interaksjonskontroll-ruten. For øyeblikket har Agent 1 to aktive oppgaver i Oppgaveliste-ruten, og fokuset er på Interaksjonskontrollruten. Når agent 1 godtar en ny chat-forespørsel fra kunde 3, forblir fokuset på Interaksjonskontroll-ruten med kunde 2 og flyttes ikke til den nylig godkjente chat-forespørselen.

Hvis du vil beholde fokuset på forrige oppgave og ikke skifte til den nylig godkjente oppgaven, velger du den egendefinerte layouten med egenskapen stopNavigateOnAcceptTask satt til true.

Hvis egenskapen stopNavigateOnAcceptTask ikke er angitt i JSON-layouten, flytter skrivebordet fokus til den nylig godkjente oppgaven. Virkemåten er lik når egenskapen stopNavigateOnAcceptTask er satt til false.

  • Innstillingen gjelder for alle oppgaver (talekanaler og digitale kanaler) som utføres på skrive bordet, for eksempel å godta en oppgave, konferanse, konsultasjon eller overføring, og for utgående samtaler, utgående kampanjesamtaler, automatisk avslutning osv.
  • Innstillingen gjelder ikke hvis skrivebordsbrukeren er på startsiden, uten noen aktiv oppgave i Oppgaveliste-ruten. I et slikt tilfelle, når en ny oppgave godtas, flyttes fokuset fra start siden til den nylig godkjente oppgaven.

DragDropEnabled

Hvis du vil aktivere dra-og-slipp og endre størrelse på widgetene på de egendefinerte sidene, angir du verdien til true. Standardverdien er falsk.

Eksempel:

"dragDropEnabled": false

Hvis du vil ha mer informasjon om hvordan du aktiverer dra-og-slipp-funksjonen for kategoriene i ruten Hjelpeinformasjon, kan du se Ruten for tilleggsin form asjon.

Varslingstimer

For å angi varigheten (i sekunder), hvoretter skrivebordsvarslene på skrivebordet automatisk avvises. Varselet vises øverst til høyre på skrivebordet. Standard tidsavbruddsverdi er 8 sekunder. Det gyldige området for tidsavbruddsverdier er 1-10 sekunder. For at tidsavbruddendringene skal tre i kraft, må nettleseren oppdateres etter at endringene er gjort.

Eksempel:

"notificationTimer": 8

Maksimalt antall varslinger

Slik angir du antall skrivebordsvarsler som skal vises om gangen på skrivebordet. Standardverdien er 3. Rekkevidden for skrivebordsvarsler er 1-10. Skrivebordsvarslene er stablet. Hvis det er mange varsler, vises de med en liten forsinkelse avhengig av NotificationTim er-innstillingene.

Eksempel:

"maximumNotificationCount": 3

NettleserNotificationTimer

Slik angir du varigheten (i sekunder), hvoretter nettleserens brødristervarsler på skrivebordet automatisk avvises. Brødrister er et innebygd nettleservarsel som bare vises hvis skrivebordet ikke er det aktive nettleservinduet eller fanen. Nettleservinduet eller fanen Desktop er inaktiv når

  • Du jobber med andre nettleservinduer eller faner.

  • Du jobber med andre applikasjoner.

  • Du har minimert skrivebordsnettleservinduet.

Varselet vises øverst til høyre på skrivebordet. Standard tidsavbruddsverdi er 8 sekunder. Det anbefalte området for tidsavbruddsverdier er 5-15 sekunder. For at tidsavbruddendringene skal tre i kraft, må nettleseren oppdateres etter at endringene er gjort.

Eksempel:

"browserNotificationTimer": 8

Den konfigurerte tidsavbruddet for nettleservarsler avhenger av operativsystemet og nettleserinnstillingene. Tidsavbruddsverdien respekteres i Chrome-nettleseren på tvers av Windows OS, Chrome OS og macOS. De andre støttede nettleserne respekterer imidlertid ikke den konfigurerte tidsavbruddsverdien for varsling konsekvent.

wxmKonfigurert

(Valgfritt) Hvis du Webex Experience Management vil konfigurere, angir du verdien til true. Standardverdien er falsk.

Eksempel:

"wxmConfigured": true

DesktopChatApp

Slik konfigurerer du flere Cisco-tilbudte chat-applikasjoner, for eksempel Webex App.

WebExkonfigurert

Webex-appen sammen med meldings- og møtefunksjonene kan konfigureres på skrivebordet. Denne konfigurasjonen lar agenter samarbeide med andre agenter, veiledere og fageksperter (SMB) i organisasjonen uten å navigere vekk fra skrivebordet.

Slik konfigurerer du Webex-appen på skrivebordet:

  • Når du Cisco Webex Control Hub legger til tjenester for en bruker, merker du av for Avan serte meldinger (Bru kere > Administrer brukere > T jenester > Mel dinger). Hvis du vil ha mer informasjon, kan du se Administrer brukerkontoer i Cisco Webex områdeadministrasjon.

  • I den egendefinerte skrivebordslayouten angir du egenskapverdien WebExConfigu red til true.

    Eksempel:

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

    Standardverdien for egenskapen WebExConfigured er falsk.

    Webex App er bare tilgjengelig for agent-, veileder- og SupervisorAgent-rollene hvis du angir egenskapverdien WebExConfigured til true for hver av disse rollene. Agenten, veilederen eller SupervisorAgent kan ikke logge av Webex-appen.

    Hvis du vil vise ikonet Webex-ikonet (Webex) på den horisontale overskriften på skrivebordet, skriver du inn verdien webex i egenskapen HeaderActions. Hvis du vil ha mer informasjon, kan du se He aderActions.

    Hvis du vil aktivere Webex-appen for et bestemt team, velger du den egendefinerte layouten med egenskapen WebExConfigured satt til true. Hvis du vil ha mer informasjon, kan du se Opprette et team.

Du kan konfigurere Webex-appen i ruten Hjelpeinformasjon, egendefinert side og egendefinert widget også. Hvis du vil ha mer informasjon, kan du se Hjelpeinformasjonsruten.

Webex-appvarsling

Verdiene som er angitt ved hjelp av egenskapene NotificationTim er og BrowserNotificationTim er for varslingstimeren, gjelder for Webex-appen. Standard tidsavbruddsverdi er 8 sekunder for disse egenskapene. Hvis du vil ha mer informasjon, kan du se NotificationTimer og BrowserNotificationTimer.

OverskriftHandlinger

For å endre rekkefølgen på ikonene på den horisontale overskriften på skrivebordet. Standardrekkefølgen er som følger:

  1. Webex-ikonet(Webex)

  2. Bruk telefon for lydindikator(Utendørsanrop)

  3. Varslingsikon.(Varslingssenter)

Angi verdien for egenskapen He aderActions som følger:

Ikonnavn

Eiendomsverdi for headerActions

Webex-appen

webex

Utendørsanrop

utendørs

Varslingssenter

melding

Eksempel:

«HeaderActions»: ["webex», «outdial», «varsling"],

Egenskapsverdien HeaderActions skiller mellom store og små bokstaver.

Hvis du vil endre standardrekkefølgen på ikonene, angir du egenskapen HeaderActions og verdiene i den egendefinerte layouten tilsvarende.

Eksempel:

«HeaderActions»: ["varsling», «outdial», «webex"],
  • Hvis du ikke angir HeaderAction s-egenskapen og verdiene i den egendefinerte layouten, vises ikonene i standardrekkefølgen.
  • Hvis du vil fjerne topptekstikonene og tilhørende funksjoner fra skrivebordet, angir du en tom verdi for egenskapen He aderActions («HeaderActions»: []). Hvis du imidlertid har lagt til Webex-appen i ruten Hjelpeinformasjon eller en egendefinert side, eller som en egendefinert widget, kan agenten fortsatt få tilgang til Webex-appen, selv om Webex-appen ikke er tilgjengelig i den horisontale overskriften på skrivebordet.
  • Hvis egenskapen Web ExConfigur ed er angitt som falsk, vises ikke Webex App- ikonet på den horisontale overskriften på skrivebordet, selv om webex- verdien legges til i egenskapen HeaderActions. Hvis du vil ha mer informasjon, kan du se WebExConfigured.

område

Om rådeegenskapen er kjerneseksjonen i skrivebordslayouten. Du kan definere oppsettet i henhold til området.

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

Du kan konfigurere følgende område objekter:

  • Panel: Representerer det andre panelet eller panelet lengst til høyre i ruten Hjelpeinformasjon.

  • Navigering: Representerer egendefinerte sider og deres navigasjonselementer som er relatert til sidene.

  • Vedvarende: Representerer widgetene på sidenivå som er vedvarende og vises på alle sider på skrivebordet.

  • Hodeløs: Representerer widgetene som ikke har et visuelt grensesnitt, men utfører logikk i bakgrunnen.

Hvis egenskapen AdvancedHeader er konfigurert, må egenskapene header og HeaderActions fjernes.

Avansert Header

For å tilpasse synligheten og endre rekkefølgen på ikonene på den horisontale overskriften på skrivebordet. Standardrekkefølgen er som følger:

  1. Webex-ikonet(Webex)

  2. Bruk telefon for lydindikator(Utendørsanrop)

  3. Varslingsikon.(Varslingssenter)

  4. Webex Contact Center agenttilstandsvelger.(Agenttilstandsvelger)

Angi verdien for egenskapen AdvancedHeader som følger:

Ikonnavn

Eiendomsverdi for headerActions

Webex-appen

agentx-webex

Utendørsanrop

agentx-outdial

Varslingssenter

agentx-varsling

Agenttilstandsvelger

agentx-tilstandsvelger

Eksempel:

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

Egenskapsverdien AdvancedHeader skiller mellom store og små bokstaver.

Hvis du vil endre standardrekkefølgen på ikonene, angir du egenskapen AdvancedHeader og verdiene i den egendefinerte layouten tilsvarende.

Widgetene flyter inn i rullegardinmenyen fra venstre til høyre.

  • Hvis du ikke angir egenskapen AdvancedHeader i den egendefinerte layouten, vises standardoverskriften.

  • Når avansert overskrift er aktivert, bør du flytte widgetene fra den eksisterende overskriften til den avanserte overskriften i henhold til eksemplet.

  • Når avansert overskrift er aktivert, vises ikke gammel topptekst.

  • Hvert widgetikon har en standard polstring og margin som er definert gjennom CSS og kan ikke tilpasses via skrivebordet.

  • Plasseringen av logoen, tittel, og profilikonene er faste og kan ikke tilpasses.

  • Hvis du vil fjerne topptekstikonene og tilhørende funksjoner fra skrivebordet, angir du en tom verdi for den tilknyttede komponenten i egenskapen AdvancedHeader («Advanced Header»: []).

    Hvis du har lagt til Webex-appen i ruten Hjelpeinformasjon eller en egendefinert side, eller som en egendefinert widget, kan agenten fortsatt få tilgang til Webex-appen, selv om Webex-appen ikke er tilgjengelig i den horisontale overskriften på skrivebordet.

  • Hvis du legger til en widget med en lang etikett, vises et avkortet etikettnavn i henhold til ledig plass.

    Du kan bruke attributtet TextContent til å legge til en etikett i en widget.

    Eksempel:

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

    Etiketten «Count Down Timer for Current Shift» vil bli avkortet og vist i henhold til ledig plass.

    • Unngå å legge til widgets med en lang etikett.

    • Når en widget flyter til rullegardinmenyen, er det bare widgetikonet som er klikkbart.

  • Hvis egenskapen Web ExConfigur ed er angitt som falsk, vises ikke Webex App- ikonet på den horisontale overskriften på skrivebordet, selv om webex- verdien legges til i AdvancedHeader egenskapen. Hvis du vil ha mer informasjon, kan du se WebExConfigured.

Hjemmesiden

Når du logger på skrivebordet, lander du på hjemmesiden.

Hjemmesiden gjelder bare for veiledere og SupervisorAgent-persona.

Du kan se følgende widgeter på hjemmesiden. Analyzer widgets leveres som standard, men administratoren kan også konfigurere vedvarende og tilpassede widgets. Hvis du vil ha mer informasjon, kan du se Egenskaper for toppnivå for JSON-layout.

Analyser-widgeter

Som standard vises Analyzer-widgeten på startsiden for skrivebordet.

Startsideoppsettkonfigurasjon

Du kan konfigurere startsiden på skrivebordet til å vise layout som er basert på organisasjonens preferanser og merkevarejustering. Rediger Hjemmesidefeltet for å konfigurere hjemmesiden. Du kan konfigurere følgende komponenter som skal vises på hjemmesiden når en bruker logger på skrivebordet:

  • En velkomstmelding

  • Opp gave- ikonet på navigasjonslinjen for å navigere til Oppgave-ruten. Opp gave- ikonet vises for rollen Veileder og Veileder og agent med funksjonen for anropsovervåking aktivert. Oppgaveruten viser innkommende kundeforespørsler, aktive og tidligere kundeinteraksjoner og aktive overvåkningsforespørsler.

  • Filtrer seksjoner som kønavn, kanaltype og administrerte team.

Tabellen nedenfor beskriver side egenskapene som kreves for å konfigurere hjemmesiden:

Tabell 2. Dynamisk startsideoppsett — Sideegenskaper

Eiendom

Beskrivelse og kode

side > UseFlexLayout

Flex layout er en ny webkomponent. Det endrer ikke de eksisterende widgetene. Den nye flex-layouten bruker det samme layoutkonfigurasjonsformatet på en forenklet måte. Det er bakoverkompatibelt og påvirker ikke eksisterende widgets. Du må konfigurere JSON-oppsettet. For å konfigurere JSON-oppsettet, oppgi høyden og bredden på widgeten. Widgeten gjengis i samme rekkefølge som den er konfigurert inne i JSON-layouten. Widgets har en standardmargin på 8 px.

JSON-oppsettet er basert på dimensjonene (bredde x høyde) og koordinater (X, Y og Z) til widgetene.

Det fleksible oppsettet støtter funksjoner som individuell widget-størrelse, maksimere widgeter og så videre.

Høyden på individuelle widgeter måles i piksler. 1 høydeenhet = 40 piksler. Bredden på widgeten avhenger av antall kolonner i beholderen og antall kolonner som endres basert på beholderbredden.

Widgets vises fra venstre til høyre. Den avanserte layoutmotoren bruker tilpasset logikk for å bruke både horisontal og vertikal plassjustering av widgets. Opprinnelig lastes oppsettet horisontalt. Etter å ha lastet horisontalt lastes widgeten vertikalt og sikrer at plassutnyttelsen er optimal.

Konfigurer widgetene basert på skjermstørrelsen. Du kan enten øke eller redusere bredden på widgetene, basert på skjermstørrelsen. Dette gjør widgetene mer lesbare og brukbare.

Flex-layout gir standard bruddpunkter som store, mellomstore, små og ekstra små.

  • Store widgets har en oppløsning på 1360 px eller mer. For store widgeter angir du kolonneverdien som 12.

  • Medium widgets har en oppløsning på 1070 px til 1360 px. For mellomstore widgeter angir du kolonneverdien som 10.

  • Små widgets har en oppløsning på 850 px til 1070 px. For små widgeter angir du kolonneverdien som 6.

  • Ekstra små widgets har en oppløsning på 500 px. For ekstra små widgeter, angi kolonneverdien som 4.

Disse pikslene kan variere avhengig av operativsystem og broswer.

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

side > comp

Sørg for at du gir en unik tilpasset komponent.

"comp": "page-title",

Side tittelkomponenten representerer nivå 2-overskriften til det egen <h2>definerte HTML-elementet.

side > PageHeader

Sørg for å angi en tittelstreng som kan være statisk, dynamisk eller begge deler.

Side tittelkomponenten representerer nivå 2-overskrift <h2>i det egendefinerte HTML-elementet.

  • Statisk streng: For eksempel Hei, Velkommen!

    "comp": "page-title",
    "attributes": {
        "pageTitle": "Hey, Welcome!"
    }
  • Dynamisk streng: For å hente verdien fra STORE. For eksempel Jane Doe.

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

  • Begge: Kombinasjonen av statiske og dynamiske strenger. For eksempel, Hei Jane Doe, Velkommen!

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

    Du må omslutte den dynamiske delen av strengen innenfor de lukkede krøllete parentesene {} og prefikset med strukturen $.

side > PageSubHeader

Sørg for å legge til underoverskrift som vises på skrivebordet. Brukeren kan legge til Gå til Analyzer i Sub Header.

  • Kodeblokk for 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;"
                        }
  • Kodeblokk for Gå til Analyzer i Sub Header

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

Navigering (egendefinerte sider)

I denne delen kan du legge til sider som vises på venstre navigasjonslinje. Du angir et navigasjonsikon og en unik URL-adresse for widgeten som skal vises på navigasjonslinjen. Vi anbefaler at du bruker et bestemt prefiks for nettadressen for å unngå konflikter. For mer informasjon, se delen navig asjonseiendom.

Du kan også ha en samling widgets som kan vises på denne siden. Siden kan ha en enkelt widget som vises på skjermen eller en samling av widgets i et rutenett. Hvis du vil ha mer informasjon om rutenettarrangement, kan du se delen layoute genskaper.

Du trenger ikke å legge til en dynamisk områdeinnpakning i widgettreet. Dette betyr at du kan dra og slippe og endre størrelse på widgets på egendefinerte sider når du aktiverer dette alternativet.

Eksempel:

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

Tabellen nedenfor beskriver nav - og side egenskaper sammen med underordnede egenskaper:

Tabell 3. nav Eiendomsdetaljer

Eiendom

Beskrivelse og kode

nav > etikett

Denne egenskapen angir sidenavigasjonsidentifikatoren. Skjermleseren leser denne egenskapen, og den vises i verktøytipset.

Disse parametrene er nødvendige for å vise din egendefinerte side på navigasjonslinjen.

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

Etik ett egenskapen er tittelen på den egendefinerte siden.

nav > Ikontype

Denne egenskapen representerer typen ikon som vises i navigasjonslinjen for den egendefinerte siden.

Følgende typer ikoner er tilgjengelige:

  • MomentumDesign: Du kan velge noen tilgjengelige ikoner i samlingen: https://momentum-design.github.io/momentum-design/en/tokens/icons/. Fordelen med å bruke Momentum er at den gir noen få ikoner med en «aktiv» versjon.

    Brukstilfelle for en aktiv versjon:

    Hvis du for eksempel velger en kunngjør ing av typen Momentum-ikon, kan du se standardikonet på navigasjonslinjen. Når du navigerer til den egendefinerte siden (koblet til ikonet), endres ikonet automatisk til den kunngjør ingsaktive versjonen. Kontroller at du kontrollerer om den har en aktiv versjon av det samme ikonet i ikonbiblioteket.

  • An net: Du kan angi en egendefinert bilde-URL (vert på et CDN) som vises på navigasjonslinjen. Hvis du bruker et svart eller hvitt egendefinert ikon, vises ikke ikonet når du bytter mellom lys og mørk modus.

nav > ikon

Denne egenskapen representerer navnet på ikonet i Momentum-biblioteket eller CDN-URL-adressen.

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

nav > ju ster

Denne egenskapen hjelper deg med å justere ikonet til toppen eller bunnen av navigasjonslinjen.

Foreløpig tillater egenskapen bare toppjustering.

nav > is DefaultLandingPage

Denne egenskapen angir standard destinasjonsside for agentene iAgent Desktop. Sett denne egenskapen til true for å gjøre navigasjonslinjesiden til standard destinasjonsside som vises for agentene etter at du har logget påAgent Desktop. Hvis mer enn én navigasjonslinjeside har denne egenskapen satt til true, vurderer systemet den første navigasjonslinjesiden som standard destinasjonsside.

Hvis ingen navigasjonslinjesider har denne egenskapen satt til true, fungerer startsiden som standard destinasjonsside.

Du kan ikke angi rapporter Analyzer og Agent Performance Statistics som standard destinasjonsside.

nav > Naviger til

Denne egenskapen angir navnet på den egendefinerte siden. Dette navnet vises i adressefeltet når agenten navigerer.

NavigateTo må ikke inneholde følgende verdier: bilder, skrifter, css, build_info, hjelp, app, i18n, ikoner, bilder-mfe-wc og lyder.

type Navigation.Item = {
    navigateTo: “my - custom - page”;
};
Tabell 4. side Eiendomsdetaljer

Eiendom

Beskrivelse og kode

side > id

I side egenskap angir du det egendefinerte sideobjektet (dynamisk widget).

I d-egenskapen representerer en unik sideidentifikator. For eksempel, my-custom-page-1. Agenten kan ikke se denne identifikatoren på skrivebordet.

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

side > UseFlexLayout

Flex layout er en ny webkomponent. Det endrer ikke de eksisterende widgetene. Den nye flex-layouten bruker det samme layoutkonfigurasjonsformatet på en forenklet måte. Det er bakoverkompatibelt og påvirker ikke eksisterende widgets. Du må konfigurere JSON-oppsettet. For å konfigurere JSON-oppsettet, oppgi høyden og bredden på widgeten. Widgeten gjengis i samme rekkefølge som den er konfigurert inne i JSON-layouten. Widgets har en standardmargin på 8 px.

JSON-oppsettet er basert på dimensjonene (bredde x høyde) og koordinater (X, Y og Z) til widgetene.

Det fleksible oppsettet støtter funksjoner som individuell widget-størrelse, maksimere widgeter og så videre.

Høyden på individuelle widgeter måles i piksler. 1 høydeenhet = 40 piksler. Bredden på widgeten avhenger av antall kolonner i beholderen og antall kolonner som endres basert på beholderbredden.

Widgets vises fra venstre til høyre. Den avanserte layoutmotoren bruker tilpasset logikk for å bruke både horisontal og vertikal plassjustering av widgets. Opprinnelig lastes oppsettet horisontalt. Etter å ha lastet horisontalt lastes widgeten vertikalt og sikrer at plassutnyttelsen er optimal.

Konfigurer widgetene basert på skjermstørrelsen. Du kan enten øke eller redusere bredden på widgetene, basert på skjermstørrelsen. Dette gjør widgetene mer lesbare og brukbare.

Flex-layout gir standard bruddpunkter som store, mellomstore, små og ekstra små.

  • Store widgets har en oppløsning på 1360 px eller mer. For store widgeter angir du kolonneverdien som 12.

  • Medium widgets har en oppløsning på 1070 px til 1360 px. For mellomstore widgeter angir du kolonneverdien som 10.

  • Små widgets har en oppløsning på 850 px til 1070 px. For små widgeter angir du kolonneverdien som 6.

  • Ekstra små widgets har en oppløsning på 500 px. For ekstra små widgeter, angi kolonneverdien som 4.

Disse pikslene kan variere avhengig av operativsystem og broswer.

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

side > widgets

side > comp

Hjelper deg med å definere egendefinerte widgets. Hvis du vil plassere flere widgeter, angir du widgetalternativer i rekkefølge. Sørg for at du gir hver widget et unikt områdenavn. Bruk den i layoutdelen senere.

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

Denne egenskapen representerer navnet på det egendefinerte HTML-elementet (kjent som en webkomponent eller et annet element - hvis du vil bruke det som en innpakning). Hvis du vil ha mer informasjon, kan du se Eksempel på eksempler på brukstilfeller. Skriv inn ditt egendefinerte elementnavn her uten vinkelparenteser («<» or «>»). For eksempel «my-tilpasselement.»

Hver oppføring under widget-delen støtter følgende format:

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

side > skript

(Valgfritt) Denne egenskapen kreves bare når du laster inn widgeten eller komponenten fra et eksternt sted, for eksempel et CDN.

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

Ikke endre skriptadressen for den samme komponenten. Hvis du trenger å endre skriptadressen for den samme komponenten, gjør du ett av følgende:

  • Gi beskjed til agenten om å tømme nettleserbufferen og laste inn på Agent Desktop nytt.

  • Behold den eksisterende URL-adressen. Importer dynamisk den nye pakke-URL-adressen ved hjelp av javascriptet som er vert i den eksisterende URL-adressen.

    Eksempel:

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

side > egenskaper

Du kan angi egenskaper som du må sende for webkomponenten.

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

side > responsive

Bestemmer om en webkomponent eller en iFrame-basert widget som legges til i den egendefinerte layouten på siden iv å eller kompileringsnivå, er responsiv. Responsive webkomponenter gjør websiden din visuelt tiltalende på alle enheter og er enkle å bruke. Du må bruke responsive iFrame-widgeter.

Konfigurer denne egenskapen med en av følgende verdier:

  • Sant: Aktiverer responstid for widgeten. Som standard er alle widgets responsive basert på de progressive skjermstørrelsene, orienteringen og visningsområdene til enheten som er i bruk.

  • Falsk: Deaktiverer responsen til widgeten. Hvis widgetene ikke støtter visning på forskjellige enheter, merker du dem som ikke-responderende.

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

Ikke-responsive widgeter kan ikke sikre den beste brukeropplevelsen og vises ikke i den mindre visningen. Agenten må øke størrelsen på nettleservinduet for å vise widgeter som er konfigurert som ikke-responderende.

side > attributter

Du kan angi attributtene for webkomponenter i denne delen.

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

side > synlighet

Angir om de Cisco-tilbudte widgetene som er lagt til i den egendefinerte layouten på sideniv å eller komposisjonsnivået, er synlige eller ikke.

Cisco-tilbudte widgets er Contact History,Cisco Webex Experience Management, IVR Transcript, Preview Campaign Call Guide og Screen Pop.

  • Verdiene for syn lighetsegenskaper er innebygd og definert i standard JSON-fil i skrivebordslayouten. Administratoren kan ikke endre synlighetsegenskaps verdiene til widgetene som tilbys av Cisco.

  • Synlighet segenskaps verdien NOT_RESPON SIVE er utdatert. Du kan fortsette å bruke den bare for bakoverkompatibilitet. Enhver verdi satt som NOT_RESPONSIVE tidligere krever ikke endring, siden funksjonaliteten forblir den samme.

    Hvis du vil angi en nyopprettet widget som responsiv eller ikke responsiv, må du bruke den responsive egenskap en. Hvis du vil ha mer informasjon, kan du se Responsive Property.

side > barn

Denne egenskapen er kjernedelen av oppsettet. I barn- delen kan du legge inn så mange nivåer som kreves hvis den webkomponentbaserte widgeten lar deg passere underordnede. For å gjøre det mulig, må utvikleren programmatisk håndtere det slissede innholdet. Hvis du vil ha mer informasjon, kan du se Cisco Webex Contact CenterDesktop Developer Guide.

Hvis du vil vite om overføring av STORE-verdier som egenskaper, kan du se Del data fra skrivebordet til widgeter.

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

Fordelen med «barn» -matrisedelen er at du kan bruke eksisterende webkomponenter i layoutspesifikasjonen, som allerede er en del av skrivebordspakken. Noen av Web-komponentene til skrivebordspakken inkluderer:

  • agentx-wc-iframe: En widget som lar deg plassere en hvilken som helst webside i en iFrame som en widget.

  • dynamisk område: En komponent som lar deg aktivere dra-og-slipp-funksjonen for agenter på et annet sted enn egendefinerte sider. De egendefinerte sidene kan også ha denne funksjonen hvis du aktiverer dra-og-slipp som standard.

  • Enhver komponent i momentum-ui-web-komponentbiblioteket. For mer informasjon, se GitHub. For eksempel:

    • md-tabs: Tabs-beholderinnpakning

    • md-tab: Enkel faneoverskrift

    • md-tab-panel: Enkeltfaneinnhold

Hvis du vil ha mer informasjon om attributtene for kategorien vedvarende, kan du se At tributter for vedvarende faner.

side > TextContent

Hjelper deg med å legge til tekstinnholdet ditt.

"textContent": "My Text Content",

side > stil

Hjelper deg med å tilordne en bestemt CSS-stil til komponenten.

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

side > innpakning

Widget wrapper lar deg legge til en verktøylinje på toppen av widgeten. Verktøylinjen kan inneholde en tittel og ikonet Maksimer ikonet (Maksi mer) øverst på widgeten. Når widgeten har okkupert en liten plass på siden, lar maksimeringsikonet agenten se widgeten i hele arbeidsområdet.

Forsikre deg om at du bruker standardverdien som «app-maximize-area». Foreløpig er bare standardverdien tilgjengelig. Hvis oppsettet er konfigurert ved hjelp av use FlexLayout, kan du aktivere maksimere/gjenopprettingsikonet i widgetoverskriften ved å legge til isMaximizer e-attributtet i widgetens konfigurasjon og angi verdien til true.

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

side > innpakning> id

(Valgfritt) Widget-innpakningen for webkomponenter lar deg oppdatere den dynamiske widgettittelen ved hjelp av en unik identifikator. Skriv inn egenskapsverdien for widgetinnpaknings- id som unik -id-to-update-title.

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

Forsikre deg om at du bruker den samme unike identifikatoren for JavaScript CustomEvent. Hvis du vil ha mer informasjon, kan du se delen Asynkrone hendelser i kapit let Agentkontaktmodul i Cisco Webex Contact CenterDesktop Developer.

Hvis du vil oppdatere den iFrame-baserte widgettittelen, bruker du iFrame-innholdet fra det samme domenet. Følgende er et eksempeleksempel:

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

side > agentx-wc-iframe

Lar deg bygge inn en webside i en iFrame som vises som en widget på skrivebordet. Du kan bruke iFrame-widgeten kalt «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"
    }
},

side > layout

Lar deg ordne widgetene på en side.

Følgende format representerer et rutenettoppsett:

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

Her kan du definere rutenettet med områdenavnene du definerte i widget- delen.

Følgende eksempel viser hvordan oppsettet av tre rader og tre kolonner er spesifisert:

"layout": {
    "areas": [
        [
            "comp1",
            "comp1",
            "comp3"
        ],
        [
            "comp2",
            "comp2",
            "comp3"
        ],
        [
            "comp4",
            "comp4",
            "comp4"
        ]
    ],
    "size": {
        "cols": [1, 1, 1],
        "rows": [1, 1, 1]
    }
}
Lik fordeling av en 3x3 layout
Equal distribution of a 3x3 layout for Webex contact Center Desktop layout configuration.

I størrelsesdelen representerer tall brøkdelen av plass som en widget kan oppta, i forhold til de andre widgetene. Alle tre kolonnene opptar lik 1 brøkdel av plass. Med 100% som tilgjengelig bredde, opptar hver widget 33,33% av horisontal plass.

Med lik kolonnebredde
Equal column width layout for Webex Contact Center Desktop layout configuration.

Et annet eksempel på bruk, hvis du angir som «cols»: [1, 2, 2], betyr det at den totale plassen er delt på 5 (1+2+2) og den første widgeten opptar 20% av horisontal plass. Den andre og tredje widgeten tar 40% hver. Hvis du vil ha mer informasjon, kan du se Grunnleggende begreper for rutenettopp sett.

Unequal column width layout for Webex Contact Center Desktop layout configuration.
Etter endring av kolonnebredden

side > ROOT

Hekking av oppsett kalles en sublayout. Hvis du har nestede oppsett i layoutkonfigurasjonen, må du ha et enkelt «ROOT» -objekt som overordnet for underutlegg. Ellers kan layoutkonfigurasjonen være flat hvis ingen hekking er nødvendig.

Denne underoppsettet gir mer kontroll over oppførselen for endring av layoutstørrelse. Sideoppsettegenskap en må være av typen Record<string, Layout>. Layoutegenskapen lar deg ordne widgetene på en side.

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

Dette oppsettet oppretter et rutenett i ROOT-layouten med to delrutenett som du kan endre størrelsen på uavhengig av hverandre.

Sub-layout appearance for Webex Contact Center Desktop layout configuration.
Underlayoutseende

Endring av størrelse på en komponent påvirker komponentene i det underoppsettet.

Sub-layout appearance, after resizing both sub-layouts, for Webex Contact Center Desktop layout configuration.
Etter å ha endret størrelse på begge underlayoutene

Vær oppmerksom på følgende tilfeller:

Uendelig sløyfe: Hvis du inkluderer ROOT-layout som et underoppsett av ROOT, forårsaker det en «call stack» -feil og går inn i en uendelig sløyfe.

{
    "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.
Underlayout med uendelig sløyfe

Samme underoppsett (N) ganger: Hvis du inkluderer underoppsettet i rutenettet mer enn én gang med samme navn, og hvis du endrer størrelsen på en av dem, endres størrelsen på alle underlagene automatisk.

Hvis dette ikke er ønsket virkemåte, omdøper du hvert av underlagene med et unikt navn.

{
    "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.
Underlayout med N ganger

Attributter for vedvarende faner

Hvis du vil angi fanene i de egendefinerte sidene og egendefinerte widgetene som vedvarende, angir du attributtene for md-faner i den egendefinerte layouten.

Eksempel: Angi faner som vedvarende

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

Eiendom

Beskrivelse

vedvarende valg

For å angi md-tabs til å være vedvarende. Standardverdien er sann.

faner-id

Unik identifikasjon for alle fanene sammen i beholderen.

Når du angir md-tabs til å være vedvarende (persist-select: true), Agent Desktop beholder du kategorivalget selv om en agent bytter mellom sider eller widgeter på skrivebordet.

  • Egenskapen for vedvarende valg gjelder ikke for kategoriene i ruten Tilleggsinformasjon og Rapport- siden Agentytelsesstatistikk, fordi oppførselen for vedvarende faner allerede er angitt på skrivebordet .
  • Kategorivalget tilbakestilles til standardfanen når du logger av skrivebordet, laster inn eller oppdaterer nettleseren på nytt eller tømmer nettleserbufferen.

Konfigurasjon av vedvarende widgeter

Du kan konfigurere hvilken som helst egendefinert widget til å være vedvarende. Vedvarende widgets vises på alle sider på skrivebordet. Vedvarende widgeter vises som en ny fane i ruten Hjelpeinformasjon bare når du har en aktiv kontaktforespørsel eller samtale. For eksempel, Eksem pel på vedvarende widget.

Vedvarende widgeter vises ikke på hjemmesiden slik de vises på de andre sidene. Men hvis du har en aktiv interaksjon, vises de vedvarende widgetene på Hjem-siden som en del av ruten Hjelpeinformasjon. Når du for eksempel har besvart et anrop, vises ruten Interaksjonskontroll, og widgeten Eksempel på vedvarende vises som en del av ruten Hjelpeinformasjon.

Eksempel:

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

Når du tilpasser en widget, kan du velge ett av alternativene:

  • Vær vert for et program på en webside som kan bygges inn i en iframe.

  • Bygg en tilpasset widget.

De tekniske kontrollprogramkravene er beskrevet i Desktop Widget Development Documentation. Som layoutredigerer må du sørge for at du har disse detaljene:

  • Hva heter det egendefinerte HTML-elementet (kjent som Web Component)?

  • Hva er URL-en til kilden til innholdsleveringsnettverket (CDN) som er vert for JavaScript-pakken?

Header Widgets

Overskriften brukes til å vise innebygd informasjon, legge til rullegardinmenyer og så videre. Siden topptekstbeholderen har begrenset vertikal plass, er den totale toppskriftshøyden bare 64 piksler. Hvis du vil ha mer informasjon om layoutjusteringen, kan du se layoutegen skapsdelen.

Eksempel:

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

Hvis du vil legge til et verktøytips for en topptekstwidget, pakk komponenten med m d-tooltip. Angi verktøytipsinformasjon i meldingsegenskapen.

Eksempel:

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

    },
}

Du må legge til stilattributtene visning og høyde for å konfigurere eventuelle widgeter gjennom iFrame i det tilpassbare widgetområdet i overskriften. Den beste tilpasningsverdien for høy deattributtet er 64 piksler.

Sørg for at du legger til stilattributtene i de eksisterende topptekstwidgetene slik at de kan lastes inn som forventet i iFrame.

Eksempel:

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


},

Vi anbefaler at du bare bruker en enkelt rad med flere kolonner for overskriften fordi toppteksthøyden bare er 64 piksler. Hvis du vil ha mer informasjon om justeringen, kan du se layoutegen skapsdelen.

Hjelpeinformasjonsrute

Hjelpeinformasjon-ruten på skrivebordet viser kategoriene som inkluderer Cisco-tilbudte (standard) widgeter og egendefinerte widgeter. Følgende Cisco-tilbudte widgeter vises i de forhåndsdefinerte fanene:

  • Kontakthistorikk

  • IVR-transkripsjon

  • Kundeopplevelsesreise

  • Skjermpop

Du kan bruke ruten Hjelpeinformasjon til å:

  • Legg til faner

  • Endre tabulatorrekkefølgen

  • Fjern forhåndsdefinerte faner

  • Merk de egendefinerte fanene som dragbare

  • Legg til verktøytips i de egendefinerte fanene

  • Legg til alternativet Tilbakestill tabulatorrekke følge

Eksempel:

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

Du kan konfigurere widgeten Kundeopplevelsesreise etter at du har aktivert beregningene for kundeopplevelsesadministrasjon påManagement Portal.

I ruten Hjelpeinformasjon legger du til nye faner for å plassere egendefinerte widgeter. Ingen spesielle regler gjelder her, og komponenthekkingen er som forventet og beskrevet i barne- delen. Hvis du vil ha mer informasjon, kan du se Bar n-egenskapen på siden.

Følgende er de spesifikke eksemplene for å tilpasse faneoverskriftene dine:

Eksempel på plassering av ikoner og etiketter i barneegenskapen

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

Eksempel på plassering av bilde (med CSS) og etiketter i barneegenskapen

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

Rullegardinlisten Flere faner vises automatisk når ruten Hjelpeinformasjon inneholder flere faner.

Du må legge til et verktøytips for egendefinert fane for lesbarhet og tilgjengelighet. Hvis du vil legge til et verktøytips for en egendefinert fane, omslutter du komponenten med m d-tooltip. Angi verktøytipsinformasjonen i meld ingsegenskapen, og bruk malegenskapene som vist i eksemplet nedenfor.

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

For en egendefinert fane anbefaler vi en maksimal bredde på 252 piksler og en minimumsbredde på 110 piksler.

Hvis du vil aktivere dra-og-slipp-funksjonen i den egendefinerte kategorien, legger du til følgende egenskap i attributtene:

"comp": "md-tabs",
"attributes": {
    "class": "widget-tabs",
    "draggable": true,
    "comp-unique-id": "sample-dynamic-custom-tabs"
},
  • draggable: Sett verdien for dragbar egenskap til sann.

  • comp-unique id: Skriv inn en unik verdi for å identifisere komponenten.

    Eksempel:

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

Hvis du aktiverer dra-og-slipp for en egendefinert fane, kan agenten dra og slippe kategorien til ønsket posisjon i ruten Hjelpeinformasjon. Hvis du vil tilbakestille kategoriene til standard tabulatorrekkefølge, legger du til følgende egenskap:

"comp": "agentx-wc-more-actions-widget",
"attributes": {
    "slot": "settings",
    "class": "widget-pane",
    "tabs-unique-id": "sample-dynamic-custom-tabs"
},
  • agentx-wc-more-actions-widget: Skriv inn komponenten som vises som ikonet Flere handlinger () Flere handlinger-ikon i ruten Hjelpeinformasjon.

  • slot="settings": Enter an attribute within the component that is displayed as the Reset Tab Order option in the More Actions drop-down list. Agenter kan tilbakestille fanene i ruten Hjelpeinformasjon til standardrekkefølgen ved å klikke Flere handlinger-ikon > Tilbakestill tabulatorrekkefølge.

  • tabs-unique id: Skriv inn den samme unike verdien som er definert for egenskapen comp-unique id for å tilordne og tilbakestille md-tabs-komponentene.

Følgende eksempelkode bruker funksjonene Flere handlinger og Tilbakestill tabulatorrekke følge.

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

Som standard er verktøytipset, ellipseikonet og tilbakestilling av tabulatorrekkefølge for forhåndsdefinerte faner definert.

Rullegardinlisten Flere handlinger kan utvides til å legge til flere egendefinerte komponenter eller widgeter etter alternativet Tilbakestill tabulatorrekke følge. Følgende er et eksempelsett med stilegenskap sverdier som kan brukes på tilleggskomponenter.

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

Dra og slipp-funksjonen støttes ikke for de ekstra egendefinerte komponentene eller widgetene som legges til i rullegardinlisten Flere handlinger.

Hodeløse Widgets

I den hodeløse delen kan du legge til widgets som er skjult og ikke vises påAgent Desktop. Disse widgetene brukes til å utføre logikk i bakgrunnen. Denne delen er nyttig for å utløse hendelser som oppstår på skrivebordet og utføre widgetspesifikk logikk. For eksempel å åpne en tilpasset CRM-skjermpop for en SMS ved ankomst.

Eksempel:

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

Del data fra skrivebordet til widgeter

Hvis du vil motta sanntidsdata gjennom egenskaper eller attributter inne i en egendefinert widget, tilordner du passende STORE-verdier i layouten JSON-konfigurasjonen.

I tillegg, for å få tilgang til dataene gjennom JavaScript SDK-abonnenter, kan du også sende dataene gjennom egenskaper eller attributter. Hvis komponenten er bygget for å reagere på egenskaper eller attributtendringer, får du sanntidsdataoppdateringer fraAgent Desktop, som kalles en dataleverandør.

For øyeblikket har vi en enkelt dataleverandør under en nøkkelSTORE. Hvis du vil ha mer informasjon, kan du se delen Data Provider — Widget Properties and Attributes i Cisco Webex Contact CenterDesktop Developer Guide.

Forhåndsvisning av kampanjeanrop

Administratoren oppretter kampanjer, konfigurerer oppringingsmodus (forhåndsvisning) og tilordner kampanj ene til team. Hvis en agent er en del av et team som kampanjer er tilordnet til, kan ag enten foreta en utgående forhåndsvisningskampanjeanrop. Hvis du vil ha mer informasjon, kan du se Konfigurere taleutgående kampanjemoduser i Webex Contact Center.

Administratoren konfigurerer følgende i den egendefinerte layouten for å aktivere forhåndsvisningskampanjekontakt for en agent.

Kampanjekontakt

Administratoren legger til kampanjekontakt-widgeten i topptekstbeholderen til den egendefinerte layouten. Kampanjekontakten viser kundens kontaktinformasjon basert på de definerte egenskapene. Hvis du vil ha mer informasjon om layoutjusteringen, kan du se layou te genskapsraden på siden Property Det ails tabell.

Eksempel:


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

Anropsveiledning

Anro psveiled ning-widgeten vises i ruten Hjelpeinformasjon på skrivebordet. Anropsguiden viser spørsmålene og svarene på kampanjenivå. Agenten blir bedt om å lese gjennom settet med spørsmål i samtaleveiledningen og sende inn svarene.

Eksempel:

"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"
      }
   ]
}
  • Følgende referanser for comp- egenskaper har endret seg. agentx i eiendomsverdien erstattes med acqueon:
    • agentx-preview-campaign er omdøpt til acqueon-preview-campaign
    • agentx-call-guide er omdøpt til acqueon-call-guide
  • Du må være vert for Liste- og Campaign Manager (LCM) på et CDN og deretter angi URL-adressen i skript egenskapen.

Skjermpop

I skrivebordsoppsettet kan du konfigurere Screen Pop på en av følgende måter:

  • Som en tilpasset side

  • Som en av widgetene i den egendefinerte siden

  • Som en fane i ruten Hjelpeinformasjon

Screen Pop vises på skrivebordet basert på følgende faktorer:

For stemmekanalen:

  • Konfigurasjonen som er definert i skrivebordsoppsettet

  • Screen Pop-aktiviteten som er definert i Flow Designer

For de nye digitale kanalene:

  • Konfigurasjonen som er definert i skrivebordsoppsettet

  • Screen Pop-noden som er definert i Connect Flow Builder

Hvis du vil ha mer informasjon om hvordan du konfigurerer Screen Pop, kan du se Screen Pop.

Konfigurere skjermpop i navigasjonslinjen

Du kan konfigurere Screen Pop som en egendefinert side, eller som en av widgetene på en egendefinert side. For å få tilgang til den egendefinerte siden Screen Pop, klikk på Screen Pop- ikonet på navigasjonslinjen. For å få tilgang til skjermpop-widgeten på den egendefinerte siden, klikk på det egendefinerte ikonet på navigasjonslinjen. Hvis du vil ha mer informasjon om navig asjon segenskaper, kan du se Navigering (egendefinerte sider).

Eksempel: Skjermpop som en egendefinert side

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

Eksempel: Skjermpop som en widget på den egendefinerte siden

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

Hvis Screen Pop ikke er konfigurert i Flow Designer, vises den egendefinerte siden tom. Hvis du vil ha mer informasjon om hvordan du konfigurerer Screen Pop i Flow Designer, kan du se Screen Pop.

Konfigurere skjermpop i tilleggsinformasjonsruten

Du kan konfigurere Screen Pop til å vises som en fane i ruten Hjelpeinformasjon.

Som standard vises Screen Pop som en ny underkategori i kategorien Skjerm pop i tilleggsinformasjon-ruten hvis Screen Pop er konfigurert til å vises som Inside Desktop i Flow Designer.

Legg til følgende attributt i panel delen for å inkludere Screen Pop som en fane i ruten Hjelpeinformasjon. Hvis du vil ha mer informasjon om panel detaljer, kan du se Hjelpeinformasjonsruten.

Eksempel: Skjermpop som en fane i tilleggsinformasjonsruten

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

Visningsalternativet Screen Pop som er definert i Flow Designer, har forrang fremfor konfigurasjonen som er definert i skrivebordslayouten.

Tenk for eksempel på at du har konfigurert følgende skjermpop-innstillinger:

  • Flow Designer — Vis innstillinger som I den nye nettleserfanen
  • Skrivebordsoppsett — Som en fane i ruten Tilleggsinformasjon

Når hendelsen som skjermpop er konfigurert for, vises Screen Pop utenfor skrivebordet - det vil si i en ny nettleserfane.

Eksempel på eksempler på brukstilfeller

Følgende avsnitt gir noen eksempler som referanse:

Konfigurere og få tilgang til widgeten Customer Experience Management Metrics fra navigasjonslinjen

Eksempel:

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

For å få SpaceID og MetricSID, se dokumentasjonen. Webex Experience Management

Bruke faner på den egendefinerte siden

Eksempel:

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

Standard hjelpeinformasjonsrute med kontakthistorikk og skjermpop

Eksempel:

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

Hjelpeinformasjonsrute med Customer Experience Journey Widget

Eksempel:

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

Lokalisering

Desktop UI støtter lokalisering på 29 språk.

Følgende er språkene som støttes:

Bulgarsk, katalansk, kinesisk (Kina), kinesisk (Taiwan), kroatisk, tsjekkisk, dansk, nederlandsk, engelsk (Storbritannia), engelsk (USA), finsk, fransk, tysk, ungarsk, italiensk, japansk, koreansk, norsk, polsk, portugisisk (Brasil), portugisisk (Portugal), rumensk, russisk, serbisk, slovakisk, slovensk, spansk, svensk og tyrkisk.

Språket for skrivebordsgrensesnittet er basert på språkinnstillingene i nettleseren din. La oss for eksempel vurdere at du har valgt det foretrukne språket som fransk i Firefox-nettleseren. Når du starter skrivebordet i Firefox-nettleseren, vises skrivebordsgrensesnittet på Français (fransk). Den horisontale overskriften, navigasjonslinjen og andre komponenter som er lagt til i skrivebordsoppsettet, er imidlertid ikke lokalisert basert på språkinnstillingene i nettleseren din.

Lokaliser skrivebordskomponenter

For å lokalisere skrivebordskomponenter,

  • Bruk de eksisterende lokaliseringstastene som er angitt i app.json- filen. Hvis lokaliseringsnøklene ikke er angitt, brukes standardspråket engelsk (US). Du kan sende en tjenesteforespørsel til Cisco Support for å legge til en lokaliseringsnøkkel i app.json- filen.

    Eksempel: Lokaliseringsnøkkel

    {
        "common": {
            "buttonTitle": "Stop Timer"
        }
    }
  • Skriv inn følgende egenskap som skiller mellom store og små bokstaver i JSON-filen for skrivebordslayout for å lokalisere en komponent:

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

    hvor <key>refererer til den tilsvarende lokaliseringsnøkkelen i app.json- filen.

Eksempel: Lokaliser overskriftskomponent

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

        },
    }

Eksempel: Lokaliser fanekomponent i hjelpeinformasjonsruten

"panel": {
    "comp": "md-tab",
    "attributes": {
        "slot": "tab"
    },
    "children": [{
        "comp": "span",
        "textContent": "$I18N.panelTwo.screenPopTitle"
    }]
}
Var denne artikkelen nyttig?
Var denne artikkelen nyttig?