I denne artikel
Oversigt
dropdown icon
Egenskaber for JSON-layout på øverste niveau
    Apptitel
    logo
    OpgavesideIllustration
    StopNavigateOnAcceptTask
    DragDropEnabled
    NotificationTimer
    Maksimalt antal notifikationer
    BrowserNotificationTimer
    wxmKonfigureret
    DesktopChatApp
    OverskriftHandlinger
    areal
    AdvancedHeader
dropdown icon
Hjemmesiden
    Konfiguration af startsidelayout
dropdown icon
Navigation (brugerdefinerede sider)
    Attributter for vedvarende faner
Konfiguration af vedvarende widgets
Overskrift Widgets
Hjælpeinformationsrude
Hovedløse Widgets
Del data fra skrivebordet til widgets
Forhåndsvisning af kampagneopkald
Skærm Pop
Eksempler på eksempler på brugssager
Lokalisering

Opret brugerdefineret desktop layout

list-menuI denne artikel
list-menuHar du feedback?

Denne artikel hjælper med at oprette et brugerdefineret layout ved at redigere en JSON-fil og tilbyder eksempler på brugssager, der hjælper dig med at komme i gang med widgets som widgeten Customer Experience Management Metrics og widgeten Customer Experience Journey. For effektivt at arbejde med brugerdefinerede skrivebordslayouter skal du have en solid forståelse af HTML-struktur, dokumenttræmodellen i en browser og JSON-formatet.

Oversigt

Funktionen Desktop Layout giver dig mulighed for at konfigurere Webex Contact Center-skrivebordet i henhold til dine forretningskrav. Du kan tilpasse elementer som logo, titel og widgets. Du kan oprette et skrivebordslayout og tildele det til et team. Dette layout genererer agentoplevelsen på skrivebordet for alle agenter, der logger på som en del af teamet.

Der er to typer layout:

  • Globalt layout: Dette layout er et systemgenereret layout, der tildeles som standard, når du opretter et team. Du kan finde flere oplysninger i Administrer teams. Når du opretter et team, indstilles det globale layout automatisk som skrivebordslayout for teamet. Du kan ikke slette dette layout.

  • Brugerdefineret layout: Et layout, der giver en tilpasset skrivebordsoplevelse. Du kan oprette et brugerdefineret layout til et eller flere teams.

Hvis du tildeler et nyt skrivebordslayout, når en agent er logget på, skal agenten gen indlæse siden for at se det nye layout.

Webex Contact Center Desktop understøtter tre personas:

  • Agent

  • Vejleder

  • Supervisor og agent

JSON-layoutfilen har separate sektioner for hver af personaerne. Administratoren skal konfigurere indstillingerne for hver persona i det tilsvarende afsnit af JSON- layoutfilen. Du kan finde flere oplysninger om et eksempel på en JSON-layoutfil under Egenskaber for JSON-layout på øverste niveau.

Når Cisco tilføjer en ny funktion til skrivebordslayoutet, opdateres det uændrede layout automatisk med de nye funktioner. Det opdaterede skrivebordslayout er automatisk tilgængeligt for de eksisterende teams, der bruger det uændrede skrivebordslayout. Skrivebordsbrugere, der bruger det uændrede skrivebordslayout, modtager de nye layoutbaserede funktioner, når de logger på eller genindlæser browseren.

Hvis du bruger Def ault Desktop Layout.json- filen uden nogen ændring, betragtes det som et umodificeret layout. Men hvis du downloader filen Standard Desktop Layout.json og uploader den igen, betragtes den som et ændret layout, selvom filindholdet eller filnavnet ikke ændres.

For teams, der bruger et brugerdefineret skrivebordslayout, skal administratorer regelmæssigt opdatere layoutdefinitionen for at inkorporere nye funktioner. Når administratorer får vist et uændret layout eller et team, der bruger et uændret layout, vises en meddelelse, der angiver, at nye skrivebordsfunktioner anvendes automatisk.

På skrivebordet er der to typer widgets - iframe-baseret og webkomponentbaseret. Overskriften, navigationen (brugerdefineret side), vedvarende område, hovedløse område og aux-panelet er det tilpassede område på et skrivebord. Disse er ikke widgets.

Følgende liste beskriver de mellemrum, du kan konfigurere. Billederne illustrerer layoutet på skrivebordet:

  1. Titel- og logoområde: Dette rum viser Webex Contact Center-logoet og navnet (standard) øverst til venstre på skærmen.

  2. Vandret side hovedområde: Dette rum har et konfigurerbart område, der er fyldt med brugerdefinerede widgets. Disse widgets kan for eksempel vise inline information og rullemenuer. Da højden på denne header kun er 64 pixels, kan widgethøjden ikke krydse sidehovedhøjden.

  3. Arbej dsområdeområde: Dette område ændres i henhold til markeringen på navigationslinjen, eller når en agent interagerer med kunder. Når en agent er i gang med et opkald, viser dette område ruden interaktionskontrol og hjælpeoplysninger (som omfatter brugerdefinerede widgets og vedvarende widgets). Når en agent interagerer på e-mail, chat eller sociale kanaler, viser dette område arbejdsområdeområdet og ruden med hjælpeoplysninger (som omfatter det vedvarende widgetområde).

    Brugerdefineret side vises på skrivebordsgrænsefladen i arbejdsområderuden. Du kan få adgang til den brugerdefinerede side gennem ikoner på navigationslinjen. Hver brugerdefineret side kan indeholde en eller flere brugerdefinerede widgets.

    Custom Widget er et tredjepartsprogram, der er konfigureret i JSON-layoutet. Du kan placere den brugerdefinerede widget på den brugerdefinerede side, den brugerdefinerede fane (ruden Hjælpeoplysninger) eller på skrivebordets vandrette overskrift.

  4. Navigationsbj ælkeområde: Brug dette rum til at tilføje navigationselementer for at få adgang til brugerdefinerede 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å skrivebordsbrugergrænseflade til 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å skrivebordsbrugergrænseflade til nye digitale kanaler

Egenskaber for JSON-layout på øverste niveau

Roller

Standard JSON-layoutet har følgende tre roller.

  • Agent—for at indstille skrivebordslayoutet, der skal vises, når en agent logger på Webex Contact Center-skrivebordet for at håndtere agentaktiviteter.

  • Supervisor — for at indstille skrivebordslayoutet, der skal vises, når en supervisor logger på Webex Contact Center-skrivebordet for kun at håndtere overordnede funktioner.

    Når en supervisor logger på skrivebordet, anvendes det skrivebordslayout, der er angivet for det primære team. Hvis du ikke angiver et primært team, gælder det globale layout. APS-rapporter er som standard deaktiveret.

  • SupervisorAgent—for at indstille skrivebordslayoutet, der skal vises, når en supervisor logger på Webex Contact Center-skrivebordet for at håndtere både tilsynsfunktioner og agentaktiviteter.

Du kan enten tilføje eller ændre widgets for hver rolle i den tilsvarende persona i den relevante JSON-layoutfil.

Følgende er egenskaberne på øverste niveau for JSON-layout baseret 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": {
                ...
            }
        },
    }
},
  • Ændringerne i JSON-layoutegenskaberne træder i kraft, når skrivebordsbrowseren opdateres.
  • Hvis en funktion, som du har aktiveret i JSON-layout, ikke er tilgængelig på skrivebordet, skal du kontakte Cisco Support for at aktivere funktionen.
  • Alle egenskaber i JSON-layoutet skelner mellem store og små bogstaver.

AppTitel

Sådan angiver du en titel på skrivebordets vandrette overskrift. Standardtitlen er Webex Contact Center.

Eksempel:

"appTitle": "Webex Contact Center"

Standard AppTitle ændres fra Contact Center Desktop til Webex Contact Center. Der er ingen indflydelse på de eksisterende brugerdefinerede layout, der bruger den gamle standard AppTitle (Contact Center Desktop). Hvis du vil bruge den nye AppTitle, skal du ændre det brugerdefinerede layout. Det nye globale layout bruger dog standard AppTitle som Webex Cont act Center.

Titlen kan enten være tekst, et billede eller en tom streng. Titelteksten vises i to rækker. Hvis teksten rækker ud over den anden række, vises et ellipseikon, og værktøjstipet viser hele titlen. Typografier kan ikke anvendes på titlen.

Du kan enten bruge data-URI'er (Uniform Resource Identifier) eller hoste et brugerdefineret titelbillede på et CDN (Content Delivery Network), Amazon Web Services (AWS) Simple Storage Service (S3) bucket eller en lignende hostingtjeneste og derefter angive webadressen til det hostede billede. De understøttede titelbilledformater er PNG, JPG, JPEG, GIF, SVG og WebP. Den understøttede titelbilledstørrelse er 184 x 32 pixels (bredde x højde).

logo

Sådan angiver du en webadresse til firmalogoet. Hvis du ikke angiver en webadresse, vises Webex Contact Center-logoet som standard.

Eksempel:

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

Du kan hoste et brugerdefineret logobillede på en CDN, Amazon Web Services (AWS) Simple Storage Service (S3) bucket eller en lignende hostingtjeneste og derefter angive webadressen til det hostede billede. De understøttede logo-billedformater er PNG, JPG, JPEG, GIF, SVG og WebP. Den understøttede logo-billedstørrelse er 96 x 32 pixels (bredde x højde).

Tabel 1. Vis matrix til AppTitle og logo Baseret på konfigurationen af skrivebordslayout
Tilstand Eksempel AppTitel logo
Hvis AppTitle og logo ikke er konfigureret
"appTitle": "",
  "logo": "",
Ingen titel Standardlogo
Hvis AppTitle og logo er konfigureret
"appTitle": "ABC Company",
  "logo": "https://my-cdn.com/abclogo.png",
Konfigureret tekst Konfigureret logo
Hvis AppTitle er konfigureret, og logoet ikke er konfigureret
"appTitle": "ABC Company",
  "logo": "",
Konfigureret tekst Standardlogo

Hvis AppTitle ikke er konfigureret, og logoet er konfigureret

"appTitle": "",
  "logo": "https://my-cdn.com/abclogo.png",
Ingen titel Konfigureret logo
Hvis AppTitle er konfigureret, og logo ikke foretrækkes
"appTitle": "ABC Company",
  "logo": "no-logo",
Konfigureret tekst Intet logo

Hvis AppTitle ikke er konfigureret, og logo ikke foretrækkes

"appTitle": "",
  "logo": "no-logo",
Ingen titel Intet logo
Hvis AppTitle tilføjes som et billede, og logoet er konfigureret
"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "https://my-cdn.com/abclogo.png",
Konfigureret billede Konfigureret logo

Hvis AppTitle tilføjes som et billede, og logoet ikke er konfigureret

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "",
Konfigureret billede Standardlogo

Hvis AppTitle tilføjes som et billede og logo ikke foretrækkes

"appTitle": "https://my-cdn.com/abccompanylogo.png ",
  "logo": "no-logo",
Konfigureret billede Intet logo
  • Den brugerdefinerede billedstørrelse justeres baseret på billedformatet. Den brugerdefinerede titel tekst, der er konfigureret tidligere, kan nu vises i to rækker på skrivebordet. For at undgå dette kan du ændre den brugerdefinerede titeltekst.
  • Hvis titel og logo ikke er konfigureret i skrivebordets vandrette overskrift, bruges denne plads af header-widgets. Header widgets skal konfigureres korrekt for at bruge titel- og logoområdet.
  • Titlen og logoet tilsammen må ikke overstige den maksimale bredde på 304 pixels (inklusive polstring). Hvis logoets bredde er mindre end 96 pixels, kan den resterende bredde bruges til titlen.
  • Hvis den brugerdefinerede billedstørrelse er højere end den understøttede størrelse, justeres billedstørrelsen baseret på billedformatet i den vandrette header. Hvis den brugerdefinerede billed størrelse er mindre end den understøttede størrelse, bevares den faktiske billedstørrelse i den vandrette sidehoved.

OpgavesideIllustration

Sådan angiver du en brugerdefineret illustration til opgavesiden baseret på organisationspræferencer og brandjustering. Når en agent logger på, viser opgavesiden den konfigurerede illustration som baggrund. Opgavesiden vises som standard uden illustration.

Eksempel:

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

Du kan enten bruge data-URI'er eller hoste en brugerdefineret illustration på et CDN (Content Delivery Network), Amazon Web Services (AWS) Simple Storage Service (S3) bucket eller en lignende hostingtjeneste og derefter angive webadressen til den hostede illustration. Illustrationen kan konfigureres på globalt niveau eller teamniveau baseret på layoutdefinitionen. Sørg for at konfigurere den korrekte webadresse for at forhindre, at det ødelagte billede vises på skrivebordet.

De understøttede opgavesideillustrationsformater er PNG, JPG, JPEG, GIF, SVG og WebP. Den anbefalede illustrationsstørrelse er 400 x 400 pixels (bredde x højde). Hvis den brugerdefinerede illustrationsstørrelse er større end den anbefalede størrelse, justeres illustrationsstørrelsen baseret på billedformatet på opgavesiden. Hvis den brugerdefinerede illustrationsstørrelse er mindre end den anbefalede størrelse, bevares den faktiske illustrationsstørrelse på opgavesiden.

Webex Contact Center interface example of a custom illustration retraining the actual size.
Eksempel på en brugerdefineret illustration, der bevarer den faktiske størrelse
Webex Contact Center interface example of a custom illustration adjusted based on the aspect ratio.
Eksempel på en brugerdefineret illustration justeret baseret på billedformatet

StopNavigateOnAcceptTask

Sådan bestemmer du, om fokus skal flyttes til en nyligt accepteret opgave, når agenten accepterer den nye opgave, mens han arbejder på en tidligere opgave. Standardværdien er falsk.

Eksempel:

"stopNavigateOnAcceptTask": false

Hvis værdien er angivet som sand, når brugeren accepterer en ny opgave på skrivebordet, bevares fokus på den forrige opgave og flyttes ikke til den nyligt accepterede opgave. Denne indstilling forhindrer brugeren i at miste data, når han accepterer en ny anmodning.

Overvej f.eks., at Agent 1 er i chat med kunde 1 og samtidig i et taleopkald med kunde 2. Under taleopkaldet opdaterer Agent 1 oplysningerne om Kunde 2 i ruden Interaktionskontrol. I øjeblikket har Agent 1 to aktive opgaver i ruden Opgaveliste, og fokus er på ruden Interaktionskontrol. Når agent 1 accepterer en ny chatanmodning fra kunde 3, forbliver fokus på ruden Interaktionskontrol med kunde 2 og skifter ikke til den nyligt accepterede chatanmodning.

Hvis du vil bevare fokus på den forrige opgave og ikke skifte til den nyligt accepterede opgave, skal du vælge det brugerdefinerede layout med egenskabsværdien stopNavigateOnAcceptTask indstillet til true.

Hvis egenskabsværdien StopNavigateOnAcceptTask ikke er angivet i JSON-layoutet, flytter skrivebordet fokus til den nyligt accepterede opgave. Funktionen svarer til, når egenskabsværdien stopNavigateOnAcceptTask er indstillet til false.

  • Indstillingen gælder for alle opgaver (tale- og digitale kanaler), der udføres på skrivebordet — f.eks. accept af en opgave, konference, konsultation eller overførsel, og for udgående opkald, udgående kampagneopkald, automatisk afslutning osv.
  • Indstillingen gælder ikke, hvis skrivebordsbrugeren er på startsiden uden nogen aktiv opgave i ruden Opgaveliste. I et sådant tilfælde, når en ny opgave accepteres, flyttes fokus fra start siden til den nyligt accepterede opgave.

DragDropEnabled

Hvis du vil aktivere træk-og-slip og ændre størrelsen på widgets på de brugerdefinerede sider, skal du indstille værdien til true. Standardværdien er falsk.

Eksempel:

"dragDropEnabled": false

Du kan finde flere oplysninger om aktivering af træk-og-slip-funktionen for fanerne i ruden Hjælpeoplysninger under Ruden Hjælpeoplysninger.

NotificationTimer

For at indstille varigheden (i sekunder), hvorefter skrivebordsmeddelelserne på skrivebordet automatisk afvises. Meddelelsen vises øverst til højre på skrivebordet. Standard timeout-værdien er 8 sekunder. Det gyldige interval for timeout-værdier er 1-10 sekunder. For at timeout-ændringerne kan træde i kraft, skal browseren opdateres, når ændringerne er foretaget.

Eksempel:

"notificationTimer": 8

Maksimalt antal notifikationer

Sådan indstiller du antallet af skrivebordsmeddelelser, der skal vises ad gangen på skrivebordet. Standardværdien er 3. Rækkevidden for desktop-meddelelser er 1-10. Skrivebordsmeddelelserne er stablet. Hvis der er mange underretninger, vises de med en lille forsinkelse afhængigt af indstillingerne for NotificationTimer.

Eksempel:

"maximumNotificationCount": 3

BrowserNotificationTimer

Sådan indstilles varigheden (i sekunder), hvorefter browserens brødristermeddelelser på skrivebordet automatisk afvises. Toaster er en indbygget browsermeddelelse, der kun vises, hvis skrivebordet ikke er det aktive browservindue eller fane. Desktop-browservinduet eller fanen er inaktiv, når

  • Du arbejder på andre browservinduer eller faner.

  • Du arbejder på andre applikationer.

  • Du har minimeret skrivebordsbrowservinduet.

Meddelelsen vises øverst til højre på skrivebordet. Standard timeout-værdien er 8 sekunder. Det anbefalede interval for timeout-værdier er 5-15 sekunder. For at timeout-ændringerne kan træde i kraft, skal browseren opdateres, når ændringerne er foretaget.

Eksempel:

"browserNotificationTimer": 8

Den konfigurerede timeout for browsermeddelelser afhænger af operativsystemet og browserindstillingerne. Timeout-værdien respekteres i Chrome-browseren på tværs af Windows OS, Chrome OS og macOS. De andre understøttede browsere respekterer dog ikke den konfigurerede timeout-værdi for meddelelser konsekvent.

wxmKonfigureret

(Valgfrit) Hvis du vil konfigurereWebex Experience Management, skal du indstille værdien til true. Standardværdien er falsk.

Eksempel:

"wxmConfigured": true

DesktopChatApp

Sådan konfigurerer du flere Cisco-tilbudte chat-applikationer, f.eks. Webex App.

WebExkonfigureret

Webex-appen sammen med dens messaging- og mødefunktioner kan konfigureres på skrivebordet. Denne konfiguration gør det muligt for agenter at samarbejde med andre agenter, vejledere og emneeksperter (SMV'er) i deres organisation uden at navigere væk fra skrivebordet.

Sådan konfigureres Webex-appen på skrivebordet:

  • Når du Cisco Webex Control Hub tilføjer tjenester til en bruger, skal du markere afkrydsnings feltet Avancerede meddelelser (Bru gere > Administrer brugere > T jenester > Bes k eder). Du kan finde flere oplysninger under Administrer brugerkonti i Web Cisco Webex stedsadministration.

  • I det brugerdefinerede skrivebordslayout skal du indstille egen skabsværdien WebExConfigu red til true.

    Eksempel:

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

    Standardværdien for egenskaben WebExConfigured er falsk.

    Webex App er kun tilgængelig for rollerne agent, supervisor og SupervisorAgent, hvis du indstiller egenskabsværdien WebEx Configured til true for hver af disse roller. Agenten, vejlederen eller SupervisorAgent kan ikke logge af Webex-appen.

    Hvis du vil have vist ikonet Webex ikon (Webex) på skrivebordets vandrette overskrift, skal du indtaste værdien webex i egenskaben HeaderActions. Du kan finde flere oplysninger i He aderActions.

    Hvis du vil aktivere Webex App for et bestemt team, skal du vælge det brugerdefinerede layout med egenskabsværdien WebExConfigured indstillet til true. Du kan finde flere oplysninger i Oprette et team.

Du kan også konfigurere Webex App i ruden Hjælpeoplysninger, brugerdefineret side og brugerdefineret widget. Du kan finde flere oplysninger i Ru den med hjælpeoplysninger.

Meddelelse om Webex-app

De værdier, der er angivet ved hjælp af egenskaberne NotificationTim er og BrowserNotificationTim er for meddelelsestimeren, gælder for Webex App. Standard-timeout-værdien er 8 sekunder for disse egenskaber. Du kan finde flere oplysninger i NotificationTimer og BrowserNotificationTimer.

OverskriftHandlinger

For at ændre rækkefølgen af ikonerne på skrivebordets vandrette overskrift. Standardrækkefølgen er som følger:

  1. Webex ikon(Webex)

  2. Brug telefon til lydindikator(Outdial opkald)

  3. Meddelelsesikon.(Meddelelsescenter)

Indstil værdien af egenskaben HeaderActions som følger:

Ikonnavn

HeaderActions Egenskabsværdi

Webex-appen

webex

Outdial opkald

udendørs

Meddelelsescenter

anmeldelse

Eksempel:

„HeaderActions“: ["webex“, „outdial“, „notifikation"],

Egenskabsværdien HeaderActions skelner mellem store og små bogstaver.

Hvis du vil ændre ikonernes standardrækkefølge, skal du angive egenskaben HeaderActions og værdierne i det brugerdefinerede layout i overensstemmelse hermed.

Eksempel:

„HeaderActions“: ["meddelelse“, „outdial“, „webex"],
  • Hvis du ikke angiver egenskaben He aderActions og -værdierne i det brugerdefinerede layout, vises ikonerne i standardrækkefølgen.
  • Hvis du vil fjerne side hovedikonerne og de tilknyttede funktionaliteter fra skrivebordet, skal du angive en tom værdi for egenskaben HeaderActions („HeaderActions“: []). Men hvis du har tilføjet Webex-appen til ruden Hjælpeoplysninger eller en brugerdefineret side eller som en brugerdefineret widget, kan agenten stadig få adgang til Webex-appen, selvom Webex-appen ikke er tilgængelig i den vandrette overskrift på skrivebordet.
  • Hvis egenskabsværdien WebExConfigu red er angivet som falsk, vises ikonet Webex App ikke på skrivebordets vandrette overskrift, selvom webex- værdien tilføjes i egenskaben HeaderActions. Du kan finde flere oplysninger under WebExConfigured.

område

Areaegen skaben er kernesektionen i skrivebordslayoutet. Du kan definere layoutet 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: Repræsenterer det andet panel eller panelet længst til højre i ruden Hjælpeoplysninger.

  • Navigation: Repræsenterer brugerdefinerede sider og deres navigationselementer, der er relateret til siderne.

  • Vedvarende: Repræsenterer widgets på sideniveau, der er vedvarende og vises på alle sider på skrivebordet.

  • Hovedløs: Repræsenterer widgets, der ikke har en visuel grænseflade, men udfører logik i baggrunden.

Hvis egenskaben AdvancedHeader er konfigureret, skal egenskaberne header og HeaderActions fjernes.

AdvancedHeader

For at tilpasse synligheden og ændre rækkefølgen af ikonerne på skrivebordets vandrette overskrift. Standardrækkefølgen er som følger:

  1. Webex ikon(Webex)

  2. Brug telefon til lydindikator(Outdial opkald)

  3. Meddelelsesikon.(Meddelelsescenter)

  4. Webex Contact Center-agenttilstandsvælger.(Agenttilstandsvælger)

Indstil værdien af egenskaben AdvancedHeader som følger:

Ikonnavn

HeaderActions Egenskabsværdi

Webex-appen

agentx-webex

Outdial opkald

agentx-outdial

Meddelelsescenter

agentx-meddelelse

Agenttilstandsvælger

agentx-tilstandsvælger

Eksempel:

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

Egenskabsværdien AdvancedHeader skelner mellem store og små bogstaver.

Hvis du vil ændre ikonernes standardrækkefølge, skal du angive egenskaben AdvancedHeader og værdierne i det brugerdefinerede layout i overensstemmelse hermed.

Widgets flyder ind i rullemenuen fra venstre mod højre.

  • Hvis du ikke angiver egenskaben AdvancedHeader i det brugerdefinerede layout, vises standardsidehovedet.

  • Når avanceret header er aktiveret, skal du flytte widgets fra den eksisterende header til den avancerede header i henhold til eksemplet.

  • Når avanceret header er aktiveret, vises den gamle header ikke.

  • Hvert widgetikon har en standardpolstring og margen, der er defineret gennem CSS og kan ikke tilpasses via skrivebordet.

  • Placeringen af logoet, titlen og profilikonerne er faste og kan ikke tilpasses.

  • Hvis du vil fjerne sidehovedikonerne og de tilknyttede funktionaliteter fra skrivebordet, skal du angive en tom værdi for den tilknyttede komponent i egenskaben AdvancedHeader („AdvancedHeader“: []).

    Hvis du har føjet Webex-appen til ruden Hjælpeoplysninger eller en brugerdefineret side eller som en brugerdefineret widget, kan agenten stadig få adgang til Webex App, selvom Webex-appen ikke er tilgængelig i den vandrette overskrift på skrivebordet.

  • Hvis du tilføjer en widget med en lang etiket, vises et afkortet etiketnavn i henhold til den tilgængelige plads.

    Du kan bruge attributten TextContent til at føje en etiket til 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"
            }

    Mærket „Nedtællingstimer for aktuelt skift“ afkortes og vises i henhold til den tilgængelige plads.

    • Undgå at tilføje widgets med en lang etiket.

    • Når en widget flyder til rullemenuen, er det kun widgetikonet, der kan klikkes på.

  • Hvis egenskabsværdien WebExConfigu red er angivet som falsk, vises ikonet Webex App ikke på skrivebordets vandrette overskrift, selvom webex- værdien tilføjes i egenskaben AdvancedHeader. Du kan finde flere oplysninger under WebExConfigured.

Hjemmesiden

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

Hjemmesiden gælder kun for Supervisors og SupervisorAgent-persona.

Du kan se følgende widgets på startsiden. Analyzer widgets leveres som standard, men administratoren kan også konfigurere vedvarende og brugerdefinerede widgets. Du kan finde flere oplysninger i Egenskaber for JSON-layout på øverste niveau.

Analyzer Widgets

Som standard vises Analyzer-widgeten på skrivebordets startside.

Konfiguration af startsidelayout

Du kan konfigurere startsiden på skrivebordet til at vise layout, der er baseret på dine organisationspræferencer og brandjustering. Rediger feltet Startside for at konfigurere startsiden. Du kan konfigurere følgende komponenter til at blive vist på startsiden, når en bruger logger på skrivebordet:

  • En velkomstbesked

  • Op gaveik onet på navigationslinjen for at navigere til opgaveruden. Op gaveik onet vises for rollen Supervisor og Supervisor & Agent med opkaldsovervågningsfunktionen aktiveret. Opgaveruden viser indgående kundeanmodninger, aktive og tidligere kundeinteraktioner og aktive overvågningsanmodninger.

  • Filtrer sektioner som kønavn, kanaltype og administrerede teams.

Følgende tabel beskriver de side egenskaber, der kræves for at konfigurere startsiden:

Tabel 2. Dynamisk startsidelayout — Sideegenskaber

Ejendom

Beskrivelse og kode

side > UseFlexLayout

Flex layout er en ny webkomponent. Det ændrer ikke de eksisterende widgets. Det nye flex layout bruger det samme layoutkonfigurationsformat på en forenklet måde. Det er bagudkompatibelt og påvirker ikke eksisterende widgets. Du skal konfigurere JSON-layoutet. For at konfigurere JSON-layoutet skal du angive widgetens højde og bredde. Widgeten gengives i samme rækkefølge, som den er konfigureret inde i JSON-layoutet. Widgets har en standardmargen på 8 px.

JSON-layoutet er baseret på widget'ernes dimensioner (bredde x højde) og koordinater (X, Y og Z).

Det fleksible layout understøtter funktioner såsom individuel widgetstørrelse, maksimering af widgets og så videre.

Højden af individuelle widgets måles i pixels. 1 højdeenhed = 40 pixels. Widgetens bredde afhænger af antallet af kolonner i beholderen og antallet af kolonner, der ændres baseret på beholderbredden.

Widgets vises fra venstre til højre. Den avancerede layoutmotor bruger brugerdefineret logik til at anvende både vandret og lodret rumjustering af widgets. Indledningsvis indlæses layoutet vandret. Efter indlæsning vandret indlæses widgeten lodret og sikrer, at pladsudnyttelsen er optimal.

Konfigurer widgets baseret på skærmstørrelsen. Du kan enten øge eller formindske bredden af widgets, baseret på skærmstørrelsen. Dette gør widgets mere læsbare og brugbare.

Flex-layout giver standardbrudpunkter som store, mellemstore, små og ekstra små.

  • Store widgets har en opløsning på 1360 px eller mere. For store widgets skal du angive kolonneværdien som 12.

  • Medium widgets har en opløsning på 1070 px til 1360 px. For mellemstore widgets skal du angive kolonneværdien som 10.

  • Små widgets har en opløsning på 850 px til 1070 px. For små widgets skal du angive kolonneværdien som 6.

  • Ekstra små widgets har en opløsning på 500 px. For ekstra små widgets skal du angive kolonneværdien som 4.

Disse pixels kan variere afhængigt af operativsystemet og browseren.

"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 leverer en unik brugerdefineret komponent.

"comp": "page-title",

Side title- komponenten repræsenterer niveau 2 overskrift for <h2>det brugerdefinerede HTML-element.

side > PageHeader

Sørg for at angive en titelstreng, der kan være statisk, dynamisk eller begge dele.

Side title- komponenten repræsenterer niveau 2-overskrift <h2>i det brugerdefinerede HTML-element.

  • Statisk streng: For eksempel Hej, Velkommen!

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

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

  • Begge: Kombinationen af statiske og dynamiske strenge. For eksempel, Hej Jane Doe, Velkommen!

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

    Du skal omslutte den dynamiske del af strengen inden for de lukkede krøllede parenteser {} og præfikset med strukturen $.

side > PageSubHeader

Sørg for at tilføje underoverskrift, der vises på skrivebordet. Brugeren kan tilføje Go to Analyzer i Sub Header.

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

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

Navigation (brugerdefinerede sider)

I dette afsnit kan du tilføje sider, der vises på venstre navigationslinje. Du angiver et navigationsikon og en unik webadresse, som widgeten skal vises på navigationslinjen. Vi anbefaler at bruge et specifikt præfiks til URL'en for at undgå konflikter. For flere detaljer, se afsnittet navigationsegen skaber.

Du kan også have en samling widgets, der kan vises på denne side. Siden kan have en enkelt widget, der vises på skærmen, eller en samling af widgets i et gitter. Du kan finde flere oplysninger om gitterarrangement i afsnittet layoute genskaber.

Du behøver ikke at tilføje en dynamisk områdeindpakning til widgettræet. Det betyder, at du kan trække og slippe og ændre størrelse på widgets på brugerdefinerede sider, når du aktiverer denne indstilling.

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

Følgende tabel beskriver nav- og side egenskaber sammen med deres underordnede egenskaber:

Tabel 3. nav Ejendomsoplysninger

Ejendom

Beskrivelse og kode

nav > etiket

Denne egenskab angiver sidens navigationsidentifikator. Skærmlæseren læser denne egenskab, og den vises i værktøjstipet.

Disse parametre er nødvendige for at vise din brugerdefinerede side på navigationslinjen.

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

Etiketegenskab en er titlen på den brugerdefinerede side.

nav > Ikontype

Denne egenskab repræsenterer den type ikon, der vises i navigationslinjen for den brugerdefinerede side.

Følgende typer ikoner er tilgængelige:

  • MomentumDesign: Du kan vælge alle tilgængelige ikoner i samlingen: https://momentum-design.github.io/momentum-design/en/tokens/icons/. Fordelen ved at bruge Momentum er, at det giver et par ikoner med en „aktiv“ version.

    Anvendelsestilfælde for en aktiv version:

    Hvis du f.eks. vælger en meddelelse om Momentum-ikontypen, kan du se standardikonet på navigationslinjen. Når du navigerer til den brugerdefinerede side (linket til ikonet), ændres ikonet automatisk til den meddelelsesaktive version. Sørg for, at du kontrollerer, om det har en aktiv version af det samme ikon i ikonbiblioteket.

  • An det: Du kan angive en brugerdefineret billede-URL (hostet på et CDN), der vises på navigationslinjen. Hvis du bruger et sort/hvidt brugerdefineret ikon, er ikonet ikke synligt, når du skifter mellem lys og mørk tilstand.

nav > ikon

Denne egenskab repræsenterer navnet på ikonet i Momentum-biblioteket eller CDN-URL'en.

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

nav > ju ster

Denne egenskab hjælper dig med at justere ikonet til toppen eller bunden af navigationslinjen.

I øjeblikket tillader egenskaben kun topjustering.

nav > is DefaultLandingPage

Denne egenskab angiver standarddestinationssiden for agenterne iAgent Desktop. Indstil denne egenskab til true for at gøre navigationslinjesiden til standarddestinationssiden, der vises for agenterne, når de er logget påAgent Desktop. Hvis mere end én navigationslinjeside har denne egenskab ind stillet til true, betragter systemet den første navigationslinjeside som standarddestinationsside.

Hvis ingen navigationslinjeside har denne egenskab ind stillet til true, fungerer startsiden som standarddestinationsside.

Du kan ikke angive rapporter Analyzer og Agent Performance Statistics som standarddestinationsside.

nav > Naviger til

Denne egenskab angiver navnet på den brugerdefinerede side. Dette navn vises i adresselinjen, når agenten navigerer.

NavigateTo må ikke indeholde følgende værdier: billeder, skrifttyper, css, build_info, help, app, i18n, ikoner, billeder-mfe-wc og lyde.

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

Ejendom

Beskrivelse og kode

side > id

I side egenskab angiver du det brugerdefinerede sideobjekt (dynamisk widget).

Egen skaben id repræsenterer en unik sideidentifikator. For eksempel my-bruger-page-1. Agenten kan ikke se denne identifikator på skrivebordet.

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

side > UseFlexLayout

Flex layout er en ny webkomponent. Det ændrer ikke de eksisterende widgets. Det nye flex layout bruger det samme layoutkonfigurationsformat på en forenklet måde. Det er bagudkompatibelt og påvirker ikke eksisterende widgets. Du skal konfigurere JSON-layoutet. For at konfigurere JSON-layoutet skal du angive widgetens højde og bredde. Widgeten gengives i samme rækkefølge, som den er konfigureret inde i JSON-layoutet. Widgets har en standardmargen på 8 px.

JSON-layoutet er baseret på widget'ernes dimensioner (bredde x højde) og koordinater (X, Y og Z).

Det fleksible layout understøtter funktioner såsom individuel widgetstørrelse, maksimering af widgets og så videre.

Højden af individuelle widgets måles i pixels. 1 højdeenhed = 40 pixels. Widgetens bredde afhænger af antallet af kolonner i beholderen og antallet af kolonner, der ændres baseret på beholderbredden.

Widgets vises fra venstre til højre. Den avancerede layoutmotor bruger brugerdefineret logik til at anvende både vandret og lodret rumjustering af widgets. Indledningsvis indlæses layoutet vandret. Efter indlæsning vandret indlæses widgeten lodret og sikrer, at pladsudnyttelsen er optimal.

Konfigurer widgets baseret på skærmstørrelsen. Du kan enten øge eller formindske bredden af widgets, baseret på skærmstørrelsen. Dette gør widgets mere læsbare og brugbare.

Flex-layout giver standardbrudpunkter som store, mellemstore, små og ekstra små.

  • Store widgets har en opløsning på 1360 px eller mere. For store widgets skal du angive kolonneværdien som 12.

  • Medium widgets har en opløsning på 1070 px til 1360 px. For mellemstore widgets skal du angive kolonneværdien som 10.

  • Små widgets har en opløsning på 850 px til 1070 px. For små widgets skal du angive kolonneværdien som 6.

  • Ekstra små widgets har en opløsning på 500 px. For ekstra små widgets skal du angive kolonneværdien som 4.

Disse pixels kan variere afhængigt af operativsystemet og browseren.

"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

Hjælper dig med at definere dine brugerdefinerede widgets. Hvis du vil placere flere widgets, skal du angive widgetindstillinger i rækkefølge. Sørg for, at du giver hver widget et unikt områdenavn. Brug det i layoutsektionen senere.

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

Denne egenskab repræsenterer navnet på det brugerdefinerede HTML-element (kendt som en webkomponent eller et andet element - hvis du vil bruge det som en indpakning). Du kan finde flere oplysninger i Eksempler på eksempler på brugssager. Indtast dit brugerdefinerede elementnavn her uden vinkelparenteser („<“ or „>“). For eksempel „my-custom-element.“

Hver post under widgets-sektionen understø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 > script

(Valgfrit) Denne egenskab er kun påkrævet, når du indlæser widgeten eller komponenten fra en ekstern placering, f.eks. et CDN.

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

Du må ikke ændre script-URL-adressen for den samme komponent. Hvis du har brug for at ændre script-URL-adressen for den samme komponent, skal du gøre et af følgende:

  • Giv agenten besked om at rydde browserens cache og genind Agent Desktop læse.

  • Bevar den eksisterende URL. Importer dynamisk den nye bundt-URL ved hjælp af javascript, der hostes i den eksisterende webadresse.

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

Du kan angive egenskaber, som du skal videregive for webkomponenten.

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

side > Responsive

Bestemmer, om en webkomponent eller en iFrame-baseret widget, der tilføjes i det brugerdefinerede layout på sideni veau eller på comp-niveau, er responsiv. Responsive webkomponenter gør din webside visuelt tiltalende på alle enheder og er nemme at bruge. Du skal bruge responsive iFrame-widgets.

Konfigurer denne egenskab med en af følgende værdier:

  • Sandt: Aktiverer widgetens lydhørhed. Som standard reagerer alle widgets baseret på de progressive skærmstørrelser, orientering og visningsområder på den enhed, der er i brug.

  • Falsk: Deaktiverer widgetens reaktionsevne. Hvis widgets ikke understøtter visning på forskellige enheder, skal du markere 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 widgets kan ikke sikre den bedste brugeroplevelse og vises ikke i den mindre visning. Agenten skal øge størrelsen på browservinduet for at få vist alle widgets, der er konfigureret som ikke-responderende.

side > attributter

Du kan angive webkomponentattributterne i dette afsnit.

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

side > synlighed

Angiver, om de Cisco-tilbudte widgets, der er tilføjet i det brugerdefinerede layout på si deniveau eller på comp-niveau, er synlige eller ej.

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

  • Værdi erne for syn lighedsegenskaberne er indbygget og defineret i standard JSON-filen i skrivebordslayoutet. Administratoren kan ikke ændre værdierne for synlighedsegen skaberne for de Cisco-tilbudte widgets.

  • Værdien for synlighed segenskaben NOT_RESPONSIVE er foræl det. Du kan fortsætte med at bruge det kun til bagudkompatibilitet. Enhver værdi, der tidligere er indstillet som NOT_RESPON SIVE, kræver ikke ændring, da funktionaliteten forbliver den samme.

    Hvis du vil angive en nyoprettet widget som responsiv eller ikke responsiv, skal du bruge egenskaben responsive. Du kan finde flere oplysninger i Responsive Property.

side > børn

Denne egenskab er kernedelen af layoutet. I afsnittet Under ordnede kan du indlejre så mange niveauer som nødvendigt, hvis den webkomponentbaserede widget giver dig mulighed for at videregive underordnede. For at gøre det muligt skal udvikleren programmatisk håndtere det spaltede indhold. Du kan finde flere oplysninger i Cisco Webex Contact CenterDesktop Developer Guide.

Hvis du vil vide, hvordan du overfører STORE-værdier som egenskaber, skal du se Del data fra skrivebord til widgets.

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

Fordelen ved afsnittet „Children“ array er, at du kan bruge eksisterende webkomponenter i din layoutspecifikation, som allerede er en del af skrivebordspakken. Et par af Webkomponenterne til Desktop-bundtet omfatter:

  • agentx-wc-iframe: En widget, der giver dig mulighed for at placere enhver webside i en iFrame som en widget.

  • dynamisk område: En komponent, der giver dig mulighed for at aktivere træk-og-slip-funktionen for agenter et andet sted end brugerdefinerede sider. De brugerdefinerede sider kan også have denne funktion, hvis du aktiverer træk-og-slip som standard.

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

    • md-tabs: Tabs-beholderindpakning

    • md-tab: Enkelt faneoverskrift

    • md-tab-panel: Enkelt faneindhold

Du kan finde flere oplysninger om attributterne for den vedvarende fane under Attri butter for vedvarende faner.

side > TextContent

Hjælper dig med at tilføje dit tekstindhold.

"textContent": "My Text Content",

side > stil

Hjælper dig med at tildele en bestemt CSS-stil til din komponent.

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

side > indpakning

Widget wrapper giver dig mulighed for at tilføje en værktøjslinje oven på din widget. Værktøjslinjen kan indeholde en titel og ikonet Maksimer ikon (Maksi mer) øverst på widgeten. Når widgeten har optaget en lille plads på siden, giver maksimeringsikonet agenten mulighed for at se widgeten i hele arbejdsområdet.

Sørg for, at du bruger standardværdien som „app-maximize-area“. I øjeblikket er kun standardværdien tilgængelig. Hvis layoutet er konfigureret ved hjælp af UseFlexLayout, kan du aktivere ikonet for maksimering/gendannelse i widgetoverskriften ved at tilføje attributten isMaximizable til widgetens konfiguration og indstille dens værdi til true.

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

side > indpakning> id

(Valgfrit) Widget-indpakningen til webkomponenten giver dig mulighed for at opdatere den dynamiske widgettitel ved hjælp af en entydig identifikator. Indtast egenskabsværdien for widgetwrapper- id som unik -id-to-update-title.

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

Sørg for, at du bruger den samme entydige identifikator til JavaScript CustomEvent. Du kan finde flere oplysninger i afsnittet Asynkrone hændelser i kapit let Agentkontaktmodul i Cisco Webex Contact CenterDesktop Developer.

Hvis du vil opdatere den iFrame-baserede widgettitel, skal du bruge iFrame-indholdet fra det samme domæne. Følgende er et eksempel:

<
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

Giver dig mulighed for at integrere en webside i en iFrame, der vises som en widget på skrivebordet. Du kan bruge iFrame-widgeten kaldet „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

Giver dig mulighed for at arrangere widgets på en side.

Følgende format repræsenterer et gitterlayout:

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

Her kan du definere gitteret med de områdenavne, du har defineret i sektionen widgets.

Følgende eksempel viser, hvordan layoutet af tre rækker og tre kolonner er angivet:

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

I størrelsesafsnittet repræsenterer tal den brøkdel af plads, som en widget kan optage i forhold til de andre widgets. Alle tre kolonner optager lige 1 brøkdel af rummet. Med 100% som tilgængelig bredde optager hver widget 33,33% af vandret plads.

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

Et andet eksempel på brugen, hvis du indstiller som „cols“: [1, 2, 2], betyder det, at det samlede rum divideres med 5 (1+2+2), og den første widget optager 20% af vandret plads. Den anden og tredje widget tager 40% hver. Du kan finde flere oplysninger i Grund læggende begreber i gitterlayout.

Unequal column width layout for Webex Contact Center Desktop layout configuration.
Efter ændring af kolonnebredden

side > ROOT

Indlejring af layout kaldes en sublayout. Hvis du har indlejrede layout i din layoutkonfiguration, skal du have et enkelt „ROOT“ -objekt som overordnet for underlayouts. Ellers kan din layoutkonfiguration være flad, hvis der ikke kræves indlejring.

Denne underopdeling giver mere kontrol over layoutændringens størrelse. Egenskab en sidelayout skal være af typen Record<string, Layout>. Layoutegenskaben giver dig mulighed for at arrangere widgets 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]
            }
        }
    }
}

Denne opsætning opretter et gitter i ROOT-layoutet med to undergitre, som du kan ændre størrelsen på uafhængigt af hinanden.

Sub-layout appearance for Webex Contact Center Desktop layout configuration.
Udseende af underlayout

Ændring af størrelse på en komponent påvirker komponenterne i underlayoutet.

Sub-layout appearance, after resizing both sub-layouts, for Webex Contact Center Desktop layout configuration.
Efter ændring af størrelse på begge underlayouts

Vær opmærksom på følgende tilfælde:

Uendelig sløjfe: Hvis du inkluderer ROOT-layout som en underudlægning af ROOT, forårsager det en „call stack“ -fejl og løber ind i en uendelig sløjfe.

{
    "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 Infinite Loop

Samme underlayout (N) gange: Hvis du medtager underlayoutet i gitteret mere end én gang med det samme navn, og hvis du ændrer størrelsen på et af dem, ændres størrelsen på alle underlagene automatisk.

Hvis dette ikke er den ønskede funktion, skal du omdøbe hvert af underlagene med et entydigt 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 gange

Attributter for vedvarende faner

Hvis du vil angive fanerne på de brugerdefinerede sider og brugerdefinerede widgets som vedvarende, skal du angive attributterne for md-tabs i det brugerdefinerede layout.

Eksempel: Angiv faner som vedvarende

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

Ejendom

Beskrivelse

vedvarende udvælgelse

For at indstille md-tabs til at være vedvarende. Standardværdien er sand.

faner-id

Unik identifikation for alle fanerne samlet i beholderen.

Når du indstiller md-tabs til at være vedvarende (persist-selection: true), bevares fan Agent Desktop evalget, selvom en agent skifter mellem sider eller widgets på skrivebordet.

  • Egenskab en vedvarende mar kering gælder ikke for fanerne i ruden Hjælpeoplysninger og siden Rapporter om agentpræstationsstatistik, fordi funktionsmåden for vedvarende faner allerede er angivet på skrivebordet .
  • Valget af faneblad nulstilles til standardfanen, når du logger ud af skrivebordet, genindlæser/opdaterer browseren eller rydder browserens cache.

Konfiguration af vedvarende widgets

Du kan konfigurere enhver brugerdefineret widget til at være vedvarende. Vedvarende widgets vises på alle sider på skrivebordet. Vedvarende widgets vises kun som en ny fane i ruden Hjælpeoplysninger, når du har en aktiv kontaktanmodning eller samtale. For eksempel, Eksem pel på vedvarende widget.

Vedvarende widgets vises ikke på startsiden på den måde, de vises på de andre sider. Men hvis du har en aktiv interaktion, vises de vedvarende widgets på startsiden som en del af ruden Hjælpeoplysninger. Når du f.eks. har besvaret et opkald, vises ruden Interaktionskontrol, og widgeten Eksempel på vedvarende vises som en del af ruden Hjælpeoplysninger.

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 vælge en af indstillingerne:

  • Hoster et program på en webside, der kan integreres i en iframe.

  • Byg en brugerdefineret widget.

De tekniske krav til widget er beskrevet i dokumentationen til udvikling af skrivebordswidget. Som layouteditor skal du sørge for, at du har disse oplysninger:

  • Hvad hedder det brugerdefinerede HTML-element (kendt som Web Component)?

  • Hvad er webadressen til CDN-kilden (Content Delivery Network), der er vært for JavaScript-bundtet?

Overskrift Widgets

Overskriften bruges til at vise inline-oplysninger, til at tilføje rullemenuer osv. Da sidehovedbeholderen har begrænset lodret plads, er den samlede sidehovedhøjde kun 64 pixels. Du kan finde flere oplysninger om layoutjusteringen i afsnittet layoute genskaber.

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 tilføje et værktøjstip til en header-widget, skal du omslutte komponenten med m d-tooltip. Angiv oplysninger om værktøjstip i meddelelsesegenskaben.

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 skal tilføje typografitternes visning og højde for at konfigurere eventuelle widgets via iFrame i det tilpassede widgetområde i overskriften. Den bedste pasningsværdi for attribut ten height er 64 pixels.

Sørg for, at du føjer typografiattributterne til de eksisterende header-widgets, så de kan indlæses 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 kun bruger en enkelt række med flere kolonner til overskriften, da sidehovedhøjden kun er 64 pixels. Du kan finde flere oplysninger om justeringen i afsnittet layoutegen skaber.

Hjælpeinformationsrude

Ruden Hjælpeoplysninger på skrivebordet viser fanerne, der omfatter de Cisco-tilbudte (standard) widgets og brugerdefinerede widgets. Følgende Cisco-tilbudte widgets vises i de foruddefinerede faner:

  • Kontakthistorik

  • IVR-udskrift

  • Kundeoplevelsesrejse

  • Skærm Pop

Du kan bruge ruden Hjælpeoplysninger til at:

  • Tilføj faner

  • Ændre tabulatorrækkefølgen

  • Fjern foruddefinerede faner

  • Marker de brugerdefinerede faner som trækbare

  • Føj værktøjstip til de brugerdefinerede faner

  • Tilføj indstillingen Nulstil tabulatorrække 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 Kundeoplevelsesrejse, når du har aktiveret målingerne for styring af kundeoplevelser påManagement Portal.

I ruden Hjælpeoplysninger skal du tilføje nye faner for at placere dine brugerdefinerede widgets. Der gælder ingen særlige regler her, og komponentindlejringen er som forventet og beskrevet i børne afsnittet. Du kan finde flere oplysninger i egen skab en Børn på siden.

Følgende er de specifikke eksempler til tilpasning af dine faneoverskrifter:

Eksempel på placering af ikoner og etiketter i egenskaben Børn

{
    "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å placering af billede (med CSS) og etiketter i egenskaben Children

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

Rullelisten Flere faner vises automatisk, når ruden Hjælpeoplysninger indeholder flere faner.

Du skal tilføje et brugerdefineret faneværktøjstip for læsbarhed og tilgængelighed. Hvis du vil tilføje et værktøjstip til en brugerdefineret fane, skal du omslutte komponenten med m d-tooltip. Indtast værktøjstipoplysningerne i meddelelses egenskaben, og anven d typografiegenskaberne som vist i følgende eksempel.

"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 brugerdefineret fane anbefaler vi en maksimal bredde på 252 pixels og en minimumsbredde på 110 pixels.

Hvis du vil aktivere træk-og-slip-funktionen i den brugerdefinerede fane, skal du tilføje følgende egenskab inden for attributterne:

"comp": "md-tabs",
"attributes": {
    "class": "widget-tabs",
    "draggable": true,
    "comp-unique-id": "sample-dynamic-custom-tabs"
},
  • trækbar: Indstil egenskabsværdien, der kan trækkes, til true.

  • comp-unique id: An giv en unik værdi for at identificere komponenten.

    Eksempel:

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

Hvis du aktiverer træk og slip for en brugerdefineret fane, kan agenten trække og slippe fanen til den ønskede position i ruden Hjælpeoplysninger. Hvis du vil nulstille fanerne til standardtabulatorrækkefølgen, skal du tilføje følgende egenskab:

"comp": "agentx-wc-more-actions-widget",
"attributes": {
    "slot": "settings",
    "class": "widget-pane",
    "tabs-unique-id": "sample-dynamic-custom-tabs"
},
  • agentx-wc-more-actions-widget: Angiv den komponent, der vises som ikonet Flere handlinger () Flere handlinger ikon i ruden Hjælpeoplysninger.

  • 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 nulstille fanerne i ruden Hjælpeoplysninger til standardrækkefølgen ved at klikke på Flere handlinger ikon > Nulstil fanerækkefølge.

  • tabs-unice-id: Indtast den samme unikke værdi, der er defineret for egenskaben comp-unique id for at kortlægge og nulstille md- tabs-komponenterne.

Følgende eksempelkode bruger funktionerne Flere handlinger og Nulstil tabulatorrække 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 defineres værktøjstip, ellipseikon og nulstilling af tabulatorrækkefølge for foruddefinerede faner.

Rullelisten Flere handlinger kan udvides til at tilføje yderligere brugerdefinerede komponenter eller widgets efter indstillingen Nulstil tabulatorrække følge. Følgende er et eksempelsæt af typogra fegenskabsværdier, der kan anvendes på yderligere komponenter.

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

Træk-og-slip-funktionen understøttes ikke for de ekstra brugerdefinerede komponenter eller widgets, der føjes til rullelisten Flere handlinger.

Hovedløse Widgets

I det hovedløse afsnit kan du tilføje widgets, der er skjulte og ikke vises påAgent Desktop. Disse widgets bruges til at udføre logik i baggrunden. Dette afsnit er nyttigt til at udløse hændelser, der forekommer på skrivebordet og udføre widgetspecifik logik. For eksempel at åbne en brugerdefineret CRM-skærmpop til en SMS ved ankomsten.

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 widgets

Hvis du vil modtage data i realtid gennem egenskaber eller attributter inde i en brugerdefineret widget, skal du tildele passende STORE-værdier i layoutets JSON-konfiguration.

For at få adgang til dataene via JavaScript SDK-abonnenter kan du desuden videregive dataene gennem egenskaber eller attributter. Hvis din komponent er bygget til at reagere på egenskabs- eller attributændringer, får du dataopdateringer i realtid fraAgent Desktop, som kaldes en dataudbyder.

I øjeblikket har vi en enkelt dataudbyder under en nøglelager. Du kan finde flere oplysninger i afsnittet Data Provider — Widget Properties and Attributes i Cisco Webex Contact CenterDesktop Developer Guide.

Forhåndsvisning af kampagneopkald

Administratoren opretter kampagner, konfigurerer opkaldstilstanden (forhåndsvisning) og tildeler kampag nerne til teams. Hvis en agent er en del af et team, som kampagner er tildelt, kan ag enten foretage et udgående eksempelkampagneopkald. Du kan finde flere oplysninger under Konfigurere stemmeudgående kampagnetilstande i Webex Contact Center.

Administratoren konfigurerer følgende i det brugerdefinerede layout for at aktivere eksempelkampagnekontakt for en agent.

Kampagnekontakt

Administratoren tilføjer widgeten Kampagnekontakt i sidehovedbeholderen i det brugerdefinerede layout. Kampagnekontakten viser kundens kontaktoplysninger baseret på de definerede egenskaber. Du kan finde flere oplysninger om layoutjusteringen i rækken med layou tegenskaber på siden Egenskabsopl ysninger.

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

Opkaldsvejledning

Widget en Opkaldsguide vises i ruden Hjælpeoplysninger på skrivebordet. Opkaldsguiden viser spørgsmål og svar på kampagneniveau. Agenten bliver bedt om at læse gennem sættet af spørgsmål i opkaldsguiden og indsende 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 referencer til comp- egenskaber er ændret. agentx i egenskabsværdien erstattes med acqueon:
    • agentx-preview-campaign er omdøbt til acqueon-preview-campaign
    • agentx-call-guide omdøbes til acqueon-call-guide
  • Du skal være vært for Liste- og Campaign Manager (LCM) på et CDN og derefter angive URL-adressen i scrip tegen skaben.

Skærm Pop

I skrivebordslayoutet kan du konfigurere Screen Pop på en af følgende måder:

  • Som en brugerdefineret side

  • Som en af widget'erne i den brugerdefinerede side

  • Som en fane i ruden Hjælpeoplysninger

Skærmpop vises på skrivebordet baseret på følgende faktorer:

For stemmekanalen:

  • Den konfiguration, der er defineret i skrivebordslayoutet

  • Den Screen Pop-aktivitet, der er defineret i Flow Designer

For de nye digitale kanaler:

  • Den konfiguration, der er defineret i skrivebordslayoutet

  • Den Screen Pop-node, der er defineret i Connect Flow Builder

Du kan finde flere oplysninger om konfiguration af Screen Pop under Screen Pop.

Konfiguration af skærmpop i navigationslinjen

Du kan konfigurere Screen Pop som en brugerdefineret side eller som en af widget'erne på en brugerdefineret side. Klik på ikonet Screen Pop på navigationslinjen for at få adgang til den brugerdefinerede side Screen Pop. Klik på det brugerdefinerede ikon på navigationslinjen for at få adgang til widgeten Screen Pop på den brugerdefinerede side. Du kan finde flere oplysninger om navig ationsegenskaber under Navigation (brugerdefinerede sider).

Eksempel: Skærmpop som en brugerdefineret 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: Skærmpop som en widget på den brugerdefinerede side

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

Hvis Screen Pop ikke er konfigureret i Flow Designer, vises den brugerdefinerede side tom. Du kan finde flere oplysninger om konfiguration af Screen Pop i Flow Designer under Screen Pop.

Konfiguration af skærmpop i ruden med hjælpeoplysninger

Du kan konfigurere Screen Pop til at blive vist som en fane i ruden Hjælpeoplysninger.

Som standard vises Screen Pop som en ny underfane under fanen Skærm pop i ruden Hjælpeoplysninger, hvis Screen Pop er konfigureret til at blive vist som Inside Desktop i Flow Designer.

Tilføj følgende attribut i panel sektionen for at medtage Skærmpop som en fane i ruden Hjælpeoplysninger. Du kan finde flere oplysninger om panel detaljer under Ruden med hjælpeoplysninger.

Eksempel: Skærmpop som en fane i ruden Hjælpeoplysninger

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

Visningsindstillingen Screen Pop, der er defineret i Flow Designer, har forrang frem for den konfiguration, der er defineret i skrivebordslayoutet.

Overvej f.eks., at du har konfigureret følgende indstillinger for Screen Pop:

  • Flow Designer — Vis indstillinger som I den nye browserfane
  • Skrivebordslayout — Som en fane i ruden Hjælpeoplysninger

Når den begivenhed, som skærmpop er konfigureret til, forekommer, vises Screen Pop uden for skrivebordet - det vil sige i en ny browserfane.

Eksempler på eksempler på brugssager

Følgende afsnit giver et par eksempler til din reference:

Konfigurere og få adgang til widgeten Customer Experience Management Metrics fra navigationslinjen

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 at få SpaceID og MetricSID, se dokumentationen. Webex Experience Management

Brug af faner på den brugerdefinerede side

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 hjælpeinformationsrude med kontakthistorik og skærmpop

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

Hjælpeinformationsrude med widget til kundeoplevelsesrejse

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 understøtter lokalisering på 29 sprog.

Følgende er de understøttede sprog:

Bulgarsk, catalansk, kinesisk (Kina), kinesisk (Taiwan), kroatisk, tjekkisk, dansk, hollandsk, engelsk (UK), engelsk (USA), finsk, fransk, tysk, ungarsk, italiensk, japansk, koreansk, norsk, polsk, portugisisk (Brasilien), portugisisk (Portugal), rumænsk, russisk, serbisk, slovakisk, slovensk, spansk, svensk og tyrkisk.

Skrivebordsbrugergrænsefladesproget er baseret på indstillingerne for sprogindstillinger i din browser. Lad os for eksempel overveje, at du har valgt det foretrukne sprog som fransk i Firefox-browseren. Når du starter skrivebordet i Firefox-browseren, vises skrivebordsbrugergrænsefladen på Français (fransk). Den vandrette sidehoved, navigationslinje og andre komponenter, der er tilføjet i skrivebordslayoutet, lokaliseres dog ikke baseret på indstillingerne for sprogindstillinger i din browser.

Lokaliser skrivebordskomponenter

Hvis du vil lokalisere skrivebordskomponenter,

  • Brug de eksisterende lokaliseringsnøgler, der er angivet i app.json- filen. Hvis lokaliseringstasterne ikke er indstillet, bruges standardsproget engelsk (US). Du kan sende en serviceanmodning til Cisco Support for at tilføje en lokaliseringsnøgle til app.json- filen.

    Eksempel: Lokaliseringsnøgle

    {
        "common": {
            "buttonTitle": "Stop Timer"
        }
    }
  • Angiv følgende egenskab, der skelner mellem store og små bogstaver i JSON-filen Desktop Layout for at lokalisere en komponent:

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

    hvor <key>henviser til den tilsvarende lokaliseringsnøgle i app.json- filen.

Eksempel: Lokaliser sidehovedkomponent

"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 ruden Hjælpeoplysninger

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