- 首頁
- /
- 文章
在 Webex Connect、Webex 聯絡中心或 Webex 聯絡中心企業中心中建立和設定「控制中心」中的聊天數位資產。
概覽
使用 Control Hub 中的數位通道來建立和設定 Web (即時聊天)、行動裝置 (應用內訊息) 和推送通知的聊天資產。 可用於組態的設定取決於在「指派給」中選取的服務,以及您是否選取「Web」、「行動裝置」還是兩者。
本文說明完整的資產組態程序,包括建立資產後支援的功能、通訊、推送提供者認證、JSON Web Token (JWT) 授權、JSON Web 金鑰 (JWK)、傳輸通訊協定、多使用者註冊以及特定服務的組態。
支援的功能
| 功能 | Webex Connect | Webex Contact Center | Webex 企業聯絡中心 |
|---|---|---|---|
| 網路線上聊天 | 支援 | 支援 | 支援 |
| 行動應用程式內訊息 | 支援 | 支援 | 支援 |
| 網頁和行動裝置在單一資產中 | 支援 | 不支援 | 不支援 |
| 手機-安卓推送通知 | 支援 | 支援 | 支援 |
| 行動裝置-iOS 推送通知 | 支援 | 支援 | 支援 |
| 網路推送通知 | 支持(瀏覽器和 Firefox) | 不支援 | 不支援 |
| JWT-手機 | 支援 | 支持和必要 | 支持和必要 |
| JWT-網站 | 支援 | 不支援 | 不支援 |
| 多用戶註冊 | 支援 | 支援 | 支援 |
| 伺服器端收件匣 | 支援 | 不適用 | 不適用 |
| 資料串流 | 支援 | 不適用 | 不適用 |
在開始之前
- 以可管理數位資產的完整管理員或聯絡中心管理員身 分登入 Control Hub。
- 確定已Webex Connect為組織佈建數位服務、Webex 聯絡中心或聯絡中心 企業。 如果沒有權利,數位資產就 無法使用。
- 識別接收新聊天對話的聯絡中心入口點和流 程。
- 如果部署使用移動推送通知,請準備所選平台所需的 Firebase,華為或 Apple 認證。
- 如果您打算使用 JWT 授權,請準備用於驗證受信任後端發行的代幣的公開 JWK。
設定聊天資產
若要設定聊天資產:
| 1 | |
| 2 |
前往「服務」 >「數位資產」。 |
| 3 |
選取「建立資產」。 |
| 4 |
在設定資產詳細資訊中,輸入下列值:
|
| 5 |
在「訊息」中,選擇平台並設定即時聊天/應用內通訊以及所有必要的推送通知。 顯示的選項取決於所選平台。 選擇手機時,Android 和 iOS 通知設置可以使用。 如果為指定的資產選取 Web,則可以使用 Web 推送Webex Connect。 |
設定訊息
在訊息中,選取平台並設定資產的通訊功能。
若要設定訊息:
主要和次要傳輸協議必須不同。 如果 SDK 無法使用主要通訊協定建立連線,則會使用次要通訊協定作為備援。
| 1 |
平台:選取「網Webex Connect頁」、「行動裝置」或「兩者」。 對於行動裝置,請選擇 Android、iOS 或兩者。 對於 Webex 聯絡中心或 Webex 聯絡中心企業,選取 Web 或行動裝置。 |
| 2 |
實時聊天/應用內消息:對於Webex Connect,它適用於 Web 和移動設備。 對於 Webex 聯絡中心或 Webex 聯絡中心企業,Web 提供即時聊天,而行動裝置提供應用程式內訊息。 |
| 3 |
主要傳輸通訊協定:選取 MQTT 或 Web 通訊端。 |
| 4 |
次要傳輸通訊協定:選取未選取為主要的通訊協定。 |
設定推送通知
當應用程式必須透過設定的推送提供者接收通知時,啟用允許推送通知。 顯示的通知區段取決於所選平台。
下列推送提供者選項可用:
- 安卓:Firebase 雲消息傳遞(FCM),華為,或兩者都。 適用於 Webex Connect Webex 聯絡中心和 Webex 聯絡中心企業。
- iOS:FCM、蘋果推送通知服務 (APNS) 或基於 APNS 的令牌驗證。 適用於 Webex Connect Webex 聯絡中心和 Webex 聯絡中心企業。
- 網絡:火焰基地雲消息傳遞。 僅適用Webex Connect於。
選取平台並在相應主題中設定適用的提供者。
獲取消防基地服務帳戶 JSON
Webex 使用 Firebase 服務帳戶 JSON 文件來驗證對 Firebase 雲端消息傳遞的服務器請求。 使用與您的應用程序關聯的 Firebase 項目。
要獲取和上傳 Firebase 服務帳戶 JSON:
安全性:Firebase 服務帳戶 JSON 包含敏感認證。 安全地存儲它,並僅上傳適用於預期 Firebase 項目的文件。
有關 Firebase 雲消息傳遞配置說明,請參閱使用 FCM HTTP v1 API 發送消息。
| 1 |
打開 Firebase 控制台,然後選擇您的應用程序使用的 Firebase 項目。 |
| 2 |
開啟「專案設定」 >「服務帳戶」。 |
| 3 |
選取 [產生新私密金鑰],然後確認下載。 |
| 4 |
安全地存儲下載的 JSON 文件。 該檔案包含私密金鑰認證。 |
| 5 |
在控制中心中,在上傳 Firebase 服務帳戶 JSON 中上傳 JSON 文件,以適用於適用的 Android,iOS 或 Web 通知配置。 |
設定安卓推送通知
選取「行動裝置」、「安卓系統」和「允許推送通知」時,系統會顯示 Android 通知部分。 至少選擇一個提供商;Firebase 和華為可以單獨或 一起配置。 此組態適用於 Webex Connect Webex 聯絡中心和 Webex 聯絡中心企業行動資產。
提供商文檔:華為-推送套件設置和測試
| 1 |
選取「行動裝置」、「Android」和「允許推送通知」。 顯示 Android 通知 部分。 |
| 2 |
選擇 Firebase 雲消息傳遞並從 Firebase 項目上傳所需的 Firebase 服務帳戶 JSON 文件。 |
| 3 |
如果該應用程序支持使用華為移動服務的設備,請選擇華為,然後從 AppGallery Connect 輸入 應用程序內 ID 和應用內密碼。 華為例外:當該應用程序不 支持沒有 Google Play 服務的設備時,可以跳過華為配置。 目前的Webex Connect指南支持 EMUI 10.x 及更高版本。 |
設定 iOS 推送通知
選取「行動裝置」、「iOS」和「允許推送通知」時,系統會顯示 iOS 通知 區段。 選擇一個推送提供者。 此組態適用於 Webex Connect Webex 聯絡中心和 Webex 聯絡中心企業行動資產。
如需以憑證為基礎的 APN 組態指示,請參閱建立與 APN 以憑證為基礎的連線。
如需基於令牌的 APN 組態指示,請參閱建立基於令牌的連線至 APN。
| 1 |
選取「行動裝置」、「iOS」和「允許推送通知」。 會 顯示 iOS 通知區段。 |
| 2 |
選擇一個推送提供者。 |
| 3 |
對於 Firebase 雲消息,請上傳從 Firebase 項目下載的 Firebase 服務帳戶 JSON 文件。 |
| 4 |
對於 Apple 推送通知服務 (APNS),輸入憑證密碼,選擇 沙箱或生產,上傳 APNS 憑證,輸入名稱,然後驗證組態。 只支援 .p12 憑證格式。 |
| 5 |
對於基於令牌的 APNS 驗證,請輸入金鑰 ID、團隊 ID 和應用程式套件或套件 ID,選取沙箱或製作,然後上傳 APNS 私密金鑰檔案。 閘道選擇:使用沙箱作為開發應用程式,並使用「製作」可供生 產的應用程式。 安全地儲存 APNS 私密金鑰;Apple 僅允許擷 取下載的 .p8 金鑰檔案一次。 |
| 6 |
在到期前更換 Apple 供應商憑證,以避免推送中斷。 |
設定 Web 推送通知
Web 推送通知僅適用於指定給已選取 Web Webex Connect 的資產。 支援瀏覽器和火狐瀏覽器。 目前不支援 Safari 網頁推送服務。
指派給 Webex 聯絡中心或 Webex 聯絡中心企業的資產不支援 Web 推送通知。
若要設定 Web 推送通知:
| 1 |
確認已指定資產,並Webex Connect且已選取「Web」。 |
| 2 |
使用 Chrome 或 Firefox 訪問網站並接收網絡推送通知。 |
| 3 |
網站 URL(必填):輸入將接收 Web 推送通知的網站的網址。 |
| 4 |
通知圖示(必填):輸入通知圖示的路徑。 圖示必須為 80 x 80 像素。 |
| 5 |
通過按照 Firebase 文檔來為您的 Web 應用程序配置 Fire base 雲端消息傳遞(FCM)。 |
| 6 |
Firebase 服務帳戶 JSON(必填):上傳包含使用 Firebase 雲端消息傳遞 HTTP v1 API 所需的私密金鑰的 Firebase 服務帳戶 JSON 文件。 |
設定 JSON Web 令牌授權
JWT 授權需要使用有效的 JSON Web 令牌授權 SDK 通信。 對於新資產,加密類型為非對稱。
JWT 支持如下:
- Webex Connect:支援同一資產中的行動裝置和 Web。
- Webex 聯絡中心和 Webex 聯絡中心企業版-網頁:不支援。
- Webex 聯絡中心和 Webex 聯絡中心企業版-行動裝置:支援行動資產組態並需要。
請設定下列設定:
- 加密類型:對於新資產的非對稱。
- 令牌到期(必填):輸入 JWT 在需要新的用戶身份令牌之前保持有效的時間。 有效範圍:5-360 分鐘。 預設值:60 分鐘。
- JSON 網絡密鑰(必填):上傳用於驗證令牌的公開 JWK。 您可以新增第二個鍵進行旋轉。 最大:兩個按鍵。
如子主題中所述,新增並準備公用 JSON Web 金鑰。
準備公眾 JWK
上傳的檔案必須包含公開 RSA 驗證金鑰。 Webex 會驗證下列 JWK 屬性。
JWK 屬性在 RFC 7517 第 4 節中定義。 在 RFC 7518 中定義了演算法特定的屬性。
| 屬性名稱 | 說明 |
|---|---|
| 藻類 | 識別與金鑰一起使用的加密演算法。 所需值為 RS256,它指定使用 SHA-256 的 RSASSA-PKCS1。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 |
選取儲存。 |
設定多使用者註冊
當多個用戶可以在同一實體裝置上註冊時,啟用允許多使用者在同一裝置上註冊。
- 推送通知會針對活動和非活動的註冊用戶提供。
- 即時聊天或應用內消息傳遞給當前活躍的用戶。 非使用中使用者的訊息會排入佇列,直到使用者再次啟動為止。
設定其他 Webex Connect 設定
- 每位使用者單一裝置:將使用者限制在一個註冊裝置上。 在新裝置上註冊會停止推送傳送到舊裝置。
- 伺服器端收件匣:儲存收件匣資料的伺服器端副本,以供稍後擷取。
- 資料串流:針對透過訊息 API 傳送的郵件,Webex Connect將適用的事件資料傳送至所選整合。
儲存以建立資產
設定適用的訊息、JWT 授權、多使用者註冊和Webex Connect設定之後,請儲存組態以建立聊天資產。
|
選取「儲存」以建立資產。 等待確認已成功建立資產。
|
完整的服務整合
建立聊天資產後,請完成在指派至中選取的服務的整合。 遵循 Webex 聯絡中心或 Webex 企業聯絡中心的適用程序。Webex Connect
完整的 Webex Connect 整合
完整的 Webex 聯絡中心整合
對於指定給 Webex 聯絡中心的資產,請將資產對應至聯絡中心入口點,然後完成 Webex 聯絡中心節點授權。
| 1 |
在「控制中心」中開啟「聯絡中心」組態。 |
| 2 |
建立或開啟接收聊天對話的入口點。 |
| 3 |
在流程對映中,選取聊天資產和所需的客戶輸入流程。 |
| 4 |
儲存入點並驗證資產與流程對映。 |
| 5 |
完成 Webex 聯絡中心節點授權。Webex Connect 如需指示,請參閱 Webex CC 工作整合節點和節點授權。 |
| 6 |
對於 Web 部署,請設定即時聊天小工具,並在 Control Hub 中取得網站嵌入程式碼。 |
完整的 Webex 聯絡中心企業整合
對於指定給 Webex 聯絡中心企業的資產,請先完成 CCE 節點授權,然後Webex Connect再設定路由流程。
| 1 |
登入Webex Connect。 |
| 2 |
完成 CCE 節點授權。 如需指示,請參閱 CCE 整合節點和節點授權。 |
| 3 |
為聊天資產設定適用的 CCE 整合節點和路由流程。 如需流程範例,請參閱流程組態。 |
| 4 |
儲存並測試流程。 |
例外情況和限制
請記住以下例外和限制:
- 在建立資產之前,請確認通道、平台、指派和路由選擇。 創建後無法變更頻道,平台變更受工作負載限制。
- 對於 Webex 聯絡中心和 Webex 聯絡中心企業,單一資產無法同時使用 Web 和行動裝置。 當兩者都需要時,建立單獨的資產。
- Web 推送通知僅適用於Webex Connect。 不支援 Safari 網頁推送、Webex 聯絡中心網頁推送和 Webex 聯絡中心企業網頁推送。
- 指派給 Webex 聯絡中心或 Webex 聯絡中心企業的 Web 資產不支援 JWT 授權。
- 對於 Webex 聯絡中心和 Webex 聯絡中心企業,請在控制中心的「聯絡中心」區段中執行輸入點、流程、小工具和嵌入程式碼組態。
- 為了Webex Connect,在中完成服務和流程配置Webex Connect。
- 在對應到服務之後,請勿刪除聊天資產,但不要先移除或更新下游對應。 刪除的資產無法恢復,並且可以使現有的映射無法使用。
- 建立後,保留初始化適當 SDK 所需的產生的 App ID、用戶端金鑰和 SDK 組態檔。