- Start
- /
- Artikel
Skapa anpassad skrivbordslayout
Den här artikeln hjälper dig att skapa en anpassad layout genom att redigera en JSON-fil och erbjuder exempel på användningsfall som hjälper dig att komma igång med widgetar som widgeten Customer Experience Management Metrics och widgeten Customer Experience Journey. För att effektivt arbeta med anpassade skrivbordslayouter bör du ha en gedigen förståelse för HTML-strukturen, dokumentträdmodellen i en webbläsare och JSON-formatet.
Översikt
Funktionen Skrivbordslayout låter dig konfigurera Webex Contact Center Desktop enligt dina företagskrav. Du kan anpassa element som logotyp, titel och widgets. Du kan skapa en skrivbordslayout och tilldela den till ett team. Den här layouten genererar agentupplevelsen på skrivbordet för alla agenter som loggar in som en del av det teamet.
Det finns två typer av layouter:
-
Global layout: Den här layouten är en systemgenererad layout som tilldelas som standard när du skapar ett team. Mer information finns i Hantera team. När du skapar ett team ställs den globala layouten automatiskt in som skrivbordslayout för teamet. Du kan inte ta bort den här layouten.
-
Anpassad layout: En layout som ger en anpassad skrivbordsupplevelse. Du kan skapa en anpassad layout för ett eller flera team.
Om du tilldelar en ny skrivbordslayout när en agent är inloggad måste agenten ladda om sidan för att se den nya layouten.
Webex Contact Center Desktop stöder tre personer:
-
Ombud
-
Handledare
-
Handledare och agent
JSON-layoutfilen har separata avsnitt för var och en av personerna. Administratören bör konfigurera inställningarna för varje person i motsvarande avsnitt i JSON- layoutfilen. Mer information om ett exempel på en JSON-layoutfil finns i Egenskaper för JSON-layout på toppnivå.
När Cisco lägger till en ny funktion i skrivbordslayouten uppdateras den omodifierade layouten automatiskt med de nya funktionerna. Den uppdaterade skrivbordslayouten är automatiskt tillgänglig för befintliga team som använder den omodifierade skrivbordslayouten. Skrivbordsanvändare som använder den omodifierade skrivbordslayouten får de nya layoutbaserade funktionerna när de loggar in eller laddar om webbläsaren.
Om du använder Def ault Desktop Layout.json- filen utan
någon ändring anses den vara en omodifierad layout. Om du
hämtar filen Standard Desktop Layout.json och laddar upp den
igen betraktas den som en modifierad layout även om filinnehållet eller filnamnet inte ändras
.
För team som använder en anpassad skrivbordslayout måste administratörer regelbundet uppdatera layoutdefinitionen för att införliva nya funktioner. När administratörer visar en omodifierad layout eller ett team som använder en omodifierad layout visas ett meddelande som anger att nya skrivbordsfunktioner tillämpas automatiskt.
På skrivbordet finns det två typer av widget-iframe-baserade och webbkomponentbaserade. Rubrik, navigering (anpassad sida), beständigt område, huvudlöst område och aux-panelen är det anpassningsbara området på ett skrivbord. Det här är inte widgets.
Följande lista beskriver de utrymmen som du kan konfigurera. Bilderna illustrerar layouten på skrivbordet:
-
Rubrik och logotypområde: Det här utrymmet visar Webex Contact Center-logotypen och namnet (standard) längst upp till vänster på skärmen.
-
Horisontellt rubri kområde: Det här utrymmet har ett konfigurerbart område som är fyllt med anpassade widgetar. Dessa widgets kan till exempel visa inbyggd information och rullgardinsmenyer. Eftersom höjden på denna rubrik bara är 64 pixlar kan widgethöjden inte korsa rubrikhöjden.
-
Arbetsyta: Det här utrymmet ändras enligt valet i navigeringsfältet eller när en agent interagerar med kunder. När en agent är på ett samtal visas fönstret för interaktionskontroll och hjälpinformation (som inkluderar anpassade widgetar och ihållande widgetar) i det här området. När en agent interagerar med e-post, chatt eller sociala kanaler visar det här området arbetsytan och hjälpinformationsfönstret (som inkluderar det beständiga widgetområdet).
Anpassad sida visas på skrivbordsgränssnittet i arbetsytan. Du kan komma åt den anpassade sidan genom ikoner i navigeringsfältet. Varje anpassad sida kan innehålla en eller flera anpassade widgetar.
Anpassad widget är ett tredjepartsprogram som är konfigurerat i JSON-layouten. Du kan placera den anpassade widgeten på den anpassade sidan, den anpassade fliken (rutan Hjälpinformation) eller på skrivbordets horisontella rubrik.
-
Navigeringsfältet: Använd det här utrymmet för att lägga till navigeringsobjekt för att komma åt anpassade sidor.


Egenskaper för JSON-layout på toppnivå
Roller
Standard JSON-layouten har följande tre roller.
-
Agent—för att ställa in skrivbordslayouten som ska visas när en agent loggar in på Webex Contact Center Desktop för att hantera agentaktiviteter.
-
Supervisor — för att ställa in skrivbordslayouten som ska visas när en handledare loggar in på Webex Contact Center Desktop för att endast hantera övervakarfunktioner.
När en handledare loggar in på skrivbordet tillämpas skrivbordslayouten som anges för det primära teamet. Om du inte anger ett primärt team gäller den globala layouten. Som standard är APS-rapporter inaktiverade.
-
SupervisorAgent—för att ställa in skrivbordslayouten som ska visas när en handledare loggar in på Webex Contact Center Desktop för att hantera både handledarfunktioner och agentaktiviteter.
Du kan antingen lägga till eller ändra widgetar för varje roll i motsvarande persona i relevant JSON-layoutfil.
Följande är de översta nivåegenskaperna för JSON-layout baserat 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": {
...
}
},
}
},
- Ändringarna i JSON-layoutegenskaperna träder i kraft när skrivbordswebbläsaren uppdateras.
- Om en funktion som du har aktiverat i JSON-layouten inte är tillgänglig på skrivbordet kontaktar du Ciscos support för att aktivera funktionen.
- Alla egenskaper i JSON-layouten är skiftlägeskänsliga.
AppTitel
Så här anger du en titel på skrivbordets horisontella rubrik. Standardtiteln är Webex Contact Center.
Exempel:
"appTitle": "Webex Contact Center"
Standardinställningen AppTitle ändras från Contact Center Desktop till Webex Contact Center. Det påverkar inte befintliga anpassade layouter som använder den gamla standardinställningen AppTitle (Contact Center Desktop). Om du vill använda den nya AppTitle måste du ändra den anpassade layouten. Den nya globala layouten använder dock standard AppTitle som Webex Contact Center.
Titeln kan antingen vara text, en bild eller en tom sträng. Titeltexten visas i två rader. Om texten sträcker sig bortom den andra raden visas en ellipsikon och verktygstipset visar hela titeln. Stilar kan inte tillämpas på titeln.
Du kan antingen använda data-URI (Uniform Resource Identifier) eller vara värd för en anpassad titelbild på ett CDN (Content Delivery Network), Amazon Web Services (AWS) Simple Storage Service (S3) bucket eller en liknande värdtjänst och sedan ange webbadressen till den värdbaserade bilden. De titelbildformat som stöds är PNG, JPG, JPEG, GIF, SVG och WebP. Den stödda titelbildstorleken är 184 x 32 pixlar (bredd x höjd).
logotyp
För att ange en URL för företagets logotyp. Om du inte anger en URL visas Webex Contact Center-logotypen som standard.
Exempel:
"logo": "https://my-cdn.com/logo.png"
Du kan vara värd för en anpassad logotypbild på en CDN, Amazon Web Services (AWS) Simple Storage Service (S3) -hink eller en liknande värdtjänst och sedan ange webbadressen till den värdbaserade bilden. De logotypbildformat som stöds är PNG, JPG, JPEG, GIF, SVG och WebP. Den logotypbildstorlek som stöds är 96 x 32 pixlar (bredd x höjd).
| Skick | Exempel | AppTitel | logotyp |
|---|---|---|---|
| Om AppTitle och logotyp inte är konfigurerade |
|
Ingen titel | Standardlogotyp |
| Om AppTitle och logotyp är konfigurerade |
|
Konfigurerad text | Konfigurerad logotyp |
| Om AppTitle är konfigurerad och logotypen inte är konfigurerad |
|
Konfigurerad text | Standardlogotyp |
|
Om AppTitle inte är konfigurerad och logotypen är konfigurerad
|
|
Ingen titel | Konfigurerad logotyp |
| Om AppTitle är konfigurerad och logotyp inte föredras |
|
Konfigurerad text | Ingen logotyp |
|
Om AppTitle inte är konfigurerad och logotypen inte är att föredra
|
|
Ingen titel | Ingen logotyp |
| Om AppTitle läggs till som en bild och logotyp är konfigurerad |
|
Konfigurerad bild | Konfigurerad logotyp |
|
Om AppTitle läggs till som en bild och logotypen inte är konfigurerad
|
|
Konfigurerad bild | Standardlogotyp |
|
Om AppTitle läggs till som en bild och logotyp inte är att föredra
|
|
Konfigurerad bild | Ingen logotyp |
- Den anpassade bildstorleken justeras baserat på bildförhållandet. Den anpassade titel texten som konfigurerats tidigare kan nu visas i två rader på skrivbordet. För att undvika detta kan du ändra den anpassade titeltexten.
- Om titel och logotyp inte är konfigurerade i skrivbordets horisontella rubrik används det utrymmet av rubrikwidgetarna. Rubrikwidgetarna måste konfigureras korrekt för att använda titel- och logotyputrymmet.
- Titeln och logotypen tillsammans får inte överstiga den maximala bredden på 304 pixlar (inklusive stoppning). Om logotypens bredd är mindre än 96 pixlar kan den återstående bredden användas för titeln.
- Om den anpassade bildstorleken är högre än den storlek som stöds justeras bildstorleken baserat på bildförhållandet i den horisontella rubriken. Om den anpassade bild storleken är mindre än den storlek som stöds behålls den faktiska bildstorleken i den horisontella rubriken.
UppgiftsidaIllustration
Ange en anpassad illustration för aktivitetssidan baserat på organisationsinställningar och varumärkesanpassning. När en agent loggar in visas den konfigurerade illustrationen som bakgrund på aktivitetssidan. Som standard visas uppgiftssidan utan illustration.
Exempel:
"taskPageIllustration": "https://www.abc.com/image/logo.jpg",
Du kan antingen använda data-URI:er eller vara värd för en anpassad illustration i ett CDN (Content Delivery Network), Amazon Web Services (AWS) Simple Storage Service (S3) bucket eller en liknande värdtjänst och sedan ange webbadressen till den värdbaserade illustrationen. Illustrationen kan konfigureras på global nivå eller gruppnivå baserat på layoutdefinitionen. Se till att du konfigurerar rätt URL för att förhindra att den trasiga bilden visas på skrivbordet.
De illustrationsformaten för uppgiftssidor som stöds är PNG, JPG, JPEG, GIF, SVG och WebP. Rekommenderad illustrationsstorlek är 400 x 400 pixlar (bredd x höjd). Om den anpassade illustrationsstorleken är större än den rekommenderade storleken justeras illustrationens storlek baserat på bildförhållandet på aktivitetssidan. Om den anpassade illustrationsstorleken är mindre än den rekommenderade storleken behålls den faktiska illustrationsstorleken på aktivitetssidan.


StopNavigateOnAcceptTask
För att avgöra om fokus ska flyttas till en nyligen godkänd uppgift när agenten accepterar den nya aktiviteten medan han arbetar med en tidigare uppgift. Standardvärdet är false.
Exempel:
"stopNavigateOnAcceptTask": false
Om värdet är inställ t som true, när användaren accepterar en ny uppgift på skrivbordet, behålls fokus på föregående aktivitet och flyttas inte till den nyligen accepterade aktiviteten. Den här inställningen förhindrar att användaren förlorar data när den accepterar en ny begäran.
Tänk till exempel på att Agent 1 är i chatt med kund 1 och samtidigt i ett röstsamtal med Kund 2. Under röstsamtalet uppdaterar Agent 1 informationen om Kund 2 i fönstret Interaktionskontroll. För närvarande har Agent 1 två aktiva aktiviteter i fönstret Aktivitetslista, och fokus ligger på fönstret Interaktionskontroll. När Agent 1 accepterar en ny chattförfrågan från kund 3 förblir fokus på fönstret Interaktionskontroll med kund 2 och flyttas inte till den nyligen accepterade chattförfrågan.
Om du vill behålla fokus på föregående aktivitet och inte flytta till den nyligen accepterade aktiviteten väljer du den anpassade layouten med egenskapsvärdet stopNavigateOnAcceptTask inställt på true.
Om egenskapsvärdet stopNavigateOnAcceptTask inte anges i JSON-layouten flyttar skrivbordet fokus till den nyligen accepterade aktiviteten. Beteendet liknar när egenskapsvärdet stopNavigateOnAcceptTask är inställt på false.
- Inställningen gäller alla uppgifter (röstkanaler och digitala kanaler) som utförs på skriv bordet — till exempel att acceptera en uppgift, konferens, konsultation eller överföring, och för utgående samtal, utgående kampanjsamtal, automatisk avslutning osv.
- Inställningen gäller inte om skrivbordsanvändaren är på startsidan, utan någon aktiv aktivitet i fönstret Aktivitetslista. I ett sådant fall, när en ny uppgift accepteras, flyttas fokus från start sidan till den nyligen accepterade aktiviteten.
DragDropEnabled
Om du vill aktivera dra och släppa och ändra storlek på widgetarna på de anpassade sidorna ställer du in värdet till true. Standardvärdet är false.
Exempel:
"dragDropEnabled": false
Mer information om hur du aktiverar dra-och-släpp-funktionen för flikarna i rutan Hjälpinformation finns i Hjälp informations fönstret.
NotificationTimer
För att ställa in varaktigheten (i sekunder) efter vilken skrivbordsmeddelandena på skrivbordet automatiskt avvisas. Meddelandet visas längst upp till höger på skrivbordet. Standardvärdet för timeout är 8 sekunder. Det giltiga intervallet för timeout-värden är 1-10 sekunder. För att timeout-ändringarna ska träda i kraft måste webbläsaren uppdateras efter att ändringarna har gjorts.
Exempel:
"notificationTimer": 8
MaximumNotificationCount
För att ställa in antalet skrivbordsmeddelanden som ska visas samtidigt på skrivbordet. Standardvärdet är 3. Räckvidden för skrivbordsmeddelanden är 1-10. Skrivbordsmeddelandena staplas. Om det finns många aviseringar visas de med en liten fördröjning beroende på NotificationTimer-inställningarna.
Exempel:
"maximumNotificationCount": 3
WebbläsarNotificationTimer
För att ställa in varaktigheten (i sekunder) efter vilken webbläsarens brödrostmeddelanden på skrivbordet automatiskt avvisas. Brödrost är ett inbyggt webbläsarmeddelande som bara visas om skrivbordet inte är det aktiva webbläsarfönstret eller fliken. Webbläsarfönstret eller fliken Skrivbord är inaktiv när
-
Du arbetar med andra webbläsarfönster eller flikar.
-
Du arbetar med andra applikationer.
-
Du har minimerat skrivbordswebbläsarfönstret.
Meddelandet visas längst upp till höger på skrivbordet. Standardvärdet för timeout är 8 sekunder. Det rekommenderade intervallet för timeout-värden är 5-15 sekunder. För att timeout-ändringarna ska träda i kraft måste webbläsaren uppdateras efter att ändringarna har gjorts.
Exempel:
"browserNotificationTimer": 8
Den konfigurerade tidsgränsen för webbläsaraviseringar beror på operativsystem och webbläsarinställningar. Timeout-värdet respekteras i Chrome-webbläsaren i Windows OS, Chrome OS och macOS. De andra webbläsare som stöds respekterar dock inte det konfigurerade tidsgränsvärdet för aviseringar konsekvent.
wxmKonfigurerad
(Valfritt) Ställ in värdet till
true för att konfigureraWebex Experience Management. Standardvärdet är false.
Exempel:
"wxmConfigured": true
Skrivbordschattapp
Så här konfigurerar du flera chattprogram som erbjuds av Cisco, t.ex. Webex App.
WebExKonfigurerad
Webex-appen tillsammans med dess meddelande-och mötesfunktioner kan konfigureras på skrivbordet. Den här konfigurationen gör det möjligt för agenter att samarbeta med andra agenter, handledare och ämnesexperter (SMF) i sin organisation utan att navigera bort från skrivbordet.
- Webbplatsadministratören hanterar Webex Meeting-användare och tilldelar behö righeter endast om användarna har Webex Enterprise Edition. Mer information finns i Hantera Webex Meetings användare i Cisco Webex Control Hub.
- Handledare och små och medelstora företag måste ladda ner Webex-klienten på sitt system (personlig enhet) eller komma åt Webex-appen med Webex App for Web (https://web.webex.com/). Mer information finns i Ladda ner appen.
- Du kan komma åt Webex-appen inom Agent Desktop för att samarbeta med andra agenter, handledare och ämnesexperter (små och medelstora företag) i din organisation utan att navigera bort från. Agent Desktop Funktionen för samtalskontroll är inte tillgänglig. För att ta emot och ringa samtal behöver du den externa, icke-inbäddade Webex-appen. Mer information finns i R inga appar.
Så här konfigurerar du Webex-appen på skrivbordet:
-
När du lägger till tjänster för en användare markerar du kryssrutan Avancerade meddelanden (Användare ). Cisco Webex Control Hub Mer information finns i Hantera användarkonton i Cisco Webex webbplatsadministration.
-
Ange egenskapsvärdetWebExConfigured till true i den anpassade skrivbordslayouten.Exempel:
"desktopChatApp": { "webexConfigured": true },Standardvärdet för egenskapenWebExConfigured ärfalse.Webex-appen är endast tillgänglig för rollerna agent, övervakare och SupervisorAgent om du ställer in egenskapsvärdet Web
ExConfiguredtilltrueför var och en av dessa roller. Agenten, övervakaren eller SupervisorAgent kan inte logga ut från Webex-appen.Om du vill visa ikonen
(Webex) på skrivbordets horisontella rubrik anger du värdet webexi egenskapenheaderActions. Mer information finns i HeaderAc tions.Om du vill aktivera Webex-appen för ett visst team väljer du den anpassade layouten med egenskapsvärdetMer information finns i Skapa ett team.WebExConfigured inställt på true.
Du kan konfigurera Webex-appen i rutan Hjälpinformation, anpassad sida och anpassad widget också. Mer information finns i Hjäl pinformationsfönstret.
Meddelande om Webex-app
Värdena som anges med egenskaperna NotificationTim er och BrowserNotificationTimer för meddelandetimern gäller för Webex-appen. Standardvärdet för timeout är 8 sekunder för dessa egenskaper. Mer information finns i NotificationTimer och BrowserNotificationTimer.
RubrikÅtgärder
För att ändra ordningen på ikonerna på skrivbordets horisontella rubrik. Standardordningen är som följer:
-
(Webex) -
(Outdial-samtal) -
(Meddelandecenter)
Ange värdet på egenskapen headerActions enligt följande:
|
Ikonnamn |
HeaderActions Egenskapsvärde |
|---|---|
|
Webex-appen |
webex |
|
Outdial-samtal |
utomhus |
|
Meddelandecenter |
underrättelse |
Exempel:
”HeaderActions”: ["webex”, ”outdial”, ”meddelande"],
Egenskapsvär det HeaderActions är skiftlägeskänsligt.
Om du vill ändra ikonernas standardordning anger du egenskapen headerActions och värdena i den anpassade layouten därefter.
Exempel:
”HeaderActions”: ["meddelande”, ”outdial”, ”webex"],
- Om du inte anger egenskapen och värdena
headerActions i den anpassade layouten visas ikonerna i standardordningen. - Om du vill ta bort rubriksikonerna och tillhörande funktioner från skrivbordet anger du ett tomt värde för egenskapen
headerActions(”headerActions”:[]). Men om du har lagt till Webex-appen i rutan Hjälpinformation eller en anpassad sida, eller som en anpassad widget, kan agenten fortfarande komma åt Webex-appen även om Webex-appen inte är tillgänglig i skrivbordets horisontella rubrik. Om egenskapsvärdetMer information finns i Web ExConfigured.WebExConfigured är inställt somfalsevisas inte Webex App- ikonen i skrivbordets horisontella rubrik, även omwebex-värdet läggs till i egenskapen headerActions.
område
Egenskapen area är kärnan i skrivbordslayouten. Du kan definiera layouten enligt området.
"area": {
"header": {
...
},
"advancedHeader: {
{
"comp": "widget-1",
"attributes": { ... },
"script": ....
}
},
"panel": {
...
},
"navigation": {
...
},
"persistent": {
...
},
"headless": {
...
}
},
Du kan konfigurera följande område objekt:
-
Panel: Representerar den andra panelen eller panelen längst till höger i rutan Hjälpinformation.
-
Navigering: Representerar anpassade sidor och deras navigeringselement som är relaterade till sidorna.
-
Beständig: Representerar widgetar på sidnivå som är beständiga och visas på alla sidor på skrivbordet.
-
Huvudlös: Representerar widgetarna som inte har ett visuellt gränssnitt, men kör logik i bakgrunden.
Om egenskapen AdvancedHeader är konfigurerad måste egenskaperna header och headerActions tas bort.
AdvancedHeader
För att anpassa synligheten och ändra ordningen på ikonerna på skrivbordets horisontella rubrik. Standardordningen är som följer:
-
(Webex) -
(Outdial-samtal) -
(Meddelandecenter) -
(Agenttillståndsväljare)
Ange värdet för egenskapen advancedHeader enligt följande:
|
Ikonnamn |
HeaderActions Egenskapsvärde |
|---|---|
|
Webex-appen |
agentx-webex |
|
Outdial-samtal |
agentx-outdial |
|
Meddelandecenter |
agentx-anmälan |
|
Agenttillståndsväljare |
agentx-tillståndsväljare |
Exempel:
"advancedHeader": [
{
"comp": "agentx-webex"
},
{
"comp": "agentx-outdial"
},
{
"comp": "agentx-notification"
},
{
"comp": "agentx-state-selector"
}
{
"comp": "widget-1",
"attributes": { ... },
"script": ....
}
]
Egen skapsvärdet AdvancedHeader är skif tlägeskänsligt.
Om du vill ändra ikonernas standardordning anger du egenskapen advancedHeader och värdena i den anpassade layouten därefter.
Widgetarna flyter in i rullgardinsmenyn från vänster till höger.
-
Om du inte anger egenskapen
AdvancedHeaderi den anpassade layouten visas standardrubriken. -
När avancerad rubrik är aktiverad bör du flytta widgetarna från den befintliga rubriken till den avancerade rubriken enligt exemplet.
-
När avancerad rubrik är aktiverad visas inte gammal rubrik.
-
Varje widgetikon har en standardfyllning och marginal som definieras genom CSS och kan inte anpassas via skrivbordet.
-
Placeringen av logotypen, titeln och profilikonerna är fasta och kan inte anpassas.
-
Om du vill ta bort rubriksikonerna och tillhörande funktioner från skrivbordet anger du ett tomt värde för den tillhörande komponenten i egenskapen
advancedHeader (”: []).”AdvancedHeaderOm du har lagt till Webex-appen i rutan Hjälpinformation eller en anpassad sida, eller som en anpassad widget, kan agenten fortfarande komma åt Webex-appen även om Webex-appen inte är tillgänglig i skrivbordets horisontella rubrik.
-
Om du lägger till en widget med en lång etikett visas ett trunkerat etikettnamn enligt det tillgängliga utrymmet.
Du kan använda attributet
TextContentför att lägga till en etikett i en widget.Exempel:
{ "comp": "timer-widget", "attributes": { "duration": "08:00:00" }, "textContent": "Count Down Timer for Current Shift", "script": "https://wxcc-demo.s3.amazonaws.com/widgets/timer-widget.js" }Etiketten ”Count Down Timer for Current Shift” kommer att trunkeras och visas i enlighet med tillgängligt utrymme.
-
Undvik att lägga till widgets med en lång etikett.
-
När en widget flyter till rullgardinsmenyn är det bara widgetikonen som är klickbar.
-
-
Om egenskapsvärdetMer information finns i Web ExConfigured.WebExConfigured är inställt somfalsevisas inte Webex App- ikonen i skrivbordets horisontella rubrik, även omwebex-värdet läggs till i egenskapen AdvancedHeader.
Hemsida
När du loggar in på skrivbordet landar du på startsidan.
Hemsidan är endast tillämplig på handledare och SupervisorAgent-persona.
Du kan visa följande widgetar på startsidan. Analyserwidgetar tillhandahålls som standard, men administratören kan också konfigurera Persistent och Custom widgets. Mer information finns i Egenskaper för JSON-layout på toppnivå.
Analyser-widgetar
Som standard visas Analyzer-widgeten på skrivbordets startsida.
Konfiguration av hemsidans layout
Du kan konfigurera skrivbordets startsida för att visa layout som baseras på organisationens inställningar och varumärkesanpassning. Redigera fältet Hemsida för att konfigurera startsidan. Du kan konfigurera följande komponenter så att de visas på startsidan när en användare loggar in på skrivbordet:
-
Ett välkomstmeddelande
-
Upp giftsi konen i navigeringsfältet för att navigera till Aktivitetsfönstret. Upp giftsi konen visas för rollen Övervakare och Handledare och agent när funktionen samtalsövervakning är aktiverad. Aktivitetsfönstret visar inkommande kundförfrågningar, aktiva och tidigare kundinteraktioner och aktiva övervakningsförfrågningar.
-
Filtrera avsnitt som könamn, kanaltyp och han terade team.
I följande tabell beskrivs de si de genskaper som krävs för att konfigurera startsidan:
|
Fastighet |
Beskrivning och kod |
|---|---|
|
sida > UseFlexLayout |
Flex layout är en ny webbkomponent. Det ändrar inte de befintliga widgetarna. Den nya flexlayouten använder samma layoutkonfigurationsformat på ett förenklat sätt. Det är bakåtkompatibelt och påverkar inte befintliga widgets. Du måste konfigurera JSON-layouten. Ange widgetens höjd och bredd för att konfigurera JSON-layouten. Widgeten återges i samma sekvens som den är konfigurerad i JSON-layouten. Widgets har en standardmarginal på 8 px. JSON-layouten baseras på dimensionerna (bredd x höjd) och koordinater (X, Y och Z) för widgetarna. Den flexibla layouten stöder funktioner som att ändra storlek på enskilda widgetar, maximera widgetar och så vidare. Höjden på enskilda widgetar mäts i pixlar. 1 höjdenhet = 40 pixlar. Widgetens bredd beror på antalet kolumner i behållaren och antalet kolumner som ändras baserat på behållarens bredd. Widgets visas från vänster till höger. Den avancerade layoutmotorn använder anpassad logik för att tillämpa både horisontell och vertikal rymdjustering av widgets. Ursprungligen laddas layouten horisontellt. Efter att ha laddat horisontellt laddas widgeten vertikalt och säkerställer att utrymmesutnyttjandet är optimalt. Konfigurera widgetarna baserat på skärmstorleken. Du kan antingen öka eller minska widgetarnas bredd, baserat på skärmstorleken. Detta gör widgetarna mer läsbara och användbara. Flexibel layout ger standardbrytpunkter som stora, medelstora, små och extra små.
Dessa pixlar kan variera beroende på operativsystem och broswer.
|
|
sida > comp |
Se till att du tillhandahåller en unik anpassad komponent.
Kompon |
|
sida > PageHeader |
Se till att ange en titelsträng som kan vara statisk, dynamisk eller båda. Kompon
|
|
sida > PageSubHeader |
Se till att lägga till underrubrik som visas på skrivbordet. Användaren kan lägga till Gå till analysator i underrubriken.
|
Navigering (anpassade sidor)
I det här avsnittet kan du lägga till sidor som visas i det vänstra navigeringsfältet. Du anger en navigeringsikon och en unik URL för widgeten som ska visas i navigeringsfältet. Vi rekommenderar att du använder ett specifikt prefix för webbadressen för att undvika konflikter. För mer information, se avsnittet navi geringsegen skaper.
Du kan också ha en samling widgets som kan visas på den här sidan. Sidan kan ha en enda widget som visas på skärmen eller en samling widgetar i ett rutnät. Mer information om rutnätsarrangemang finns i avsnittet layoutegen skaper.
Du behöver inte lägga till ett dynamiskt områdesomslag i widgetträdet. Det betyder att du kan dra och släppa och ändra storlek på widgetar på anpassade sidor när du aktiverar det här alternativet.
Exempel:
{
"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öljande tabell beskriver nav - och sidegenskaper tillsammans med deras underordnade egenskaper:
|
Fastighet |
Beskrivning och kod |
|---|---|
|
nav > etikett |
Den här egenskapen anger sidnavigeringsidentifieraren. Skärmläsaren läser den här egenskapen och den visas i verktygstipset. Dessa parametrar är nödvändiga för att visa din anpassade sida i navigeringsfältet.
Etik |
|
nav > Ikontyp |
Den här egenskapen representerar den typ av ikon som visas i navigeringsfältet för den anpassade sidan. Följande typer av ikoner är tillgängliga:
|
|
nav > ikon |
Den här egenskapen representerar namnet på ikonen i Momentum-biblioteket eller CDN-webbadressen.
|
|
nav > justera |
Den här egenskapen hjälper dig att justera ikonen längst upp eller ned i navigeringsfältet. För närvarande tillåter egenskapen endast toppjustering. |
|
nav > is DefaultLandingPage | Den här egenskapen anger standardmålsidan för agenterna iAgent Desktop. Ställ in den här egenskap en till true om du vill göra navigeringsfältet till standardmålsidan som visas för agenterna efter inloggning påAgent Desktop. Om mer än en sida i navigeringsfältet har den här egenskapen inställd på true, anser systemet att den första sidan i navigeringsfältet är standardmålsidan. Om ingen sida i navigeringsfältet har den här egenskap en inställd på true fungerar startsidan som standardmålsida. Du kan inte ange rapporterna Analyzer och Agent Performance Statistics som standardmålsida. |
|
nav > Navigera till |
Den här egenskapen anger namnet på den anpassade sidan. Namnet visas i adressfältet när agenten navigerar. NavigateTo får inte innehålla följande värden: bilder, teckensnitt, css, build_info, help, app, i18n, ikoner, images-mfe-wc och ljud.
|
|
Fastighet |
Beskrivning och kod |
|---|---|
|
sida > id |
I Egen
|
|
sida > UseFlexLayout |
Flex layout är en ny webbkomponent. Det ändrar inte de befintliga widgetarna. Den nya flexlayouten använder samma layoutkonfigurationsformat på ett förenklat sätt. Det är bakåtkompatibelt och påverkar inte befintliga widgets. Du måste konfigurera JSON-layouten. Ange widgetens höjd och bredd för att konfigurera JSON-layouten. Widgeten återges i samma sekvens som den är konfigurerad i JSON-layouten. Widgets har en standardmarginal på 8 px. JSON-layouten baseras på dimensionerna (bredd x höjd) och koordinater (X, Y och Z) för widgetarna. Den flexibla layouten stöder funktioner som att ändra storlek på enskilda widgetar, maximera widgetar och så vidare. Höjden på enskilda widgetar mäts i pixlar. 1 höjdenhet = 40 pixlar. Widgetens bredd beror på antalet kolumner i behållaren och antalet kolumner som ändras baserat på behållarens bredd. Widgets visas från vänster till höger. Den avancerade layoutmotorn använder anpassad logik för att tillämpa både horisontell och vertikal rymdjustering av widgets. Ursprungligen laddas layouten horisontellt. Efter att ha laddat horisontellt laddas widgeten vertikalt och säkerställer att utrymmesutnyttjandet är optimalt. Konfigurera widgetarna baserat på skärmstorleken. Du kan antingen öka eller minska widgetarnas bredd, baserat på skärmstorleken. Detta gör widgetarna mer läsbara och användbara. Flexibel layout ger standardbrytpunkter som stora, medelstora, små och extra små.
Dessa pixlar kan variera beroende på operativsystem och broswer.
|
|
sida > widgets sida > comp |
Hjälper dig att definiera dina anpassade widgets. Om du vill placera flera widgetar anger du widgetalternativ i följd. Se till att du ger varje widget ett unikt områdesnamn. Använd den i layoutavsnittet senare.
Den här egenskapen representerar namnet på det anpassade HTML-elementet (känt som en webbkomponent eller något annat element - om du vill använda det som ett omslag). Mer information finns i Exempel på exempel på användningsfall. Ange ditt anpassade elementnamn här utan vinkelparenteser (”<” or ”>”). Till exempel ”my-customelement.” Varje post under widget-sektionen stöder följande format:
|
|
sida > skript |
(Valfritt) Den här egenskapen krävs endast när du läser in widgeten eller komponenten från en fjärrplats, till exempel ett CDN.
Ändra inte skriptwebbadressen för samma komponent. Om du behöver ändra skriptadressen för samma komponent gör du något av följande:
|
|
sida > egenskaper |
Du kan ange egenskaper som du måste skicka för webbkomponenten.
|
|
sida > responsiv |
Avgör om en webbkomponent eller en iFrame-baserad widget som läggs till i den anpassade layouten på Konfigurera den här egenskapen med något av följande värden:
Widgetar som inte svarar kan inte garantera bästa användarupplevelse och visas inte i den mindre vyn. Agenten måste öka storleken på webbläsarfönstret för att visa widgetar som har konfigurerats som inte svarar. |
|
sida > attribut |
Du kan ange attributen för webbkomponenter i det här avsnittet.
|
|
sida > synlighet |
Anger om de widgetar som erbjuds av Cisco som läggs till i den anpassade layouten på Cisco-erbjudna widgets är Kontakthistorik,Cisco Webex Experience Management, IVR-transkript, Preview Campaign Call Guide och Screen Pop.
|
|
sida > barn |
Den här egenskapen är den centrala delen av layouten. I avsnittet under Mer information om hur du skickar STORE-värden som egenskaper finns i Dela data från skrivbord till widgetar.
Fördelen med avsnittet ”Children” array är att du kan använda befintliga webbkomponenter i layoutspecifikationen, som redan ingår i skrivbordspaketet. Några av Web Components för skrivbordspaketet inkluderar:
Mer information om attributen för den beständiga fliken finns i At tribut för beständiga flikar. |
|
sida > TextContent |
Hjälper dig att lägga till ditt textinnehåll.
|
|
sida > stil |
Hjälper dig att tilldela en viss CSS-stil till din komponent.
|
|
sida > omslag |
Widget wrapper låter dig lägga till ett verktygsfält ovanpå din widget. Verktygsfältet kan innehålla en titel och ikonen Se till att du använder standardvärdet som ”app-maximize-area”. För närvarande är endast standardvärdet tillgängligt.
|
|
sida > omslags > id |
(Valfritt) Med widgetomslaget för webbkomponenter kan du uppdatera den dynamiska widgettiteln med hjälp av en unik identifierare. Ange egenskapsvärdet för widgetomslags-
Se till att du använder samma unika identifierare för JavaScript CustomEvent. Mer information finns i avsnittet Asynkrona händelser i kapit let Agentkontaktmodul i Cisco Webex Contact Centerskrivbords utvecklaren. Om du vill uppdatera den iFrame-baserade widgettiteln använder du iFrame-innehållet från samma domän. Följande är ett exempel:
|
|
sida > agentx-wc-iframe |
Låter dig bädda in en webbsida i en iFrame som visas som en widget på skrivbordet. Du kan använda iFrame-widgeten som heter ”agentx-wc-iframe”.
|
|
sida > layout | Låter dig ordna widgetarna på en sida. Följande format representerar en rutnätslayout: Här kan du definiera rutnätet med de områdesnamn som du definierade i widget avsnittet. Följande exempel visar hur layouten för tre rader och tre kolumner anges: ![]() I storleksavsnittet representerar siffror den bråkdel av utrymme som en widget kan uppta, i förhållande till de andra widgetarna. Alla tre kolumnerna upptar lika 1 bråkdel av utrymmet. Med 100% som tillgänglig bredd upptar varje widget 33,33% av det horisontella utrymmet. ![]() Ett annat exempel på användningsfall, om du ställer in som ”cols”: [1, 2, 2], betyder det att det totala utrymmet divideras med 5 (1+2+2) och den första widgeten upptar 20% av det horisontella utrymmet. Den andra och tredje widgeten tar 40% vardera. Mer information finns i Grundläggande begrepp för stödrasterlayout. ![]() |
|
sida > ROOT |
Kapsling av layouter kallas en underlayout. Om du har kapslade layouter i layoutkonfigurationen måste du ha ett enda ”ROOT” -objekt som överordnat för underlayouter. Annars kan layoutkonfigurationen vara platt om ingen kapsling krävs. Den här underlayouten ger mer kontroll över layoutstorleksändringen. Egenskapen sidlayout måste vara av typen Record<string, Layout>. Med layoutegenskapen kan du ordna widgetarna på en sida.
Den här inställningen skapar ett rutnät i ROOT-layouten med två understödraster som du kan ändra storlek oberoende av varandra. ![]() Att ändra storlek på en komponent påverkar komponenterna i det underlayouten. ![]() Var medveten om följande fall: Oändlig slinga: Om du inkluderar ROOT-layout som ett underlayout av ROOT orsakar det ett ”call stack” -fel och körs in i en oändlig slinga.
![]() Samma underlayouttider (N): Om du inkluderar underlayouten i rutnätet mer än en gång med samma namn, och om du ändrar storlek på en av dem, ändras storleken på alla underlayouter automatiskt. Om detta inte är önskat beteende byter du namn på varje underlager med ett unikt namn.
![]() |
Attribut för beständiga flikar
Om du vill ange flikarna på anpassade sidor och anpassade widgetar som beständiga anger du attributen för md-tabs i den anpassade layouten.
Exempel: Ställ in flikar som beständiga
{
"comp": "md-tabs",
"attributes": {
"persist-selection": true,
"tabs-id": "unique-id for all the tabs together in the container"
},
}
|
Fastighet |
Beskrivning |
|---|---|
|
beständigt urval |
För att ställa in |
|
flik-id |
Unik identifiering för alla flikar tillsammans i behållaren. |
När du anger att md-tabs ska vara beständiga (persist-select: true), Agent Desktop behåller flikvalet även om en agent växlar mellan sidor eller widgetar på skrivbordet.
- Egenskapen
beständigt urvalär inte tillämplig på flikarna i rutan Hjälpinformation och sidan Rapportstatistik för agentprestanda, eftersom beteendet för beständiga flikar redan är inställt på skrivbordet . - Flikvalet återställs till standardfliken när du loggar ut från skrivbordet, laddar om/uppdaterar webbläsaren eller rensar webbläsarens cache.
Konfiguration av beständiga widgetar
Du kan konfigurera vilken anpassad widget som helst så att den är beständig. Beständiga widgets visas på alla sidor på skrivbordet. Beständiga widgetar visas som en ny flik i rutan Hjälpinformation endast när du har en aktiv kontaktförfrågan eller konversation. Till exempel, Exempel på beständig widget.
Beständiga widgetar visas inte på startsidan på samma sätt som de visas på de andra sidorna. Men om du har en aktiv interaktion visas de beständiga widgetarna på startsidan som en del av fönstret Hjälpinformation. När du till exempel har besvarat ett samtal visas fönstret Interaktionskontroll och widgeten Sam ple Persist ent visas som en del av fönstret Hjälpinformation.
Exempel:
"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 anpassar en widget kan du välja något av alternativen:
-
Värd ett program på en webbsida som kan bäddas in i en iframe.
-
Bygg en anpassad widget.
De tekniska widgetkraven beskrivs i Utvecklings dokumentationen för skrivbordswidget. Som layoutredigerare, se till att du har dessa uppgifter:
-
Vad heter det anpassade HTML-elementet (känt som webbkomponent)?
-
Vilken är webbadressen till CDN-källan (Content Delivery Network) som är värd för JavaScript-paketet?
Rubrik Widgets
Rubriken används för att visa inbyggd information, för att lägga till rullgardinsmenyer och så vidare. Eftersom rubrikbehållaren har begränsat vertikalt utrymme är den totala rubrikhöjden bara 64 pixlar. Mer information om layoutjusteringen finns i avsnittet layoutegen skaper.
Exempel:
"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] }
}
}
Om du vill lägga till ett verktygstips för en rubrikwidget omsluter du komponenten med m d-tooltip. Ange verktygstipsinformation i meddelandeegenskapen.
Exempel:
"header": {
"id": "dw-header",
"widgets": {
"head1": {
"comp": "md-tooltip",
"attributes": {
"message": "Netlify"
},
"children": [{
"comp": "agentx-wc-iframe",
"attributes": {
"src": "https://keen-jackson-8d352f.netlify.app"
}
}]
},
},
}
Du måste lägga till formatattributen visning och höjd för att konfigurera widgetar via iFrame i det anpassningsbara widgetområdet i rubriken. Det bästa passningsvärdet för attribut et height är 64 pixlar.
Se till att du lägger till stilattributen i de befintliga rubrikwidgetarna så att de kan läsas in som förväntat i iFrame.
Exempel:
"head1": {
"comp": "agentx-wc-iframe",
"attributes": {
"src": "https://widget-kad.s3.amazonaws.com/Headers/Timer/Timer.htm",
"style": "height:64px;display:flex;"
}
},
Vi rekommenderar att du bara använder en enda rad med flera kolumner för rubriken eftersom rubrikhöjden bara är 64 pixlar. Mer information om justeringen finns i avsnittet layoutegen skaper.
Hjälpinformationsfönster
Rutan Hjälpinformation på skrivbordet visar flikarna som inkluderar Cisco-erbjudna widgetar (standard) och anpassade widgetar. Följande widgetar som erbjuds av Cisco visas på de fördefinierade flikarna:
-
Kontakthistorik
-
IVR-transkript
-
Resan för kundupplevelse
-
Skärmpop
Du kan använda rutan Hjälpinformation för att:
-
Lägg till flikar
-
Ändra flikordningen
-
Ta bort fördefinierade flikar
-
Markera de anpassade flikarna som dragbara
-
Lägga till verktygstips i de anpassade flikarna
-
Lägg till alternativet Återställ flikordning
Exempel:
"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 konfigurera widgeten Customer Experience Journey när du har aktiverat mätvärden för hantering av kundupplevelse påManagement Portal.
Lägg till nya flikar för att placera dina anpassade widgetar i rutan Hjälpinformation. Inga särskilda regler gäller här och komponenthäckningen är som förväntat och beskrivs i avsnittet barn. Mer information finns i egenskap en Barn på sidan.
Följande är de specifika exemplen för att anpassa dina flikrubriker:
Exempel på att placera ikoner och etiketter i egenskapen Children
{
"comp": "md-tab",
"attributes": {
"slot": "tab",
"class": "widget-pane-tab"
},
"children": [{
"comp": "md-icon",
"attributes": {
"name": "transcript_16"
}
},
{
"comp": "span",
"textContent": “My Widget Tab”
}
],
},
Exempel på att placera bild (med CSS) och etiketter i egenskapen 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”
}
]
}],
},
Nedrullgardinsmenyn Fler flikar visas automatiskt när fönstret Hjälpinformation innehåller flera flikar.
Du måste lägga till ett anpassat flikverktygstips för läsbarhet och tillgänglighet. Om du vill lägga till ett verktygstips för en anpassad flik omsluter du komponenten med m d-tooltip. Ange verktygstipsinformationen i meddel andeegenskapen och använd format egenskapsvärdena som visas i följande exempel.
"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;"
},
För en anpassad flik rekommenderar vi en maximal bredd på 252 pixlar och en minsta bredd på 110 pixlar.
Om du vill aktivera dra-och-släpp-funktionen på den anpassade fliken lägger du till följande egenskap i attributen:
"comp": "md-tabs",
"attributes": {
"class": "widget-tabs",
"draggable": true,
"comp-unique-id": "sample-dynamic-custom-tabs"
},
-
dragbar: Ställin värdet fördragbar egenskap till true. -
comp-unique id: Ange ett unikt värde för att identifiera komponenten.Exempel:
"comp-unique-id": "sample-dynamic-custom-tabs"
Om du aktiverar dra och släpp för en anpassad flik kan agenten dra och släppa fliken till önskad plats i rutan Hjälpinformation. Om du vill återställa flikarna till standardtabbordningen lägger du till följande egenskap:
"comp": "agentx-wc-more-actions-widget",
"attributes": {
"slot": "settings",
"class": "widget-pane",
"tabs-unique-id": "sample-dynamic-custom-tabs"
},
-
agentx-wc-more-actions-widget: Ange komponenten som visas som ikonen Fler åtgärder ()
i rutan Hjälpinformation. -
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 återställa flikarna i rutan Hjälpinformation till standardordningen genom att klicka på
> Återställ flikordning. -
tabs-unique id: Ange samma unika värde som definierats för egenskapencomp-unique id för att kartlägga och återställa md-tabs-komponenterna.
Följande exempelkod använder funktionerna Fler åtgärder och Återställ flikordning.
"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"
}
]
}],
}
Som standard definieras verktygstips, ellipsikon och tabbordningsåterställning för fördefinierade flikar.
I listrutan Fler åtgärder kan du utöka om du vill lägga till ytterligare anpassade komponenter eller widgetar efter alternativet Återställ flikordning. Följande är en exempeluppsättning med stil egenskapsvärden som kan tillämpas på ytterligare 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;"
},
Dra och släpp-funktionen stöds inte för ytterligare anpassade komponenter eller widgetar som läggs till i listrutan Fler åtgärder.
Huvudlösa widgetar
I huvudlösa avsnittet kan du lägga till widgetar som är dolda och inte visas påAgent Desktop. Dessa widgets används för att köra logik i bakgrunden. Det här avsnittet är användbart för att utlösa händelser som inträffar på skrivbordet och köra widgetspecifik logik. Till exempel öppna en anpassad CRM-skärmpop för ett SMS vid ankomsten.
Exempel:
"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] }
}
}
Dela data från skrivbordet till widgetar
Om du vill ta emot realtidsdata via egenskaper eller attribut i en anpassad widget tilldelar du lämpliga STORE-värden i layoutens JSON-konfiguration.
För att komma åt data via JavaScript SDK-prenumeranter kan du också skicka data genom egenskaper eller attribut. Om din komponent är byggd för att reagera på egenskaps- eller attributändringar får du datauppdateringar i realtid frånAgent Desktop, vilket kallas en dataleverantör.
För närvarande har vi en enda dataleverantör under en nyckelBUTIK. Mer information finns i avsnittet Data Provider — Widgetegenskaper och attribut i Cisco Webex Contact CenterDesktop Developer Guide.
Förhandsgranska kampanjsamtal
Administratören skapar kampanjer, konfigurerar uppringningsläget (förhandsgranskning) och tilldelar kampan jerna till team. Om en agent ingår i ett team som kampanjer tilldelas kan agenten ringa ett utgående förhandsgranskningskampanj. Mer information finns i Konfigurera röstutgående kampanjlägen i Webex Contact Center.
Administratören konfigurerar följande i den anpassade layouten för att aktivera förhandsgranskningskampanj kontakt för en agent.
Kampanjkontakt
Administratören lägger till widgeten Kampanjkontakt i rubrikbehållaren i den anpassade layouten. Kampanjkontakten visar kundens kontaktinformation baserat på de definierade egenskaperna. Mer information om layoutjusteringen finns i layoutegen skaps raden på sidan Property Details tabell.
Exempel:
"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"
}
]
Samtalsguide
Widget en Anropsguide visas i rutan Hjälpinformation på skrivbordet. I samtalsguiden visas frågor och svar på kampanjnivå. Agenten uppmanas att läsa igenom uppsättningen frågor i samtalsguiden och skicka in svaren.
Exempel:
"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öljande referenser
för comp-egenskaper har ändrats.agentxi egenskapsvärdet ersätts medacqueon:agentx-preview-campaign byter namn till acqueon-preview-campaignagentx-call-guide byter namn till acqueon-call-guide
- Du måste vara värd för List- och Campaign Manager (LCM) på ett CDN och sedan ange webbadressen i
skripte genskapen.
Skärmpop
I skrivbordslayouten kan du konfigurera Skärmfönster på något av följande sätt:
-
Som en anpassad sida
-
Som en av widgetarna på den anpassade sidan
-
Som en flik i rutan Hjälpinformation
Skärmfönstret visas på skrivbordet baserat på följande faktorer:
För röstkanalen:
-
Konfigurationen som definieras i skrivbordslayouten
-
Screen Pop-aktiviteten som definieras i flödesdesignern
För de nya digitala kanalerna:
-
Konfigurationen som definieras i skrivbordslayouten
-
Noden Screen Pop som definieras i Connect Flow Builder
Mer information om hur du konfigurerar Screen Pop finns i Skärmfönster.
Konfigurera skärmpop i navigeringsfältet
Du kan konfigurera Screen Pop som en anpassad sida eller som en av widgetarna på en anpassad sida. För att komma åt den anpassade sidan Screen Pop klickar du på ikonen Screen Pop i navigeringsfältet. För att komma åt widgeten Skärmpop på den anpassade sidan klickar du på den anpassade ikonen i navigeringsfältet. Mer information om naviger ing segenskaper finns i Navigering (anpassade sidor).
Exempel: Skärmfönster som en anpassad sida
{
"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"
}
Exempel: Skärmfönster som en widget på den anpassade sidan
"comp1": {
"comp": "agentx-wc-screen-pop",
"properties": {
"screenPopUrl": "$STORE.session.screenpop.screenPopSelector"
}
Om Skärmfönstret inte är konfigurerat i Flow Designer visas den anpassade sidan tom. Mer information om hur du konfigurerar Screen Pop i Flow Designer finns i Skär mfönster.
Konfigurera skärmpop i rutan Hjälpinformation
Du kan konfigurera Skärmfönster så att det visas som en flik i rutan Hjälpinformation.
Som standard visas Skärmfönster som en ny underflik på fliken Skärm fönster i rutan Hjälpinformation om Skärmfönster är konfigurerat att visas som Inside Desktop i Flow Designer.
Lägg till följande attribut i panel avsnittet om du vill inkludera Skärmfönster som en flik i rutan Hjälpinformation. Mer information om panel information finns i Hjäl pinformationsfönstret.
Exempel: Skärmfönster som en flik i rutan Hjälpinformation
{
"comp":"md-tab",
"attributes":{
"slot":"tab",
"class":"widget-pane-tab"
},
"children":[
{ "comp": "md-icon", "attributes": { "name": "pop-out_16" }},
{ "comp": "span", "textContent": "Screen Pop" }],
"visibility": "SCREEN_POP"
},
{
"comp": "md-tab-panel",
"attributes": { "slot": "panel", "class": "widget-pane" },
"children": [{ "comp": "#SCREEN_POP"
}
],
}
Visningsalternativet Screen Pop som definierats i Flow Designer har företräde framför den konfiguration som definierats i skrivbordslayouten.
Anta till exempel att du har konfigurerat följande skärmpop-inställningar:
- Flow Designer — Visa inställningar som I den nya webbläsarfliken
- Skrivbordslayout — som en flik i rutan Hjälpinformation
När händelsen för vilken skärmpop är konfigurerad visas Screen Pop utanför skrivbordet - det vill säga i en ny webbläsarflik.
Exempel på användningsfall
-
Konfigurera och komma åt widgeten Customer Experience Management Metrics från navigeringsfältet
-
Standardfönster för hjälpinformation med kontakthistorik och skärmpop
Konfigurera och komma åt widgeten Customer Experience Management Metrics från navigeringsfältet
Exempel:
{
"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]
}
}
}
},
För att få SpaceID och MetricSID, se dokumentationen. Webex Experience Management
Använda flikar på den anpassade sidan
Exempel:
{
"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älpinformationspanel med kontakthistorik och skärmpop
Exempel:
"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älpinformationspanel med widget för kundupplevelseresa
Exempel:
"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
Följande är de språk som stöds:
Bulgariska, katalanska, kinesiska (Kina), kinesiska (Taiwan), kroatiska, tjeckiska, danska, nederländska, engelska (Storbritannien), engelska (USA), finska, franska, tyska, ungerska, italienska, japanska, koreanska, norska, polska, portugisiska (Brasilien), portugisiska (Portugal), rumänska, ryska, serbiska, slovakiska, slovenska, spanska, svenska och turkiska.
Språket för skrivbordsgränssnittet baseras på språkinställningarna i din webbläsare. Låt oss till exempel överväga att du har valt önskat språk som franska i Firefox-webbläsaren. När du startar skrivbordet i Firefox-webbläsaren visas skrivbordsgränssnittet på Français (franska). Det horisontella sidhuvudet, navigeringsfältet och andra komponenter som läggs till i skrivbordslayouten lokaliseras dock inte baserat på språkinställningarna i din webbläsare.
Lokalisera skrivbordskomponenter
För att lokalisera skrivbordskomponenter,
-
Använd befintliga lokaliseringsnycklar som anges i
app.json-filen. Om lokaliseringsnycklarna inte är inställda används standardspråket engelska (US). Du kan skicka en serviceförfrågan till Cisco Support om du vill lägga till en lokaliseringsnyckel iapp.json-filen.Exempel: Lokaliseringsnyckel
{ "common": { "buttonTitle": "Stop Timer" } } -
Ange följande skiftlägeskänsliga egenskap i JSON-filen Skrivbordslayout för att lokalisera en komponent:
"textContent": "$I18N.<key>",där <key>hänvisar till motsvarande lokaliseringsnyckel i
app.json-filen.
Exempel: Lokalisera huvudkomponent
"header": {
"id": "header",
"widgets": {
"head1": {
"comp": "md-button",
"attributes": {
"slot": "menu-trigger",
"style": "height: 64px"
},
"children": [{
"comp": "span",
"textContent": "$I18N.common.buttonTitle",
}
},
},
}
Exempel: Lokalisera flikkomponent i fönstret Hjälpinformation
"panel": {
"comp": "md-tab",
"attributes": {
"slot": "tab"
},
"children": [{
"comp": "span",
"textContent": "$I18N.panelTwo.screenPopTitle"
}]
}
(





