GETRICHMESSAGE

向數位 AskCaller 動作或TExtMsg 動作傳遞豐訊息 JSON。這將允許您在指令碼中使用在 ACD 中在聯絡點頁面中建立的富訊息範本，而不是在指令碼中構建 JSON。

相依性

• 此動作需要 Digital Experience。
• 在使用數位指令碼之前，了解傳統 ACD 指令碼和數位指令碼之間的差異。
• 必須與下列動作之一配合使用：AskCaller或 TExtMsg。
• 在指令碼中將 GETRICHMESSAGE 放在 AskCaller 或 TExtMsg 之前。

• 對富訊息內容類別的支援因通道而異，如以下下拉式清單所示。

  了解更多

  下表顯示了每個數位通道可用的富內容 數位訊息中的元素，如按鈕、圖片、選單和選項選擇器。的類型。一些富內容使用 TORM（真正的全通道富訊息傳遞），並且可以在 富訊息設定下進行設定。TORM 不支援的任何富內容都可以在聊天、電郵、Apple Messages for Business和WhatsApp下進行設定。

  未列出的通道目前還不支援富內容。透過其他通道傳送的任何富內容都以純文字形式傳遞。

  	自適應卡	HTML & Markdown 文字	富連結	快速回覆	清單選取器	時間選取器	表單訊息
  Apple Messages for Business
  數位 聊天
  電郵				使用遞補文字
  Facebook Messenger
  WhatsApp
  Google Business Messages

  支援：

  不支援：

  這些富內容可供 API、機器人、虛擬客服專員和真人客服專員使用。然而，並非所有富內容都支援由真人客服專員使用。下表顯示了MAX中的客戶卡部分中真人客服專員可以看到的富內容。真人客服專員可以在訊息範本 > 選擇範本下存取 TORM 不支援的富內容。真人客服專員可以在富訊息 > 富訊息下存取 TORM 支援的富內容。

  	自適應卡	HTML & Markdown 文字	富連結	快速回覆	清單選取器	時間選取器	表單訊息
  Apple Messages for Business
  數位 聊天
  電郵
  Facebook Messenger
  WhatsApp
  Google Business Messages

  支援：

  不支援：

• 建立豐訊息範本，以在 CXone 中的「數位聯絡點」頁面上用於此動作。您可以為清單選擇器、時間選擇器、富連結和快速回覆建立範本。如果需要使用其他富媒體，則不能使用 GETRICHMESSAGE。相反，您必須在Snippet 動作中構建 JSON 並將其直接傳遞給 AskCaller 或 TExtMsg。有關詳細資訊，請參閱這些動作的線上說明中的「相依性」部分。

支援的指令碼類型

數位

類似動作比較

以下動作有類似的功能，但有一些關鍵區別：

• AskCaller：透過基於數位聊天的通道向聯絡人要求資訊。可以顯示富訊息傳遞 數位訊息中的元素，如按鈕、圖片、選單和選項選擇器。內容。
• GetRichMessage：從 CXone 中的通道配置中檢索富訊息傳遞範本。
• Textmsg：向聯絡人傳送基於文字的訊息。可以顯示富訊息傳遞內容。

輸入屬性

這些屬性定義了動作執行時使用的資料。

屬性	描述
新增 標題	輸入在指令碼中唯一標識此操作的短語。標題出現在指令碼畫布上的動作圖示下。
channelID	選擇此指令碼用於傳送訊息的數位通道。

輸出屬性

這些屬性包含變數，用於儲存執行動作後返回的資料。當動作完成後，它們可供參考和使用。

屬性	描述
resultSet	保留從 CXone 返回的 JSON。將此變數的內容作為 JSON 字串傳遞給 Askcaller 或 TExtmsg。

結果分支條件

結果分支條件允許您在指令碼中建立分支，以處理執行動作時的不同結果。

條件	描述
Default	指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。如果沒有定義動作的其他分支，也會採用該路徑。
錯誤	動作未能正確執行時採用的路徑。例如，當出現連接不良、語法錯誤等意外問題時。_ERR變數（帶有一個下畫線字元）應填入針對問題的簡要說明。
成功	動作完成且無錯誤而且任何 API 調用或資料返回均成功時採用的路徑（2xx 回應代碼）。

所需的 SNIPPET 動作代碼

此動作可能需要Snippet動作以及用於處理 GETRICHMESSAGE 動作從數位聯絡點傳回的富媒體範本的程式碼。如果聯絡點只有一個範本，則不需要 snippet 程式碼。您可以使用 Result Set 屬性中指定的變數。對於具有多個範本的聯絡點，則需要 snippet 程式碼。

1. 在ACD 應用程式的「數位聯絡點」頁面上建立範本，並將其指派給要使用此範本的聯絡人。您可能需要 CXone 管理員的協助才能完成此步驟。

2. 使用數位媒體類型建立指令碼。

3. 新增GETRICHMESSAGE動作和 ASKCALLER 動作或TeXTMSG動作。如果聯絡人有多個範本，您還需要一個SNIPPET 動作。
4. 使用獲得範本指派的聯絡點來配置 GETRICHMESSAGE 中的 ChannelId 屬性。
5. 將適當的程式碼加入SNIPPET動作：

   • 如果您只有一個範本，或者您只想使用此指令碼傳送一個範本，請使用下列程式碼：

     DYNAMIC json2 
     ASSIGN json2.data[1] = resultset.data[2]

   • 如果您有多個範本並且希望能夠使用此指令碼傳送多個範本，請使用以下程式碼：

     DYNAMIC json1
     DYNAMIC json2
     DYNAMIC json3
     				 
     ASSIGN json1.data[1] = resultset.data[1]
     ASSIGN json2.data[1] = resultset.data[2]
     ASSIGN json3.data[1] = resultset.data[3]

6. 變更標識您要傳送的範本的索引號。在上一步驟的範例程式碼中，您需要變更 resultset.data[x] 變數中的索引號。不要變更獲得範本指派的變數中的索引。在範例程式碼中，變數為jsonY.data[Z]，您可以變更 Y，但不能變更 Z。每個jsonY變數都儲存一個範本。
7. 如果需要，可以修改變數名稱。如果需要變更，請根據需要在指令碼中的其他動作中變更變數名稱。例如，resultSet 是 GETRICHMESSAGe 的 resultSet 屬性中的預設變數名稱。jsonY變數在 AskCaller 和 Textmsg的 Message 屬性中使用。
8. 配置 AskCaller 或 Textmsg：
   1. 將 MessageFormat屬性設為 JSON。
   2. 使用變數名稱來配置 Message，此變數名稱用於儲存您要傳送的範本的 JSON。它必須作為 JSON 字串傳送。您可以在此欄位中使用變數替換。如果需要如此操作，請將程式碼新增至 Snippet 以選擇要傳送的範本並傳遞正確的變數。
   3. 根據需要配置動作的其他屬性，包括連接分支。請參閱ASKCALLER 動作或TeXTMSG動作的線上說明。

指令碼範例

此範例顯示 GETRICHMESSAGE動作連接到 SNIPPET 動作，而後者連接到 TeXTMSG。它也可以連接到 ASKCALLER。當指令碼執行時，GETRICHMESSAGE會檢索可用於 ChannelId 中指定的數位通道的富訊息範本。它們儲存在 Result Set 屬性中指定的變數中。在此範例中，變數為 resultId。此 snippet 程式碼包含一個動態資料物件，該物件將儲存特定的富訊息範本 JSON 並將其傳遞給 TeXTMSG。