- 主页
- /
- 文章
感谢您的反馈。
在此文章中
反馈？在 Control Hub 中为 Webex Connect、Webex 联系中心或 Webex 联络中心企业版创建和配置聊天数字资产。
概述
在 Control Hub 中使用 Digital Channels 为 Web（实时聊天）、移动（应用程序内消息）和推送通知创建和配置聊天资产。 可供配置的设置取决于在 “分配给” 中选择的服务，以及是否选择 Web、Mobile 或两者兼而有之。
本文介绍了完整的资产配置流程，包括支持的功能、消息、推送提供商证书、JSON Web 令牌 (JWT) 授权、JSON 网络密钥 (JWK)、传输协议、多用户注册以及创建资产后的特定服务配置。
支持的功能
| 功能 | Webex Connect | Webex Contact Center | Webex 联络中心企业版 |
|---|---|---|---|
| 网络即时聊天 | 支持 | 支持 | 支持 |
| 移动应用程序内消息 | 支持 | 支持 | 支持 |
| Web 和移动设备合二为一 | 支持 | 不支持 | 不支持 |
| 移动-安卓推送通知 | 支持 | 支持 | 支持 |
| 移动-iOS 推送通知 | 支持 | 支持 | 支持 |
| 网络推送通知 | 支持（浏览器和火狐浏览器） | 不支持 | 不支持 |
| JWT-移动版 | 支持 | 支持且是必需的 | 支持且是必需的 |
| JWT-Web | 支持 | 不支持 | 不支持 |
| 多用户注册 | 支持 | 支持 | 支持 |
| 服务器端收件箱 | 支持 | 不适用 | 不适用 |
| 数据流 | 支持 | 不适用 | 不适用 |
准备工作
- 以可以 管理数字资产的正式管理员或联络中心管理员身份登录 Control H ub。
- 确保为Webex Connect组织提供数字服务、Webex 联络中心或 企业联络中心。 没有授权，数字资产就 不可用。
- 确定将接收新聊天 对话的联络中心入口点和流程。
- 如果部署使用移动推送通知，请准备所选平台所需的 Firebase、华为或 Apple 凭证。
- 如果您计划使用 JWT 授权，请准备用于验证可信后端颁发的令牌的公共 JWK。
配置聊天资产
要配置聊天资产，请执行以下操作：
| 1 | |
| 2 |
转至 “服务” > “数字资产”。 |
| 3 |
选择 “创建资产”。 |
| 4 |
在配置资产详细信息中，输入以下值：
|
| 5 |
在 “消息” 中，选择平台并配置实时聊天/应用程序内消息和所有必需的推送通知。 显示的选项取决于所选平台。 选择 “手机” 后，安卓和 iOS 通知设置可用。 当为分配给的资产选择了 Web 时，Web 推送可用Webex Connect。 |
配置消息
在消息传送中，选择平台并配置资产的消息传递功能。
要配置消息，请执行以下操作：
主要和次要传输协议必须不同。 如果 SDK 无法使用主协议建立连接，则会使用辅助协议作为备用协议。
| 1 |
平台：对于Webex Connect，选择 Web、移动设备或两者。 对于移动设备，选择安卓、iOS 或两者兼而有之。 对于 Webex 联络中心或 Webex 联络中心企业版，选择 Web 或 Mobile。 |
| 2 |
在线聊天/应用程序内消息：对于Webex Connect，它可用于网络和移动设备。 对于 Webex 联络中心或 Webex 联络中心企业版，Web 提供实时聊天，移动设备提供应用程序内消息。 |
| 3 |
主要传输协议：选择 MQTT 或 Web 套接字。 |
| 4 |
辅助传输协议：选择未被选为主协议。 |
配置推送通知
当应用程序必须通过配置的推送提供商接收通知时，启用 “允许推送通知”。 显示的通知部分取决于所选平台。
以下推送提供商选项可用：
- 安卓：Firebase 云消息 (FCM)、华为，或两者兼而有之。 适用于 Webex Connect Webex 联络中心和 Webex 联络中心企业版。
- iOS：FCM、苹果推送通知服务 (APNS) 或 APNS 基于令牌的身份验证。 适用于 Webex Connect Webex 联络中心和 Webex 联络中心企业版。
- 网页：Firebase 云端消息。 Webex Connect仅适用于。
选择平台并在相应的主题中配置适用的提供商。
获取 Firebase 服务账号 JSON
Webex 使用 Firebase 服务账户 JSON 文件对服务器向 Firebase Cloud Messaging 发出的请求进行身份验证。 使用与您的应用程序关联的 Firebase 项目。
要获取和上传 Firebase 服务帐号 JSON，请执行以下操作：
安全：Firebase 服务账户 JSON 包含敏感凭证。 将其安全地存储，仅上传预期的 Firebase 项目的文件。
有关 Firebase Cloud Messaging 配置说明，请参阅使用 FCM HTTP v1 API 发送消息。
| 1 |
打开 Firebase 控制台，然后选择您的应用程序使用的 Firebase 项目。 |
| 2 |
打开 “项目设置” > “服务帐号”。 |
| 3 |
选择 “生成新私钥”，然后确认下载。 |
| 4 |
安全地存储下载的 JSON 文件。 该文件包含私钥证书。 |
| 5 |
在 Control Hub 中，在 Upload Fi rebase 服务账户 JSON 中上传适用的 Android、iOS 或 Web 通知配置的 JSON 文件。 |
配置 Android 推送通知
当选择 “移动”、“安卓设备” 和 “允许推送 通知” 时，将显示 Android 通知部分。 至少选择一个提供商；Firebase 和华为可以单独 配置，也可以一起配置。 此配置适用于 Webex Connect Webex 联络中心和 Webex 联络中心企业移动资产。
提供商文档：华为-Push Kit 设置和测试
| 1 |
选择 “手机”、“Android” 和 “允许推送通知”。 屏幕上会显示安卓通知部分 。 |
| 2 |
选择 Firebase Cloud Messaging，然后从 Firebase 项目上传所需的 Firebase 服务账户 JSON 文件。 |
| 3 |
如果应用程序支持使用华为移动服务的设备，请选择华为并输入 来自AppGallery Connect的应用程序内ID和应用程序内密钥。 华为例外：当应用不 支持没有 Google Play 服务的设备时，可以跳过华为配置。 当前Webex Connect指南支持 EMUI 10.x 及更高版本。 |
配置 iOS 推送通知
选择 “移动”、“iOS” 和 “允许推送通知 ” 时，将显示 iOS 通知部分。 选择一个推送提供商。 此配置适用于 Webex Connect Webex 联络中心和 Webex 联络中心企业移动资产。
有关基于证书的 APNs 配置说明，请参阅建立基于证书的 APNs 连接。
有关基于令牌的 APNs 配置说明，请参阅建立基于令牌的 APNs 连接。
| 1 |
选择 “移动”、“iOS” 和 “允许推送通知”。 屏幕上将 显示 iOS 通知部分。 |
| 2 |
选择一个推送提供商。 |
| 3 |
对于 Firebase Cloud Messaging，请上传 从 Firebase 项目下载的 Firebase 服务账户 JSON 文件。 |
| 4 |
对于 Apple 推送通知服务 (APNS)，输入证书密码，选择 沙盒或正式版，上传 APNS 证书，输入名称并验证配置。 仅支持 .p12 证书格式。 |
| 5 |
对于基于令牌的 APNS 身份验证，请输入密钥 ID、团队 ID 和应用程序包或 套装 ID，选择沙盒或生产版，然后上传 APNS 私钥文件。 网关选择：对开发应用程序使用沙盒，将生产就 绪应用程序使用生产。 安全地存储 APNS 私钥；Apple 只允许检索 下载的 .p8 密钥文件一次。 |
| 6 |
在 Apple 提供商证书到期之前将其更换，以避免推送中断。 |
配置 Web 推送通知
Web 推送通知仅适用于选择了 Web 时分配给Webex Connect的资产。 支持 Chrome 和 Firefox。 目前不支持 Safari 网络推送。
分配给 Webex 联络中心或 Webex 联络中心企业版的资产不支持 Web 推送通知。
要配置 Web 推送通知，请执行以下操作：
| 1 |
确认资产已分配给Webex Connect且已选择 Web。 |
| 2 |
使用 Chrome 或 Firefox 访问该网站并接收网络推送通知。 |
| 3 |
网站 URL（必填）：输入将接收 Web 推送通知的网站的 URL。 |
| 4 |
通知图标（必填）：输入通知图标的路径。 该图标必须为 80 x 80 像素。 |
| 5 |
按照Firebase文档为您的网络应用程序配置Fi reb ase云消息（FCM）。 |
| 6 |
Firebase 服务账户 JSON（必填）：上传包含使用 Firebase Cloud Messaging HTTP v1 API 所需的私钥的 Firebase 服务账户 JSON 文件。 |
配置 JSON Web 令牌授权
JWT 授权要求使用有效的 JSON Web 令牌对 SDK 通信进行授权。 对于新资产，加密类型为非对称。
JWT 支持如下所示：
- Webex Connect：在同一资产中支持移动设备和 Web。
- Webex 联络中心和 Webex 联络中心企业版-Web：不支持。
- Webex 联络中心和 Webex 联络中心企业版-移动版：移动资产配置支持和必需。
配置以下设置：
- 加密类型：新资产的非对称。
- 令牌到期（必填）：输入在需要新的用户身份令牌之前，JWT 的有效期限。 有效范围：5-360 分钟。 默认值：60 分钟。
- JSON 网络密钥（必填）：上传用于验证令牌的公共 JWK。 您可以添加第二个密钥进行旋转。 最大：两把钥匙。
按照子主题中的说明添加和准备公共 JSON Web 密钥。
让公众做好准备 JWK
上传的文件必须包含公共 RSA 验证密钥。 Webex 验证以下 JWK 属性。
JWK 属性在 RFC 7517 的第 4 节中定义。 算法特定的属性在 RF C 7518 中定义。
| 属性名称 | 描述 |
|---|---|
| alg | 识别与密钥一起使用的加密算法。 所需值为 RS256，它指定v1_5使用 SHA-256 的 RSASSA-PKCS1-。 |
| e | RSA 公钥的指数，以 base64URLuint 编码的值表示。 |
| key_ops | 指定密钥的预期操作。 支持的值为 verify，表示该密钥用于验证数字签名。 请参阅 RFC 7517，第 4.3 节。 |
| kty | 标识与密钥一起使用的加密算法系列。 该值必须为 RSA。 请参阅 RFC 7517，第 4.1 节。 |
| n | RSA 公钥的模数，以 base64URLuint 编码的值表示。 |
| 使用 | 指定公钥的预期用途。 该值必须为 sig，表示该密钥用于签名验证。 请参阅 RFC 7517，第 4.2 节。 |
| 孩子 | 识别密钥并用于匹配特定密钥，例如在密钥轮换期间。 请参阅 RFC 7517，第 4.5 节。 |
添加 JSON 网络密钥
要添加公共 JSON Web 密钥，请执行以下操作：
| 1 |
选择 “添加密钥”。 |
| 2 |
输入 JSON 网络密钥名称。 |
| 3 |
输入 JSON 网络密钥颁发者。 该值必须与可信后端在生成 JWT 时使用的发行者相匹配。 |
| 4 |
上传公共 JWK 文件。 |
| 5 |
选择保存。 |
配置多用户注册
当多个用户可以在同一台物理设备上注册时，启用 “允许多用户在同一台设备上注册”。
- 推送通知适用于活跃和非活跃的注册用户。
- 实时聊天或应用程序内消息传送给当前活跃的用户。 发送给非活动用户的消息会排队等待，直到该用户再次处于活动状态。
配置其他Webex Connect设置
- 每位用户一台设备：限制用户只能使用一台注册的设备。 在新设备上注册会停止向旧设备推送推送。
- 服务器端收件箱：存储收件箱数据的服务器端副本，以供日后检索。
- 数据流：将通过消息 API 发送的消息的适用事件数据发送到选定的Webex Connect集成。
保存以创建资产
配置相应的消息、JWT 授权、多用户注册和Webex Connect设置后，保存配置以创建 Chat 资产。
|
选择 “保存” 以创建资产。 等待确认资产已成功创建。
|
全面的服务集成
创建聊天资产后，完成分配给中所选服务的集成。 遵循 Webe Webex Connect x 联络中心或 Webex 联络中心企业版的适用程序。
完全Webex Connect集成
完成 Webex 联络中心集成
对于分配给 Webex 联系中心的资产，将该资产映射到联系中心入口点，然后完成 Webex 联系中心节点授权。
| 1 |
在 Control Hub 中打开联络中心配置。 |
| 2 |
创建或打开接收 Chat 对话的入口点。 |
| 3 |
在流程映射中，选择聊天资产和所需的客户输入流程。 |
| 4 |
保存入口点并验证资产和流程映射。 |
| 5 |
在中完成 Webex 联络中心节点授权。Webex Connect 有关说明，请参阅 Webex CC 任务集成节点和节点授权。 |
| 6 |
对于 Web 部署，请配置实时聊天小组件并在 Control Hub 中获取网站嵌入代码。 |
完成 Webex 联络中心企业版集成
对于分配给 Webex 联络中心企业版的资产，Webex Connect请在配置路由流之前在中完成 CCE 节点授权。
| 1 |
登录到Webex Connect。 |
| 2 |
完成 CCE 节点授权。 有关说明，请参阅 CCE 集成节点和节点授权。 |
| 3 |
为聊天资产配置适用的 CCE 集成节点和路由流程。 有关流程示例，请参阅流程配置。 |
| 4 |
保存并测试流程。 |
例外和限制
请记住以下例外和限制：
- 在创建资产之前，确认渠道、平台、分配和路由选择。 频道创建后无法更改，平台更改受工作负载限制。
- 对于 Webex 联络中心和 Webex 联络中心企业版来说，单一资产不能同时使用 Web 和移动设备。 当两者都需要时，创建单独的资源。
- Web 推送通知仅适用于Webex Connect。 不支持 Safari 网络推送、Webex 联系中心网络推送和 Webex 联络中心企业网络推送。
- 分配给 Webex 联络中心或 Webex 联络中心企业版的 Web 资产不支持 JWT 授权。
- 对于 Webex 联络中心和 Webex 联络中心企业版，在 Control Hub 的 “联系中心” 部分执行入口点、流程、控件和嵌入代码配置。
- 对于Webex Connect，请完成中的服务和流程配置Webex Connect。
- 如果没有先移除或更新下游映射，请勿在聊天资产映射到服务后将其删除。 已删除的资源无法恢复，并且可能使现有映射无法使用。
- 创建后，保留生成的应用程序 ID、客户端密钥和初始化相应 SDK 所需的软件开发工具包配置文件。
