Конфигуриране на актив за чат

Общ преглед

Използвайте цифрови канали в Control Hub, за да създадете и конфигурирате актив за чат за уеб (чат на живо), мобилни устройства (съобщения в приложението) и Push Notifications. Настройките, налични за конфигуриране, зависят от услугата, избрана в Присво яване на, и от това дали изберете Web, Mobile или и двете.

Тази статия описва пълния процес на конфигуриране на активи, включително поддържани възможности, съобщения, идентификационни данни на доставчика на push, оторизация на JSON Web Token (JWT), JSON Web Keys (JWK), транспортни протоколи, регистрация на много потребители и специфична за услугата конфигурация след създаването на актива.

Поддържани възможности

Таблица 1. Поддържани възможности от услугата
Възможност	Webex Connect	Контакт център на Webex	Webex Контакт Център Ентърпрайз
Уеб чат на живо	Поддържа се	Поддържа се	Поддържа се
Мобилни съобщения в приложението	Поддържа се	Поддържа се	Поддържа се
Уеб и мобилни устройства в един актив	Поддържа се	Не се поддържа	Не се поддържа
Мобилни - Android push известия	Поддържа се	Поддържа се	Поддържа се
Мобилни - iOS push известия	Поддържа се	Поддържа се	Поддържа се
Уеб Push известия	Поддържа се (Chrome и Firefox)	Не се поддържа	Не се поддържа
JWT - Мобилен	Поддържа се	Поддържани и задължителни	Поддържани и задължителни
JWT - Уеб	Поддържа се	Не се поддържа	Не се поддържа
Регистрации на множество потребители	Поддържа се	Поддържа се	Поддържа се
Входяща поща от страна на сървъра	Поддържа се	Не е приложимо	Не е приложимо
Поток от данни	Поддържа се	Не е приложимо	Не е приложимо

Преди да започнете

Влезте в Control Hub като пълен администратор или администратор на Центъра за контакти, който може да управлява цифрови активи.
Уверете се, че Webex Connect цифровите услуги, Webex Contact Center или Contact Center Enterprise са предоставени за организацията. Без правото цифровите активи не са налични.
Идентифицирайте входната точка и потока на Центъра за контакти, които ще получават нови чат разговори.
Ако внедряването използва мобилни push известия, подгответе идентификационните данни на Firebase, Huawei или Apple , изисквани от избраната платформа.
Ако планирате да използвате JWT оторизация, подгответе публичния JWK, използван за проверка на токените, издадени от вашия надежден бекенд.

Конфигуриране на актива за чат

За да конфигурирате актив за чат:

1	Влезте в контролния център.
2	Отидете в Услу ги > Цифрови активи.
3	Изберете Съ здаване на актив.
4	В Конфигуриране на подробности за активи въведете следните стойности: Име (задължително): Въведете име на актива. Описание: Въведете незадължително описание на случая на употреба. Канал (задължително): Изберете Чат. Не можете да промените канала след създаването на актива. Присвояване към (задължително): ИзберетеWebex Connect, Контактен център на Webex или Webex Contact Center Enterprise. Наличните опции зависят от правата на организацията.
5	В Съобщения изберете платформата и конфигурирайте чат на живо/Съобщения в приложението и всички необходими push известия. Показаните опции зависят от избраната платформа. Настройките за уведомяване за Android и iOS са налични, когато е избран мобилен телефон. Web Push е наличен, когато е избран Web за актив, на който е присвоенWebex Connect.

Конфигуриране на съобщения

В Съобщения изберете платформата и конфигурирайте възможностите за съобщения за актива.

За да конфигурирате съобщенията:

Протоколите за първичен и вторичен транспорт трябва да са различни. Ако SDK не може да установи връзка с помощта на първичния протокол, той използва вторичния протокол като резервен файл.

1	Платформа: ЗаWebex Connect, изберете Уеб, Мобилен телефон или и двете. За мобилни устройства изберете Android, iOS или и двете. За Контактния център на Webex или Webex Contact Center Enterprise изберете Уеб или Мобилен телефон.
2	Чат на живо/Съобщения в приложението: ЗаWebex Connect, той е достъпен за уеб и мобилни устройства. За Webex Contact Center или Webex Contact Center Enterprise, Web предоставя чат на живо, а мобилният предоставя съобщения в приложението.
3	Протокол за първичен транспорт: Изберете MQTT или Web Socket.
4	Вторичен транспортен протокол: Изберете протокола, който не е избран като първичен.

Конфигуриране на push известия

Акти вирайте Разрешаване на push известия, когато приложението трябва да получава известия чрез конфигуриран доставчик на push. Показаните секции за уведомяване зависят от избраната платформа.

Налични са следните опции на доставчика на push:

Android: Firebase Cloud Messaging (FCM), Huawei или и двете. Прилага се за Webex Connect Контактния център на Webex и Webex Contact Center Enterprise.
iOS: FCM, Apple Push Notification Service (APNS) или удостоверяване, базирано на токени за APNS. Прилага се за Webex Connect Контактния център на Webex и Webex Contact Center Enterprise.
Уеб: Облачни съобщения Firebase. Прилага се Webex Connect само за.

Изберете платформата и конфигурирайте приложимия доставчик в съответната тема.

Вземете JSON акаунта за услугата Firebase

Webex използва JSON файл за акаунт на услугата Firebase за удостоверяване на заявките на сървъра към Firebase Cloud Messaging. Използвайте проекта Firebase, свързан с вашето приложение.

За да получите и качите JSON акаунта за услугата Firebase:

Защита: Про филът на услугата Firebase JSON съдържа чувствителни идентификационни данни. Съхранявайте го сигурно и качете само файла за планирания проект Firebase.

За инструкции за конфигуриране на съобщения в облак на Firebase виж те Изпращане на съобщение чрез API FCM HTTP v1.

1	Отворете конзолата Firebase и изберете проекта Firebase, използван от вашето приложение.
2	Отворете Настройки на проекта > Сер визни акаун ти.
3	Изберете Генериране на нов частен клю ч и потвърдете изтеглянето.
4	Съхранявайте изтегления JSON файл сигурно. Файлът съдържа идентификационни данни с частен ключ.
5	В Control Hub качете JSON файла в Качване на Firebase Service Account JSON за приложимата конфигурация за Android, iOS или уеб известия.

Конфигурирайте Android push известия

Разделът за уведомяване за Android се показва, когато са избрани мобилни устройства, Android и Разреш аване на push известия. Изберете поне един доставчик; Firebase и Huawei могат да бъдат конфигурирани поотделно или заедно. Тази конфигурация е достъпна заWebex Connect, Webex Contact Center и Webex Contact Center Enterprise Mobile активи.

Документация на доставчика: Huawei - Настройка и тестване на Push Kit

1	Изберете Мобилни устройства, Android и Разрешаване на push известия. Показва се секцията за уведомяване за Android.
2	Изберете Firebase Cloud Messaging и качете необходимия JSON файл за акаунт в Firebase Service от проекта Firebase.
3	Ако приложението поддържа устройства, които използват мобилни услуги на Huawei, изберете Huawei и въведете идентификатора в приложението и Тай ната в приложението от AppGallery Connect. Изключение на Huawei: Конфигурацията на Huawei може да бъде пропусната, когато приложението не поддържа устройства без услугите на Google Play. Текущите Webex Connect насоки поддържат EMUI 10.x и по-нови версии.

Конфигурирайте push известия за iOS

Разделът за уведомяване за iOS се показва, когато са избрани мобилни устройства, iOS и Разрешаване на push известия. Изберете един доставчик на push. Тази конфигурация е достъпна заWebex Connect, Webex Contact Center и Webex Contact Center Enterprise Mobile активи.

За инструкции за конфигуриране на APN, базирани на сертификати, вижте Установяване на връзка, бази рана на сертификати, към APN.

За инструкции за конфигуриране на APN базирани на токени вижте Установяване на връзка, бази рана на токени, към APN.

1	Изберете Мобилни устройства, iOS и Разрешаване на push известия. Показва се секцията за уведомяване на iOS.
2	Изберете един доставчик на push.
3	За съобщения в облак на Firebase качете файла JSON за акаунт на Firebase Service, изтеглен от проекта Firebase.
4	За Apple Push Notification Service (APNS) въведете паролата за сертификат, изберете Sandbox или Production, качете APNS сертификата, въведете име и потвърдете конфигурацията. Поддържа се само форматът на сертификат.p12.
5	За удостоверяване на APNS, базирана на токени, въведете идентификатора на ключа, идентификатора на екипа и пакета на приложението или идентификатора на пакета, изберете Sandbox или Production и качете файла с частен ключ на APNS. Избор на шлюз: Използвайте Sandbox за приложение за разработка и Production за приложение, готово за производство. Съхранявайте частния ключ на APNS сигурно; Apple позволява изтегленият файл.p8 ключ да бъде изтеглен само веднъж.
6	Заменете сертификата на доставчика на Apple преди изтичането му, за да избегнете прекъсване на доставката.

Конфигуриране на уеб Push известия

Web Push известията са достъпни само за активи, присво Webex Connect ени към избраната мрежа Web. Поддържат се Chrome и Firefox. Понастоящем Safari Web Push не се поддържа.

Web Push известия не се поддържат за ресурси, присвоени на Webex Contact Center или Webex Contact Center Enterprise.

За да конфигурирате Web Push известия:

1	Потвърдете, че активът е при Webex Connect своен и че е избран Web.
2	Използвайте Chrome или Firefox, за да получите достъп до уебсайта и да получавате известия за Web Push.
3	URL адрес на уебсайта (задължително): Въведете URL адреса на уебсайта, който ще получава Web Push известия.
4	Икона за уведомяване (задължително): Въведете пътя към иконата за уведомяване. Иконата трябва да е 80 х 80 пиксела.
5	Конфигурирайте Firebase Cloud Messaging (FCM) за вашето уеб приложение, като следвате документацията на Fire base.
6	Firebase Service Account JSON (задължително): Качете JSON файла за сметка на услугата Firebase, съдържащ частния ключ, необходим за използване на API за съобщения в облак Firebase HTTP v1.

Конфигурирайте разрешение за уеб токен JSON

Разрешаването на JWT изисква комуникацията с SDK да бъде оторизирана с помощта на валиден JSON уеб токен. За нови активи типът криптиране е асиметричен.

Поддръжката на JWT е както следва:

Webex Connect: Поддържа се за мобилни устройства и уеб в един и същ актив.
Контактен център на Webex и Webex Contact Center Enterprise - Уеб: Не се поддържа.
Webex Contact Center и Webex Contact Center Enterprise - Mobile: Поддържа се и изисква за конфигурацията на мобилните активи.

Конфигурирайте следните настройки:

Тип криптиране: Асиметричен за нови активи.
Изтичане на токена (задължително): Въведете колко дълго JWT остава валиден, преди да се изисква нов токен за идентичност на потребителя. Валиден диапазон: 5-360 минути. По подразбиране: 60 минути.
JSON уеб ключове (задължително): Качете публичния JWK, използван за проверка на токени. Можете да добавите втори клавиш за завъртане. Максимум: два клавиша.

Добавете и подгответе публичния JSON уеб ключ, както е описано в детските теми.

Подгответе публичния JWK

Каченият файл трябва да съдържа публичния ключ за проверка на RSA. Webex валидира следните свойства на JWK.

Свойствата на JWK са дефинирани в RFC 7517, раздел 4. Специфичните за алгоритъма свойства са дефинирани в RFC 7518.

Таблица 2. Публични имоти на JWK
Име на имота	Описание
алг	Идентифицира криптографския алгоритъм, използван с ключа. Необходимата стойност е RS256, която определя RSASSA-PKCS1- използвайки SHA-256. v1_5
д	Експонентът за RSA публичния ключ, представен като коди рана от Base64URLUint стойност.
key_ops	Определя операцията, за която е предназначен ключът. Поддържаната стойност е проверка, което показва, че ключът се използва за проверка на цифрови подписи. Виж RFC 7517, раздел 4.3.
кти	Идентифицира семейството на криптографски алгоритми, използвано с ключа. Стойността трябва да бъде RSA. Виж RFC 7517, раздел 4.1.
н	Модулът за RSA публичния ключ, представен като Base64URLUint кодирана стойност.
използвайте	Определя предназначението на публичния ключ. Стойността трябва да бъде sig, което показва, че ключът е предназначен за проверка на подписа. Вижте RFC 7517, точка 4.2.
хлапе	Идентифицира ключа и се използва за съвпадение на конкретен ключ, например по време на завъртане на клавиша. Виж RFC 7517, раздел 4.5.

Качете само публичния ключ за проверка. Запазете съответния частен ключ за подписване в доверената система, която издава JWT.

Добавяне на JSON уеб ключ

За да добавите публичен JSON уеб ключ:

1	Изберете Добави клавиш.
2	Въведете име на уеб ключ JSON.
3	Въведете издателя на уеб ключа JSON. Тази стойност трябва да съответства на емитента, използван от доверения бекенд, когато генерира JWT.
4	Качете публичния JWK файл.
5	Изберете За пазване.

Конфигурирайте многопотребителски регистрации

Акти вирайте Разрешаване на регистрации на няколко потребители на едно и също устройство, когато няколко потребители могат да се регистрират на едно и също физическо устройство.

Пуш-известия се доставят както за активни, така и за неактивни регистрирани потребители.
Чат на живо или съобщения в приложението се доставят на активния в момента потребител. Съобщенията за неактивни потребители се поставят на опашка, докато потребителят отново стане активен.

Конфигуриране на допълнителни Webex Connect настройки

Следните разширени настройки се отнасят само за Webex Connect активи и не са приложими за активите на Webex Contact Center или корпоративните активи на Webex Contact Center.

Едно устройство на потребител: Ограничава потребителя до едно регистрирано устройство. Регистрацията на ново устройство спира доставката на push до по-старото устройство.
Входяща кутия от страна на сървъра: Съхранява копие от страна на сървъра на данните от входящата поща за по-късно извличане.
Поток от данни: Изпраща приложими данни за събитията към избраната Webex Connect интеграция за съобщения, изпратени чрез API за съобщения.

Запазване, за да създадете актива

След като конфигурирате приложимите съобщения, JWT оторизация, регистрация на множество потребители и Webex Connect настройки, запазете конфигурацията, за да създадете актива за чат.

Изберете За пазване, за да създадете актива.

Изчакайте потвърждение, че активът е създаден успешно.

Пълна интеграция на услугата

След като създадете актива Чат, завършете интеграцията за услугата, избрана в При свояване на. Следвайте приложимата процедура за We Webex Connect bex Contact Center или Webex Contact Center Enterprise.

Пълна Webex Connect интеграция

За присвоен актив завършете Webex Connect картографирането на услугата и конфигурацията на потока вWebex Connect. Не се изисква оторизация на възел.

Можете да използвате начален възел, персонализирано събитие или персонализиран Webhook, за да заснемете входящи събития и да задействате поток. За повече информация вижте Стартов възел, Пер сон ализирано събитие и Пер сон ализиран уеб ключ.

1	Влезте вWebex Connect.
2	Попълнете приложимото картографиране на услуги и конфигурация на потока за актива Chat.
3	Запишете генерирания идентификатор на приложението и клиентския ключ.
4	Изтеглете SDK конфигурационния файл за всяка избрана платформа.

Пълна интеграция на Webex Контакт Център

За актив, присвоен на Webex Contact Center, картографирайте актива в входна точка за контакт център и след това завършете разрешаването на възела на Webex Contact Center.

Активът може да бъде картографиран само с една входна точка. Завършете картографирането на входната точка и потока, преди да публикувате клиентското изживяване.

1	Отворете конфигура цията на Контактния център в Control Hub.
2	Създайте или отворете входната точка, която получава чат разговори.
3	В Кар тографиране на потока изберете актива за чат и необходимия поток за влизане на клиенти.
4	Запазете входната точка и проверете картографирането на активи и потоци.
5	Попълнете разрешение за възел на Webex Contact Center в. Webex Connect За инструкции вижте Възли и разрешения за възли за интеграция на задачи на Webex CC.
6	За уеб внедряване конфигурирайте приспособлението за чат на живо и получете кода за вграждане на уебсайта в Control Hub.

Пълна интеграция на Webex Contact Center Enterprise

За актив, присвоен на Webex Contact Center Enterprise, попълнете разрешаването на CCE възел, Webex Connect преди да конфигурирате маршрутизиращия поток.

1	Влезте вWebex Connect.
2	Пълно оторизация на CCE възел. За инструкции вижте CCE Интеграционни възли и разрешения за въз ли.
3	Конфигурирайте приложимите CCE интеграционни възли и маршрутизиращия поток за актива Chat. За примери за потоци вижте Конфигурации на пото ка.
4	Запазете и тествайте потока.

За допълнителни указания за конфигуриране вижте Най-добри практики и насо ки и често задавани въпроси.

Изключения и ограничения

Имайте предвид следните изключения и ограничения:

Потвърдете избора на канала, платформата, заданието и маршрутизирането, преди да създадете актива. Каналът не може да бъде променен след създаването, а промените в платформата са ограничени от натоварването.
За Webex Contact Center и Webex Contact Center Enterprise един актив не може да използва Web и Mobile заедно. Създайте отделни активи, когато са необходими и двете.
Web Push известията са достъпни само заWebex Connect. Safari Web Push, Webex Contact Center Web Push и Webex Contact Center Enterprise Web Push не се поддържат.
Упълномощаването на JWT не се поддържа за уеб активи, присвоени на Webex Contact Center или Webex Contact Center Enterprise.
За Webex Contact Center и Webex Contact Center Enterprise изпълнете конфигурация на входна точка, поток, джаджа и вграден код в секцията Контактен център на контролния център.
ЗаWebex Connect, завършете конфигурацията на услугата и потока вWebex Connect.
Не изтривайте актив за чат, след като е картографиран към услуга, без първо да премахвате или актуализирате картографирането надолу по веригата. Изтрит актив не може да бъде възстановен и може да остави съществуващо картографиране неизползваемо.
След създаването запазете генерирания ID на приложението, клиентски ключ и SDK конфигурационни файлове, необходими за инициализиране на съответния SDK.

Cisco AI Assistant

Благодарим за обратната връзка.