將聊天使用者介面新增至 Amazon Connect 託管的網站 - Amazon Connect

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

將聊天使用者介面新增至 Amazon Connect 託管的網站

若要透過聊天支援您的客戶,您可以將通訊小工具新增至 Amazon Connect 託管的網站。您可以在 Amazon Connect 管理網站中設定通訊小工具。您可以自訂字型和顏色,並保護小工具,以便只能從網站啟動。完成後,您會有一個簡短的程式碼片段,並新增至您的網站。

由於 Amazon Connect 會託管小工具,因此可以確保最新版本始終存在於您的網站上。

提示

通訊小工具的使用取決於預設 Service Quotas,例如每個訊息所需的字符數。將通訊小工具啟動到生產環境之前,請確定已針對組織的需求設定 Service Quotas。如需詳細資訊,請參閱Amazon Connect 服務配額

支援的瀏覽器

預先構建的通訊小工具支持以下瀏覽器版本和更高版本:

  • Google Chrome 85.0

  • Safari 13.1

  • Microsoft Edge 版本 85

  • Mozilla Firefox 81.0

通訊小工具支援桌面裝置的瀏覽器通知。如需詳細資訊,請參閱在聊天訊息到達時傳送瀏覽器通知給客戶

步驟 1:自訂通訊小工具

在此步驟中,您可以為客戶自訂通訊小工具的體驗。

  1. 登入 Amazon Connect 管理網站https://instance name.my.connect.aws/。選擇自訂通訊小工具

    組態指南頁面,自訂通訊小工具連結。
  2. 通訊小工具頁面上,選擇新增通訊小工具,開始自訂新的通訊小工具體驗。若要編輯、刪除或複製現有的通訊小工具,請從動作欄下方的選項中進行選擇,如下圖所示。

    通訊小工具頁面,新增通訊視窗小工具按鈕連結。
  3. 輸入聊天小工具的名稱描述

    注意

    對於在 Amazon Connect 執行個體中建立的每個通訊小工具,名稱必須是唯一的。

  4. 通訊選項區段中,選擇客戶如何與您的小工具互動,然後選擇儲存並繼續。下圖顯示允許客戶聊天和訊息收據的選項。

    為聊天和網絡呼叫設定的通訊小工具頁面。
  5. 建立通訊小工具頁面上,選擇小工具按鈕樣式,並顯示名稱和樣式。

    當您選擇這些選項時,小工具預覽會自動更新,讓您可以了解客戶的體驗。

    通訊小工具的預覽。
按鈕樣式
  1. 輸入十六進位值 ( 顏色HTML代碼 ),選擇按鈕背景的顏色

  2. 選擇白色黑色作為圖示顏色。無法自訂圖示顏色。

小工具標頭
  1. 提供標題訊息和顏色,以及小工具背景顏色的值。

  2. 標誌 URL:從 Amazon S3 儲存貯體或其他線上來源將 URL插入您的標誌橫幅。

    注意

    如果自訂頁面中的通訊小工具預覽來自 Amazon S3 儲存貯體以外的線上來源,則不會顯示標誌。但是,當自訂通訊小工具實作到您的頁面時,將顯示標誌。

    橫幅必須是 .jpg 或 .png 格式。影像可以是 280 像素 (寬度) 乘 60 像素 (高度)。任何大於這些尺寸的影像都會縮放,以符合 280x60 標誌元件空間。

    1. 如需如何將標誌橫幅等檔案上傳到 S3 的指示,請參閱 Amazon Simple Storage Service 使用者指南中的上傳物件

    2. 確認影像權限已正確設定,讓通訊小工具擁有存取影像的許可。如需如何讓 S3 物件可公開存取的詳細資訊,請參閱設定網站存取許可主題中的步驟 2:新增儲存貯體政策

聊天視圖
  1. Typeface:請使用下拉式清單選擇通訊小工具的文字字型。

    • 系統訊息顯示名稱:輸入新的顯示名稱以覆寫預設值。預設值為 SYSTEM_MESSAGE

    • 機器人訊息顯示名稱:輸入新的顯示名稱以覆寫預設值。預設值為 BOT

    • 文字輸入預留位置:鍵入新預留位置文字以覆寫預設值。預設值是 輸入訊息

    • 結束聊天按鈕文字:輸入新文字以取代預設值。預設值是 結束聊天

  2. 客服人員聊天泡泡顏色 :輸入十六進位值 ( 顏色HTML代碼 ),選擇客服人員訊息泡泡的顏色

  3. 客戶聊天泡泡顏色 :輸入十六進位值 ( 顏色HTML代碼 ),選擇客戶訊息泡泡的顏色

  4. 選擇儲存並繼續

步驟 2:指定您希望顯示通訊小工具的網站網域

  1. 輸入您要放置通訊小工具的網站網域。聊天室只會載入您在此步驟中選擇的網站。

    選擇 新增網域,最多可以新增 50 個網域。

    新增網域選項。
    重要
    • 再次檢查您的網站URLs是否有效,且不包含錯誤。包含從 https://. URL開始的完整

    • 我們建議您在生產環境網站和應用程式中使用 https://。

  2. 為您的通訊小工具 新增安全性 下,我們建議您選擇,並與您的網站管理員合作設定 Web 伺服器,為新的聊天請求發出 JSON Web 權杖 (JWTs)。這可讓您在啟動新聊天時提供更多控制權,包括確認傳送至 Amazon Connect 的聊天請求是否來自經過驗證的使用者。

    啟用新通訊小工具請求的安全性。

    選擇 會產生下列情況:

    • Amazon Connect 在下一頁提供 44 個字元的安全金鑰,可用來建立 JSON Web 權杖 (JWTs)。

    • Amazon Connect 在通訊小工具內嵌指令碼中新增回呼函數,可在啟動聊天時檢查 JSON Web 權杖 (JWT)。

      您必須在內嵌程式碼片段中實作回呼函數,如下列範例所示。

      amazon_connect('authenticate', function(callback) { window.fetch('/token').then(res => { res.json().then(data => { callback(data.data); }); }); });

    如果您選擇此選項,則在下一步中,您將獲得在網站上發起的所有聊天請求的安全密鑰。請您的網站管理員設定您的 Web 伺服器,以JWTs使用此安全金鑰進行發行。

  3. 選擇 Save (儲存)。

步驟 3:確認並複製通訊小工具程式碼和安全密鑰

在此步驟中,您將確認您的選擇,複製通訊小工具的程式碼,並將其嵌入您的網站中。如果您選擇JWTs在步驟 2 中使用 ,您也可以複製要建立秘密金鑰。

安全金鑰

使用此 44 個字元的安全金鑰,從您的 JSON Web 伺服器產生 Web 權杖。如果您需要變更這些金鑰,也可以將其更新或輪換。當您執行此操作時,Amazon Connect 會為您提供新的金鑰,並保留先前的金鑰,直到您有機會更換為止。部署新金鑰後,您可以返回 Amazon Connect 並刪除先前的金鑰。

Amazon Connect 提供的安全金鑰。

當您的客戶與網站上的開始聊天圖示互動時,通訊小工具會請求您的 Web 伺服器使用 JWT。JWT 提供此功能時,小工具會將其包含在終端客戶對 Amazon Connect 的聊天請求中。然後,Amazon Connect 使用該密鑰解密權杖。如果成功,這將確認 JWT 是由您的 Web 伺服器發出,而 Amazon Connect 會將聊天請求路由給您的聯絡中心客服人員。

JSON Web 權杖詳細資訊

  • 演算法: HS256

  • 宣告:

    • widgetId

      widgetId 以您自己的 取代 widgetId。若要尋找您的 widgetId,請參閱 的範例通訊小工具文字記錄

    • iat:*發行時間。

    • exp:*有效期限 (最多 10 分鐘)。

    • segmentAttributes (選用):一組系統定義的鍵值對,使用屬性映射存放在個別聯絡區段上。如需詳細資訊,請參閱 SegmentAttributes 中的 StartChatContact API。

    • 屬性 (選用):具有 string-to-string鍵值對的物件。聯絡人屬性必須遵循 StartChatContact 設定的限制API。

    * 如需日期格式的相關資訊,請參閱下列 Internet Engineering Task Force (IETF) 文件:JSONWeb Token (JWT),第 5 頁。

下列程式碼片段顯示如何在 Python JWT中產生 的範例:

import jwt import datetime CONNECT_SECRET = "your-securely-stored-jwt-secret" WIDGET_ID = "widget-id" JWT_EXP_DELTA_SECONDS = 500 payload = { 'sub': WIDGET_ID, 'iat': datetime.datetime.utcnow(), 'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=JWT_EXP_DELTA_SECONDS), 'segmentAttributes': {"connect:Subtype": {"ValueString" : "connect:Guide"}}, 'attributes': {"name": "Jane", "memberID": "123456789", "email": "Jane@example.com", "isPremiumUser": "true", "age": "45"} } header = { 'typ': "JWT", 'alg': 'HS256' } encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect

通訊小工具文字記錄

下圖顯示 JavaScript 您內嵌在您希望客戶與客服人員聊天之網站上的 範例。此指令碼會在您的網站右下角顯示小工具。

通訊小工具文字記錄。

當您的網站載入時,客戶會先看到開始圖示。當他們選擇此圖示時,通訊小工具將開啟,客戶可以向您的客服人員發送訊息。

若要隨時變更通訊小工具,請選擇編輯

注意

儲存的變更會在幾分鐘內更新客戶體驗。在保存之前確認您的小工具組態。

他在視窗小工具預覽上編輯連接。

要更改網站上的小工具圖示,您將收到一個新的程式碼片段,以直接更新您的網站。

收到錯誤訊息?

如果您發生錯誤訊息,請參閱 將聊天使用者介面新增至 Amazon Connect 網站

更多通訊小工具的自訂選項

如需進一步了解如何自訂聊天體驗,請參閱下列主題: