在 Amazon Connect 中個人化應用程式內、網路和視訊通話的客戶體驗 - Amazon Connect
替代方法：直接從程式碼程式碼傳遞聯絡人屬性複製通訊小工具程式碼和安全金鑰

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

在 Amazon Connect 中個人化應用程式內、網路和視訊通話的客戶體驗

本主題中的步驟為可選步驟，但建議使用。讓您可以根據客戶先前在您的應用程式中的操作，個人化客戶的體驗。此選項可在啟動新通話時掌握更多控制權，包括將內容資訊作為屬性傳遞的能力。

執行這些步驟後，您需要與網站管理員合作，設定 Web 伺服器以發出 JSON Web 權杖 （JWTs） 進行新呼叫

  1. 如果您已經建立通訊小工具，請在通訊小工具頁面上選擇要編輯的小工具。

  2. 在網域和安全性區段中，選擇編輯。

  3. 在為您的通訊小工具要求新增安全性下，選擇是。

    「是」選項。

  4. 選擇儲存並繼續。Amazon Connect 建立小工具以及以下內容：

    • Amazon Connect 在下一頁提供 44 個字元的安全金鑰，可用來建立 JWTs。

    • Amazon Connect 在通訊小工具內嵌指令碼中新增回呼函數，可在啟動呼叫JWT時檢查 。

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

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

    在下一步中，您將取得您的網站上啟動的所有通話的安全金鑰。請您的網站管理員設定您的 Web 伺服器，以JWTs使用此安全金鑰進行發行。

  5. 選擇儲存並繼續。

  6. 複製自訂HTML程式碼片段，並將其插入網站的原始程式碼。

替代方法：直接從程式碼程式碼傳遞聯絡人屬性

注意

雖然這些屬性的範圍與HostedWidget-字首相同，但它們仍然是可變的用戶端站台。如果您需要聯絡人流程中的不可變資料PII，請使用 JWT設定。

下列範例示範如何直接從程式碼片段程式碼傳遞聯絡人屬性，而不啟用小工具安全性。

<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', 'widgetId');
  amazon_connect('snippetId', 'snippetId');
  amazon_connect('styles', /* ... */);
  // ...
  
  amazon_connect('contactAttributes', {
   foo: 'bar'
  })
<script/>

在聯絡流程中使用 屬性

檢查聯絡人屬性流程區塊透過使用者定義的命名空間提供對這些屬性的存取，如下圖所示。您可以使用流程區塊來新增分支邏輯。完整路徑為 $Attribute.HostedWidget-attributeName。

顯示流程區塊分支為有效和無效提示的圖片。

複製通訊小工具程式碼和安全金鑰

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

安全金鑰

使用此 44 個字元的安全金鑰，從您的 JSON Web 伺服器產生 Web 權杖。如果您需要變更這些金鑰，也可以將其更新或輪換。當您執行此操作時，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 分鐘)。

    * 如需日期格式的相關資訊，請參閱下列 Internet Engineering Task Force （IETF） 文件：JSONWeb Token （JWT），第 5 頁。

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

payload = {
'sub': widgetId, // don't add single quotes, such as 'widgetId'
'iat': datetime.utcnow(),
'exp': datetime.utcnow() + timedelta(seconds=JWT_EXP_DELTA_SECONDS)
}

header = {
'typ': "JWT",
'alg': 'HS256'
}

encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm=JWT_ALGORITHM, headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect

通訊小工具文字記錄

下圖顯示 JavaScript 您內嵌在您希望客戶能夠呼叫聯絡中心之網站上的 範例。此指令碼會在您的網站右下角顯示小工具。

下圖顯示在何處尋找 的範例widgetId。

通訊小工具文字記錄。

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

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

注意

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

小工具預覽上的編輯連結。

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