- Главная
- /
- Статья
Благодарим вас за обратную связь.
В этой статье
Отправить обратную связь?Создайте и настройте цифровой ресурс чата в Control Hub для Webex Connect, контакт-центра Webex или Webex Contact Center Enterprise.
Обзор
Используйте цифровые каналы в Control Hub, чтобы создать и настроить ресурс чата для Интернета (онлайн-чат), мобильных устройств (обмен сообщениями в приложении) и push-уведомлений. Доступные для настройки параметры зависят от сервиса, выбранного в разделе «Присвоить», а также от того, выбираете ли вы Интернет, мобильное устройство или и то, и другое.
В этой статье описывается полный процесс настройки ресурсов, включая поддерживаемые возможности, обмен сообщениями, учетные данные push-провайдера, авторизацию JSON Web Token (JWT), веб-ключи JSON (JWK), транспортные протоколы, многопользовательскую регистрацию и конфигурацию конкретного сервиса после создания ресурса.
Поддерживаемые возможности
| Возможности | Webex Connect | Контактный центр Webex | Корпоративный контакт-центр Webex |
|---|---|---|---|
| Онлайн-чат | Поддерживается | Поддерживается | Поддерживается |
| Мобильный обмен сообщениями в приложении | Поддерживается | Поддерживается | Поддерживается |
| Интернет и мобильные устройства в одном ресурсе | Поддерживается | Не поддерживается | Не поддерживается |
| Мобильные устройства — push-уведомления для Android | Поддерживается | Поддерживается | Поддерживается |
| Мобильные устройства — push-уведомления для iOS | Поддерживается | Поддерживается | Поддерживается |
| Push-уведомления в Интернете | Поддерживаются (Chrome и Firefox) | Не поддерживается | Не поддерживается |
| JWT — мобильное устройство | Поддерживается | Поддерживается и требуется | Поддерживается и требуется |
| JWT — Интернет | Поддерживается | Не поддерживается | Не поддерживается |
| Многопользовательские регистрации | Поддерживается | Поддерживается | Поддерживается |
| Входящие на стороне сервера | Поддерживается | Не применимо | Не применимо |
| Поток данных | Поддерживается | Не применимо | Не применимо |
Прежде чем начать
- Войдите в Control Hub в качестве полноправного администратора или администратора контакт-центра, который может управлять цифровыми активами.
- Убедитесь, что организации предоставлены Webex Connect цифровые сервисы, контакт-центр Webex или Contact Center Enterprise. Без этого права цифровые активы недоступны.
- Определите точку входа и канал входа в контакт-центр, куда будут поступать новые разговоры в чате.
- Если в развертывании используются push-уведомления для мобильных устройств, подготовьте учетные данные Firebase, Huawei или Apple, необходимые выбранной платформе.
- Если вы планируете использовать авторизацию JWT, подготовьте общедоступный JWK, используемый для проверки токенов, выпущенных вашим доверенным бэкендом.
Настройте ресурс Chat
Чтобы настроить ресурс чата, выполните следующие действия:
| 1 |
Войдите в Control Hub. |
| 2 |
Перейдите в раздел Сервисы > Цифровые активы. |
| 3 |
Выберите Создать актив. |
| 4 |
В поле Настройка сведений об активе введите следующие значения:
|
| 5 |
В разделе «Обмен сообщениями» выберите платформу и настройте онлайн-чат, обмен сообщениями в приложении и все необходимые push-уведомления. Отображаемые опции зависят от выбранной платформы. Настройки уведомлений для Android и iOS доступны, если выбрано мобильное устройство. Функция Web Push доступна, если в качестве ресурса выбран ИнтернетWebex Connect. |
Настройте обмен сообщениями
В разделе Обмен сообщениями выберите платформу и настройте возможности обмена сообщениями для актива.
Чтобы настроить обмен сообщениями, выполните следующие действия:
Основные и вторичные транспортные протоколы должны отличаться. Если SDK не может установить соединение с использованием основного протокола, он использует вторичный протокол в качестве запасного варианта.
| 1 |
Платформа: выберите вариант «Интернет»Webex Connect, «Мобильная» или «Обе платформы». Для мобильных устройств выберите Android, iOS или и то, и другое. Для контакт-центра Webex или Webex Contact Center Enterprise выберите «Интернет» или «Мобильное устройство». |
| 2 |
Онлайн-чат/обмен сообщениями в приложении: для этого приложение доступно для Webex Connect Интернета и мобильных устройств. Для контакт-центра Webex или Webex Contact Center Enterprise Интернет предоставляет интерактивный чат, а мобильные устройства предоставляют обмен сообщениями в приложении. |
| 3 |
Основной транспортный протокол: выберите MQTT или Web Socket. |
| 4 |
Вторичный транспортный протокол: выберите протокол, который не выбран в качестве основного. |
Настройка push-уведомлений
Включите опцию Разрешить push-уведомления, если приложение должно получать уведомления от настроенного поставщика push-уведомлений. Отображаемые разделы уведомлений зависят от выбранной платформы.
Доступны следующие варианты push-провайдера:
- Android: облачный обмен сообщениями Firebase (FCM), Huawei или и то, и другое. Относится к Webex Connect контакт-центру Webex и контакт-центру Webex Enterprise.
- iOS: FCM, служба push-уведомлений Apple (APNS) или аутентификация на основе токенов для APNS. Относится к Webex Connect контакт-центру Webex и контакт-центру Webex Enterprise.
- Интернет: облачный обмен сообщениями Firebase. Относится Webex Connect только к.
Выберите платформу и настройте соответствующего поставщика в соответствующем разделе.
Получите учетную запись службы Firebase в формате JSON
Webex использует JSON-файл учетной записи службы Firebase для аутентификации серверных запросов к Firebase Cloud Messaging. Используйте проект Firebase, связанный с вашим приложением.
Чтобы получить и загрузить учетную запись службы Firebase в формате JSON, выполните следующие действия:
Безопасность: учетная запись службы Firebase JSON содержит конфиденциальные учетные данные. Надежно храните его и загрузите только файл для предполагаемого проекта Firebase.
Инструкции по настройке Firebase Cloud Messaging см. в разделе Отправка сообщения с помощью API FCM HTTP v1.
| 1 |
Откройте консоль Firebase и выберите проект Firebase, используемый вашим приложением. |
| 2 |
Откройте «Настройки проекта» > «Учетные записи служб». |
| 3 |
Выберите «Сгенерировать новый закрытый ключ» и подтвердите загрузку. |
| 4 |
Надежно храните загруженный файл JSON. Файл содержит учетные данные с закрытым ключом. |
| 5 |
В Control Hub загрузите файл JSON в поле «Загрузить учетную запись службы Firebase JSON» для соответствующей конфигурации уведомлений Android, iOS или Интернета. |
Настройте push-уведомления Android
Раздел уведомлений Android отображается, если выбран вариант «Мобильное устройство», «Android» и «Разрешить push-уведомления». Выберите хотя бы одного поставщика; Firebase и Huawei можно настроить по отдельности или вместе. Эта конфигурация доступна для мобильных Webex Connect ресурсов контакт-центра Webex и корпоративного контакт-центра Webex.
Документация поставщика: настройка и тестирование Huawei — Push Kit
| 1 |
Выберите «Мобильное устройство», «Android» и «Разрешить push-уведомления». Отобразится раздел уведомлений Android. |
| 2 |
Выберите Firebase Cloud Messaging и загрузите требуемый JSON-файл учетной записи службы Firebase из проекта Firebase. |
| 3 |
Если приложение поддерживает устройства, использующие мобильные сервисы Huawei, выберите Huawei и введите идентификатор в приложении и секрет в приложении в AppGallery Connect. Исключение от Huawei: конфигурацию Huawei можно пропустить, если приложение не поддерживает устройства без сервисов Google Play. Текущее Webex Connect руководство поддерживает EMUI 10.x и более поздние версии. |
Настройте push-уведомления iOS
Раздел уведомлений iOS отображается, если выбраны опции «Мобильное устройство», «iOS» и «Разрешить push-уведомления». Выберите одного поставщика push-сообщений. Эта конфигурация доступна для мобильных Webex Connect ресурсов контакт-центра Webex и корпоративного контакт-центра Webex.
Инструкции по настройке APN на основе сертификатов см. в разделе Установление подключения к APN на основе сертификатов.
| 1 |
Выберите «Мобильное устройство», «iOS» и «Разрешить push-уведомления». Отобразится раздел уведомлений iOS. |
| 2 |
Выберите одного поставщика push-сообщений. |
| 3 |
Для обмена сообщениями в облаке Firebase загрузите JSON-файл учетной записи службы Firebase, загруженный из проекта Firebase. |
| 4 |
Для службы push-уведомлений Apple (APNS) введите пароль сертификата, выберите Sandbox или Production, загрузите сертификат APNS, введите имя и подтвердите конфигурацию. Поддерживается только формат сертификата.p12. |
| 5 |
Для аутентификации APNS на основе токенов введите идентификатор ключа, идентификатор команды и идентификатор пакета приложения или пакета, выберите Sandbox или Production и загрузите файл закрытого ключа APNS. Выбор шлюза: используйте Sandbox для приложения для разработки и Production для приложения, готового к работе. Надежно храните закрытый ключ APNS; Apple разрешает извлекать загруженный ключевой файл с расширением.p8 только один раз. |
| 6 |
Замените сертификат поставщика Apple до истечения срока его действия, чтобы избежать прерывания поспешной доставки. |
Настройте веб-push-уведомления
Веб-push-уведомления доступны только для ресурсов, Webex Connect которым присвоен статус «Интернет». Поддерживаются Chrome и Firefox. Safari Web Push в настоящее время не поддерживается.
Веб-push-уведомления не поддерживаются для ресурсов, назначенных контакт-центру Webex или Webex Contact Center Enterprise.
Чтобы настроить веб-push-уведомления, выполните следующие действия:
| 1 |
Убедитесь, что ресурс назначен Webex Connect и выбран Web. |
| 2 |
Используйте Chrome или Firefox для доступа к веб-сайту и получения Push-уведомлений в Интернете. |
| 3 |
URL-адрес веб-сайта (обязательно): введите URL-адрес веб-сайта, на который будут приходить уведомления Web Push. |
| 4 |
Значок уведомления (обязательно): введите путь к значку уведомления. Размер значка должен быть 80 x 80 пикселей. |
| 5 |
Настройте Firebase Cloud Messaging (FCM) для своего веб-приложения, следуя документации Firebase. |
| 6 |
JSON учетной записи службы Firebase (обязательно): загрузите JSON-файл учетной записи службы Firebase, содержащий закрытый ключ, необходимый для использования API Firebase Cloud Messaging HTTP v1. |
Настройте авторизацию веб-токенов JSON
Для авторизации JWT требуется авторизация связи с SDK с использованием действительного веб-токена JSON. Для новых ресурсов используется асимметричный тип шифрования.
Поддержка JWT выглядит следующим образом:
- Webex Connect: Поддерживается как для мобильных устройств, так и для Интернета в одном ресурсе.
- Контактный центр Webex и контактный центр Webex Enterprise — Web: не поддерживаются.
- Контактный центр Webex и Webex Contact Center Enterprise — Mobile: поддерживаются и необходимы для конфигурации мобильных ресурсов.
Настройте следующие параметры:
- Тип шифрования: асимметричный для новых активов.
- Срок действия токена (обязательно): укажите, как долго JWT остается действительным, прежде чем потребуется новый токен идентификации пользователя. Допустимый диапазон: 5-360 минут. По умолчанию: 60 минут.
- Веб-ключи JSON (обязательно): загрузите общедоступный файл JWK, используемый для проверки токенов. Можно добавить второй ключ для ротации. Максимум: две клавиши.
Добавьте и подготовьте публичный веб-ключ JSON, как описано в дочерних разделах.
Подготовьте общедоступный JWK
Загруженный файл должен содержать публичный проверочный ключ RSA. Webex проверяет следующие свойства JWK.
Свойства JWK определены в документе RFC 7517, раздел 4. Специфичные для алгоритма свойства определены в RFC 7518.
| Название свойства | Описание |
|---|---|
| флаг | Определяет криптографический алгоритм, используемый с ключом. Требуемое значение — RS256, которое указывает RSASSA-PKCS1- с использованием SHA-256. v1_5 |
| e | Показатель публичного ключа RSA, представленный в виде значения в кодировке Base64URLUint. |
| key_ops | Указывает операцию, для которой предназначен ключ. Поддерживаемое значение — верифицировать, что означает, что ключ используется для проверки цифровых подписей. См. документ RFC 7517, раздел 4.3. |
| ключ | Определяет семейство криптографических алгоритмов, используемых с ключом. Значение должно быть RSA. См. документ RFC 7517, раздел 4.1. |
| n | Модуль открытого ключа RSA, представленный в виде значения в кодировке Base64URLUint. |
| использование | Указывает предполагаемое использование публичного ключа. Значение должно быть sig, указывающее на то, что ключ предназначен для проверки подписи. См. документ RFC 7517, раздел 4.2. |
| ребенок | Идентифицирует ключ и используется для сопоставления определенного ключа, например, при ротации клавиш. См. документ RFC 7517, раздел 4.5. |
Добавьте веб-ключ JSON
Чтобы добавить публичный веб-ключ JSON, выполните следующие действия:
| 1 |
Выберите Добавить ключ. |
| 2 |
Введите имя веб-ключа JSON. |
| 3 |
Введите эмитента веб-ключа JSON. Это значение должно соответствовать эмитенту, используемому доверенным бэкендом при создании JWT. |
| 4 |
Загрузите общедоступный файл JWK. |
| 5 |
Выберите «Сохранить». |
Настройте многопользовательскую регистрацию
Включите опцию Разрешить многопользовательскую регистрацию на одном устройстве, если несколько пользователей могут регистрироваться на одном физическом устройстве.
- Push-уведомления доставляются как активным, так и неактивным зарегистрированным пользователям.
- Онлайн-чат или обмен сообщениями в приложении доставляются текущему активному пользователю. Сообщения неактивных пользователей помещаются в очередь до тех пор, пока пользователь снова не станет активным.
Настройте дополнительные Webex Connect параметры
- Одно устройство на пользователя: пользователь может использовать только одно зарегистрированное устройство. Регистрация на новом устройстве прекращает отправку push-сообщений на старое устройство.
- Входящие на стороне сервера: хранит серверную копию данных из папки «Входящие» для последующего извлечения.
- Поток данных: отправляет в выбранную Webex Connect интеграцию соответствующие данные о событиях для сообщений, отправленных через Messaging API.
Сохраните, чтобы создать ресурс
После настройки соответствующих сообщений, авторизации JWT, многопользовательской регистрации и Webex Connect настроек сохраните конфигурацию, чтобы создать ресурс Chat.
|
Нажмите кнопку Сохранить, чтобы создать ресурс. Дождитесь подтверждения того, что ресурс был успешно создан.
|
Полная интеграция сервисов
После создания ресурса Chat завершите интеграцию сервиса, выбранного в разделе Присвоить. Выполните процедуруWebex Connect, применимую к контакт-центру Webex или Webex Contact Center Enterprise.
Полная интеграция Webex Connect
Для присвоенного актива Webex Connect выполните сопоставление сервисов и настройку потоков Webex Connect в. Авторизация ноды не требуется.
Для регистрации входящих событий и запуска потока можно использовать стартовый узел, настраиваемое событие или настраиваемый веб-хук. Дополнительные сведения см. в разделах «Запуск узла», «Настраиваемое событие» и «Настраиваемый веб-хук».
| 1 |
Войдите в. Webex Connect |
| 2 |
Выполните соответствующее сопоставление сервисов и настройку потока для ресурса Chat. |
| 3 |
Запишите сгенерированный идентификатор приложения и ключ клиента. |
| 4 |
Загрузите файл конфигурации SDK для каждой выбранной платформы. |
Полная интеграция с контакт-центром Webex
Для ресурса, присвоенного контактному центру Webex, сопоставьте ресурс с точкой входа в контактный центр, а затем выполните авторизацию узла Webex Contact Center.
| 1 |
Откройте конфигурацию контакт-центра в Control Hub. |
| 2 |
Создайте или откройте точку входа, в которую принимаются разговоры в чате. |
| 3 |
В окне Flow Mapping выберите ресурс «Чат» и необходимый процесс ввода данных о клиентах. |
| 4 |
Сохраните точку входа и проверьте сопоставление ресурсов и потоков. |
| 5 |
Завершите авторизацию узла контакт-центра Webex в. Webex Connect Инструкции см. в разделе Узлы интеграции задач Webex CC и авторизации узлов. |
| 6 |
Для веб-развертывания настройте виджет Live Chat и получите код для встраивания веб-сайта в Control Hub. |
Полная интеграция Webex Contact Center Enterprise
Для ресурса, присвоенного Webex Contact Center Enterprise, Webex Connect перед настройкой потока маршрутизации выполните авторизацию узла CCE.
| 1 |
Войдите в. Webex Connect |
| 2 |
Завершите авторизацию узла CCE. Инструкции см. в разделе Узлы интеграции CCE и авторизации узлов. |
| 3 |
Настройте соответствующие узлы интеграции CCE и поток маршрутизации для ресурса Chat. Примеры потоков см. в разделе Конфигурации потоков. |
| 4 |
Сохраните и протестируйте поток. |
Дополнительные рекомендации по настройке см. в разделах «Передовые практики и рекомендации» и «Часто задаваемые вопросы».
Исключения и ограничения
Помните о следующих исключениях и ограничениях:
- Перед созданием ресурса подтвердите выбор канала, платформы, назначения и маршрута. После создания канал изменить нельзя, а изменения в платформе ограничены рабочей нагрузкой.
- В контакт-центре Webex и Webex Contact Center Enterprise один ресурс не может совместно использовать Интернет и мобильные устройства. Создавайте отдельные ресурсы, когда требуется и то, и другое.
- Push-уведомления в Интернете доступны только дляWebex Connect. Веб-приложение Safari Web Push, Webex Contact Center Web Push и Webex Contact Center Enterprise Web Push не поддерживаются.
- Авторизация JWT не поддерживается для веб-ресурсов, назначенных контакт-центру Webex или Webex Contact Center Enterprise.
- Для контакт-центров Webex и Webex Contact Center Enterprise выполните настройку точек входа, потока, виджетов и кода встраивания в разделе «Контактный центр» в Control Hub.
- Для Webex Connect этого выполните настройку сервиса и потока в. Webex Connect
- Не удаляйте ресурс чата после его сопоставления с сервисом без предварительного удаления или обновления дочернего сопоставления. Удаленный ресурс невозможно восстановить, а существующее сопоставление может стать непригодным для использования.
- После создания сохраните сгенерированный идентификатор приложения, ключ клиента и файлы конфигурации SDK, необходимые для инициализации соответствующего SDK.
