數位通道 的 JSON 結構描述

JSON 結構描述用於定義 JSON 資料結構， 可用作範本來將內容新增至您於Digital Experience (Digital) 通道中配置的訊息。 這些結構描述允許新增富媒體內容到訊息。 富媒體內容包括清單選取器、圖庫和選單等。

每個 Digital Experience 通道Closed 聯絡人與客服專員或機器人互動的方式。 通道可以是語音、電郵、聊天、社交媒體等等。都支援不同類型的富媒體。 對於相同的富媒體內容，每個通道還需要不同的結構描述。 例如，在 Digital Experience 即時聊天中包含圖像的結構描述與在其他通道中包含圖像的結構描述不同。

目前，結構描述文件可用數位聊天通道（即時聊天和聊天訊息）和Apple Messages for Business。

結構描述和 Virtual Agent Hub

虛擬客服專員Closed 代替真人客服專員處理客戶互動的軟體應用程式。支援部分 Digital Experience 通道。 您可為受支援的通道使用 JSON 結構描述，以配置您希望文字虛擬客服專員向聯絡人傳送的訊息。 使用文字虛擬客服專員所用通道的結構描述。

目前支援將以下結構描述用於虛擬客服專員：

通道 受支援的富媒體
Apple Messages for Business

為以下項目使用Apple Messages for Business結構描述：

  • 日期選擇器
  • 時間選取器
  • 富連結
  • 清單選取器

數位 即時聊天和聊天訊息

為以下項目使用Digital Experience聊天結構描述：

  • 轉盤
  • 圖像
  • Markdown
  • 單個回應中包含多條訊息
  • 提示
  • 快速回復
  • 文字
  • URL

當您想在聊天機器人Closed 代替真人客服專員處理客戶互動的軟體應用程式。中為Digital Experience通道使用富媒體內容時，您需要將內容新增到機器人。 在用於管理機器人的控制台新增，而非在 Studio 指令碼或 Virtual Agent Hub 應用程式中新增。 內容必須遵循該虛擬客服專員所用通道特定的 JSON 結構描述。

觀看關於將 JSON 結構描述用於聊天機器人的 NICE CXone 演示。 該演示中展示了透過 SmartAssist、Dialogflow 和 Amazon Lex V1 新增內容。

Studio 指令碼中的結構描述

您需要在指令碼中包含用於富媒體的 JSON 結構描述，以便傳送給聯絡人的訊息中包含此富媒體。 您可以透過兩種方式操作：

  • 硬編碼 JSON 並將其指派給變數。
  • 在 Snippet動作 中將其構建為動態物件。

本部分提供了這兩種方法的範例。 這些範例中的 JSON 是 Digital Experience 聊天的範例。 Digital Experience 聊天的其他範例可用。

下面的範例顯示了指派給變數的 JSON：

ASSIGN jsonbody = $"\{\"prompts\":[\{\"transcript\":\"Welcome!  Choose Sales or Support and an agent will be with you shortly.\"},\{\"mediaSpecificObject\":\{\"dfoMessage\":\{\"messageContent\":\{\"type\":\"PLUGIN\",\"payload\":\{\"postback\":\"\",\"elements\":[\{\"id\":\"Ek4tPy1h4\",\"type\":\"TEXT_AND_BUTTONS\",\"elements\":[\{\"id\":\"TID1\",\"type\":\"TEXT\",\"text\":\"Please select an option\"},\{\"id\":\"BID1\",\"type\":\"BUTTON\",\"text\":\"Sales\",\"postback\":\"payment-button-1\"},\{\"id\":\"BID2\",\"type\":\"BUTTON\",\"text\":\"Support\",\"postback\":\"payment-button-2\"}]}]}}}}}]}"

下面的範例顯示了在 Snippet 動作的動態物件中內建的相同 JSON：

DYNAMIC json
json.prompts[1].transcript="Welcome!  Choose Sales or Support and an agent will be with you shortly."
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.type="PLUGIN"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.postback=""
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].id="Ek4tPy1h4"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].type="TEXT_AND_BUTTONS"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[1].id="TID1"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[1].type="TEXT"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[1].text="Please select an option"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].id="BID1"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].type="BUTTON"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].text="Sales"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].postback="payment-button-1"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].id="BID2"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].type="BUTTON"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].text="Support"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].postback="payment-button-2"
ASSIGN jsonBody="{json.asJSON()}"

使用鏡像工具驗證 JSON

您可以在將富媒體 JSON 新增到指令碼或第三方提供者的系統之前對其進行驗證。 JSON 鏡像工具是一個基於指令碼的工具，其旨在與基於數位聊天的通道（如即時聊天）配合使用。

使用該工具，您可以貼上 JSON 並查看其將如何向聯絡人和客服專員顯示。 指令碼會對其進行處理，並將輸出結果顯示在聊天視窗中。 這樣您就可以在將 JSON 新增到指令碼或虛擬客服專員或數位通道提供者的控制台之前測試 JSON 並確保其正確無誤。