Ролі

Стандартний макет JSON виконує такі три ролі.

• агент—щоб налаштувати макет робочого столу, який відображатиметься, коли агент входить до Webex робочого столу контакт-центру для обробки дій агента.

• supervisor—щоб налаштувати макет робочого столу, який відображатиметься, коли супервізор входить до Webex робочого столу контакт-центру, щоб працювати лише з можливостями супервізора.

  Коли супервізор входить до робочого столу, застосовується макет робочого столу, указаний для основної групи. Якщо ви не вказали основну команду, застосовується глобальний макет. За замовчуванням звіти APS вимкнено.

• supervisorAgent — щоб налаштувати макет робочого столу, який відображатиметься, коли супервізор входить до Webex робочого столу контакт-центру, щоб керувати як функціями супервізора, так і діяльністю агента.

Нижче наведено властивості верхнього рівня для макета JSON на основі ролі:

{ "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": { ... }, "панель": { ... }, "навігація": { ... }, "постійний": { ... }, "без голови": { ... } }, }, "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": { ... }, "панель": { ... }, "навігація": { ... }, "постійний": { ... }, "без голови": { ... }, "домашня сторінка": { ... } }, } "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": { ... }, "панель": { ... }, "навігація": { ... }, "постійний": { ... }, "без голови": { ... } }, } },

appTitle

Для визначення заголовка на горизонтальному заголовку Робочого столу. Назва за замовчуванням Webex Контакт-центр.

приклад:

"appTitle": "Контакт-центр Webex"

Заголовок може бути текстом, зображенням або порожнім рядком. Текст заголовка з’являється у два рядки. Якщо текст виходить за межі другого рядка, відображається піктограма з крапкою, а спливаюча підказка відображає повний заголовок. До заголовка не можна застосувати стилі.

Ви можете використовувати дані URI (уніфікований ідентифікатор ресурсу) або розмістити власне зображення заголовка в мережі доставки вмісту (CDN), Amazon Web Services (AWS) Simple Storage Service (S3) або подібній службі хостингу, а потім указати URL-адресу розміщеного зображення. Підтримувані формати зображення заголовка: PNG, JPG, JPEG, GIF, SVG і WebP. Підтримуваний розмір зображення заголовка становить 184 x 32 пікселя (ширина x висота).

логотип

Щоб вказати URL для логотипу компанії. Якщо ви не вкажете URL-адресу, за замовчуванням з’явиться логотип Контакт-центру Webex.

приклад:

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

Ви можете розмістити власне зображення логотипу в CDN, сегменті Amazon Web Services (AWS) Simple Storage Service (S3) або подібній службі хостингу, а потім указати URL-адресу розміщеного зображення. Підтримувані формати зображень логотипу: PNG, JPG, JPEG, GIF, SVG і WebP. Підтримуваний розмір зображення логотипу становить 96 x 32 пікселів (ширина x висота).

taskPageIllustration

Щоб указати спеціальну ілюстрацію для сторінки завдання на основі вподобань організації та бренду. Коли агент входить, на сторінці завдань відображається налаштована ілюстрація як фон. За умовчанням сторінка завдання відображається без ілюстрації.

приклад:

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

Ви можете використовувати URI даних або розмістити спеціальну ілюстрацію в мережі доставки вмісту (CDN), Amazon Web Services (AWS) Simple Storage Service (S3) або подібній службі хостингу, а потім указати URL-адресу розміщеної ілюстрації. Ілюстрацію можна налаштувати на глобальному рівні або на рівні групи на основі визначення макета. Переконайтеся, що налаштовано правильну URL-адресу, щоб запобігти відображенню пошкодженого зображення на робочому столі.

Підтримувані формати ілюстрації сторінки завдань: PNG, JPG, JPEG, GIF, SVG і WebP. Рекомендований розмір ілюстрації – 400 x 400 пікселів (ширина x висота). Якщо настроюваний розмір ілюстрації більший за рекомендований, розмір ілюстрації коригується на основі співвідношення сторін на сторінці завдань. Якщо настроюваний розмір ілюстрації менший за рекомендований, фактичний розмір ілюстрації зберігається на сторінці завдань.

stopNavigateOnAcceptTask

Щоб визначити, чи перемістити фокус на нове прийняте завдання, коли агент приймає нове завдання під час роботи над попереднім завданням. Значення за замовчуванням: помилковий.

приклад:

"stopNavigateOnAcceptTask": помилка

Якщо значення встановлено як правда, коли користувач приймає нове завдання на Робочому столі, фокус зберігається на попередньому завданні й не переходить до нового прийнятого завдання. Цей параметр запобігає втраті користувачем будь-яких даних під час прийняття нового запиту.

Наприклад, припустімо, що Агент 1 спілкується в чаті з Клієнтом 1 і одночасно розмовляє з Клієнтом 2. Під час голосового дзвінка Агент 1 оновлює відомості про Клієнта 2 на панелі керування взаємодією. Наразі агент 1 має два активних завдання на панелі «Список завдань», а фокус знаходиться на панелі «Керування взаємодією». Коли Агент 1 приймає новий запит на чат від Клієнта 3, фокус залишається на панелі керування взаємодією з Клієнтом 2 і не переходить до щойно прийнятого запиту на чат.

Щоб зберегти фокус на попередньому завданні і не переходити на знову прийняте завдання, виберіть користувацький макет зі значенням властивості stopNavigateOnAcceptTask , встановленим на true.

Якщо значення властивості stopNavigateOnAcceptTask не введено в макеті JSON, робочий стіл зміщує фокус на знову прийняте завдання. Поведінка схожа на те, коли значення властивості stopNavigateOnAcceptTask встановлено як false.

dragDropEnabled

Щоб увімкнути перетягування та зміну розміру віджетів на користувацьких сторінках, встановіть значення true . За замовчуванням використовується значення false .

Приклад:

"dragDropEnabled": false

Таймер сповіщень

Щоб встановити тривалість (у секундах), після якої сповіщення на робочому столі автоматично закриваються. Сповіщення з'явиться у верхньому правому куті робочого столу. Значення часу очікування за замовчуванням становить 8 секунд. Допустимий діапазон значень тайм-ауту становить 1-10 секунд. Щоб зміни тайм-ауту вступили в силу, браузер повинен бути оновлений після внесення змін.

Приклад:

"notificationTimer": 8

maximumNotificationCount

Щоб настроїти кількість сповіщень на робочому столі, які відображатимуться одночасно на робочому столі. За замовчуванням використовується значення 3. Діапазон сповіщень на робочому столі – від 1 до 10. Сповіщення на робочому столі складаються один з одним. Якщо повідомлень багато, вони з'являються з невеликою затримкою в залежності від налаштувань notificationTimer .

browserNotificationTimer

Щоб встановити тривалість (у секундах), після якої сповіщення браузера про тостер на робочому столі автоматично закриваються. Тостер – це рідне сповіщення браузера, яке з'являється лише в тому випадку, якщо на робочому столі немає активного вікна або вкладки браузера. Вікно або вкладка браузера на робочому столі неактивні, якщо

• Ви працюєте в інших вікнах або вкладках браузера.

• Ви працюєте в інших додатках.

• Ви згорнули вікно браузера на робочому столі.

Сповіщення з'явиться у верхньому правому куті робочого столу. Значення часу очікування за замовчуванням становить 8 секунд. Рекомендований діапазон значень тайм-ауту становить 5-15 секунд. Щоб зміни тайм-ауту вступили в силу, браузер повинен бути оновлений після внесення змін.

Приклад:

"browserNotificationTimer": 8

wxmНалаштовано

(Необов'язково) Щоб налаштувати Webex Experience Management, встановіть значення true. За замовчуванням використовується значення false .

Приклад:

"wxmConfigured": true

desktopChatApp

Щоб налаштувати кілька програм чату, пропонованих Cisco, таких як програма Webex.

webexConfigured

Програму Webex разом із її функціями обміну повідомленнями та нарадами можна налаштувати на робочому столі. Ця конфігурація дозволяє агентам співпрацювати з іншими агентами, супервізорами та профільними експертами (МСП) у своїй організації, не відходячи від робочого столу.

Щоб налаштувати програму Webex на робочому столі:

• У Cisco Webex Control Hub при додаванні служб для користувача встановіть пункт Розширений обмін повідомленнями (Користувачі > Керування користувачами > Служби > Повідомлення). Щоб отримати додаткові відомості, перегляньте статтю Керування обліковими записами користувачів у службі адміністрування сайту Cisco Webex.

• У користувацькому макеті робочого столу встановіть значення властивості webexConfigured на true.

  Приклад:

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

  Значення за замовчуванням властивості webexConfigured має значення false .

  Програма Webex доступна для ролей агента, супервізора та супервізораАгента, лише якщо для кожної з цих ролей встановлено значення властивості webexConfigured true . Агент, супервізор або супервізорАгент не можуть вийти з програми Webex.

  Щоб відобразити (Webex) у горизонтальному заголовку робочого столу, введіть значення webex у властивості headerActions . Докладнішу інформацію можна знайти в розділі headerActions.

  Щоб увімкнути програму Webex для певної команди, виберіть настроюваний макет із встановленим значенням властивості webexConfigured true . Щоб отримати докладнішу інформацію, перегляньте статтю Створення команди.

Ви також можете налаштувати програму Webex на панелі допоміжної інформації, на сторінці користувача та в віджеті користувача. Докладнішу інформацію можна знайти в розділі Панель допоміжної інформації.

Сповіщення програми Webex

Значення, визначені за допомогою властивостей notificationTimer і browserNotificationTimer для таймера сповіщень, застосовні до програми Webex. Значення часу очікування за замовчуванням становить 8 секунд для цих властивостей. Для отримання додаткової інформації дивіться notificationTimer і browserNotificationTimer.

headerActions

Щоб змінити порядок піктограм у горизонтальному заголовку робочого столу. Порядок за замовчуванням виглядає наступним чином:

1. (Webex)

2. (Вихідний дзвінок)

3. (Центр сповіщень)

Встановіть значення властивості headerActions наступним чином:

Приклад:

Щоб змінити порядок значків за замовчуванням, введіть властивість headerActions і відповідні значення в користувацькому макеті.

Наприклад:

площа

Властивість area є основним розділом компонування робочого столу. Ви можете визначити планування відповідно до площі.

"area": { "header": { ... }, "advancedHeader: { { "comp": "widget-1", "attributes": { ... }, "сценарій": .... } }, "панель": { ... }, "навігація": { ... }, "наполегливий": { ... }, "безголовий": { ... } },

Ви можете налаштувати такі об'єкти області :

• Панель: представляє другу панель або крайню праву панель на панелі «Допоміжна інформація».

• Навігація: представляє користувацькі сторінки та їхні елементи навігації, пов'язані зі сторінками.

• Постійні: представляє віджети на рівні сторінки, які є постійними та відображаються на всіх сторінках робочого столу.

• Headless: представляє віджети, які не мають візуального інтерфейсу, але виконують логіку у фоновому режимі.

advancedHeader

Щоб налаштувати видимість і змінити порядок значків на горизонтальному заголовку робочого столу. Порядок за замовчуванням виглядає наступним чином:

1. (Webex)

2. (Вихідний дзвінок)

3. (Центр сповіщень)

4. (Селектор стану агента)

Встановіть значення властивості advancedHeader наступним чином:

Приклад:

"advancedHeader": [ { "comp": "agentx-webex" }, { "comp": "agentx-outdial" }, { "comp": "agentx-notification" }, { "comp": "agentx-state-selector" } { "comp": "widget-1", "attributes": { ... }, "сценарій": .... } ]

Щоб змінити порядок значків за замовчуванням, введіть властивість advancedHeader і відповідні значення в користувацькому макеті.

Віджети перетікають у випадаюче меню зліва направо.

Атрибути для постійних вкладок

Щоб установити вкладки на настроюваних сторінках і настроювані віджети як постійні, введіть атрибути для md-tabs у настроюваному макеті.

Приклад: встановити вкладки як постійні

{ "comp": "md-tabs", "attributes": { "persist-selection": true, "tabs-id": "unique-id для всіх вкладок разом у контейнері" }, }

Коли ви встановлюєте md-tabs як постійні (persist-selection: true), Agent Desktop зберігає вибір вкладок, навіть якщо агент перемикається між сторінками або віджетами на робочому столі.

The Більше вкладок розкривний список з’являється автоматично, якщо панель «Допоміжна інформація» містить кілька вкладок.

Ви повинні додати підказку спеціальної вкладки для читабельності та доступності. Щоб додати спливаючу підказку для спеціальної вкладки, оберніть компонент md-підказка. Введіть інформацію підказки в повідомлення власності та застосувати стиль значення властивостей, як показано в наступному прикладі.

"comp": "md-tooltip", "attributes": { "class": "widget-tabs", "message": "Зразок вкладки 1", "style": "max-width: 252px; min-width: 110px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; display: inline-block; margin-bottom: -10 пікселів;" },

Щоб увімкнути функцію перетягування на вкладці користувача, додайте наступну властивість у атрибути:

"comp": "md-tabs", "attributes": { "class": "widget-tabs", "draggable": true, "comp-unique-id": "sample-dynamic-custom-tabs" },

• перетягуються : Встановіть перетягуються вартість майна до правда.

• comp-unique-id : введіть унікальне значення для ідентифікації компонента.

  Наприклад:

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

Якщо ви ввімкнете перетягування для спеціальної вкладки, агент зможе перетягнути вкладку в потрібне місце на панелі допоміжної інформації. Щоб відновити порядок вкладок за замовчуванням, додайте таку властивість:

"comp": "agentx-wc-more-actions-widget", "attributes": { "slot": "settings", "class": "widget-pane", "tabs-unique-id": "sample-dynamic-custom-tabs" },

• agentx-wc-more-actions-widget : введіть компонент, який відображається як Більше дій () на панелі допоміжної інформації.

• slot="settings": введіть атрибут у компоненті, який відображається як параметр Скинути порядок вкладок у розкривному списку Додаткові дії . Агенти можуть скинути вкладки на панелі допоміжної інформації до порядку за замовчуванням, клацнувши значок > Скинути порядок вкладок.

• tabs-unique-id: введіть те саме унікальне значення, визначене для властивості comp-unique-id для зіставлення та скидання компонентів md-tabs .

У наведеному нижче прикладі коду використовуються функції Додаткові дії і Скинути порядок вкладок .

"comp": "agentx-wc-more-actions-widget", "attributes": { "slot": "settings", "class": "widget-pane", "tabs-unique-id": "sample-dynamic-custom-tabs" }, "children": [{ "comp": "div", "attributes": { "textContent": "спеціальна дія", "slot": "custom-action" }, "children": [{ "comp": "agentx-wc-notes-header-widget" }, { "comp": "agentx-wc-menu-notification" } ] }], }

Розкривний список Додаткові дії можна розширити, щоб додати додаткові спеціальні компоненти або віджети після параметра Скинути порядок вкладок . Нижче наведено приклад набору значень властивостей style , які можна застосувати до додаткових компонентів.

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

• Налаштуйте та отримайте доступ до віджета показників керування досвідом клієнтів із панелі навігації

• Використання вкладок на користувацькій сторінці

• Панель допоміжної інформації за замовчуванням з історією контактів і вікном

• Панель допоміжної інформації з віджетом Customer Experience Journey

Налаштуйте та отримайте доступ до віджета показників керування досвідом клієнтів із панелі навігації

Наприклад:

{ "nav": { "label": "Показники керування досвідом клієнтів", "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] } } } },

Використання вкладок на користувацькій сторінці

Наприклад:

{ "nav": { "label": "Динамічні вкладки", "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": "Два", "attributes": { "slot": "tab" } }, { "comp": "md-tab-panel", "textContent": "Два вмісту", "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] } } } }

Панель допоміжної інформації за замовчуванням з історією контактів і вікном

Наприклад:

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

Панель допоміжної інформації з віджетом Customer Experience Journey

Наприклад:

"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": "Подорож клієнта", "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": "слот", "attributes": { "name": "SCREEN_POP" } }], "visibility": "SCREEN_POP" } "visibility": "SCREEN_POP" }, },