自訂工作負載 Snippet

本説明頁面上的資訊同時適用於 CXone Studio 和 Desktop Studio。

對具有customPayload屬性的動作使用此 snippet，例如 Voicebot Exchange或Textbot Conversation。它用於從CXone向您的虛擬客服Closed 代替真人客服專員處理客戶互動的軟體應用程式。提供商傳遞資料。如果您需要從您的虛擬客服接收自訂資料，可使用customPayloadVarName (out)變數。

以下虛擬客服需要此 snippet：

對於所有其他虛擬客服，如果您有自訂工作負載資料要傳遞給機器人，只需包括此 snippet。如果您使用 DialogflowCX，請遵循 最佳做法以包含自訂工作負載。

傳遞一個預留位置

如果您使用Amazon Lex V1或Amazon Lex V2 並且不需要向虛擬客服傳遞資訊，請遵循此範例：

DYNAMIC customPayload 
 customPayload.placeholder=""

如果需要向虛擬客服傳遞資訊，請按照 下一部分中的範例操作。

傳遞資料

對於所有的虛擬客服提供者，按照此例將資訊傳遞給虛擬客服。用您需要傳遞的資訊替換範例中的參數。


customPayload.context.id="information"
customPayload.context.lifespan=1
customPayload.context.parameters.name="Fenrir"
customPayload.context.parameters.age="19"
customPayload.context.parameters.date="20201020"

Google Dialogflow CX 自訂工作負載的最佳做法

  • DialogflowCX 並不像 DialogflowES 那樣使用上下文將資料傳遞給Dialogflow意圖Closed 聯絡人所說/所輸入內容背後的含義或目的；聯絡要傳達或實現什麼。

  • 您可以使用 JSON 鍵值對將自訂資料傳遞給 Dialogflow CX。在指令碼的 Snippet action動作中，建立動態 customPayload 物件並向其新增鍵值對。範例：

    DYNAMIC customPayload
customPayload.ani = ani
customPayload.contactID = contactId
customPayload.masterContactId = masterId
customPayloadJSON = "{customPayload.asJSON()}"
  • 在您的指令碼中的 Exchange 或 Conversation 動作中，使用變數配置 customPayload 屬性，變數在其值中使用 asJSON() 函數。可以在customPayload物件中找到此變數。
  • 使用 QueryParameters 的 Payload 屬性將 customPayload JSON 傳遞給虛擬客服專員。有關 Google Dialogflow CX 請參見有關 QueryParameters 一個箭頭從中心指向右上角的正方形。的 Google 文件。
  • 透過 QueryParameters 傳遞的資料由 Dialogflow CX 中的 webhook 接收。您可以在 Dialogflow CX 控制台中編寫代碼以處理傳遞的資料。
  • 不要在 customPayload 物件中嵌套物件。嵌套的物件以文字字串的形式傳送。
  • 要從您的 DialogflowCX 虛擬客服將自訂資料傳遞回指令碼，請使用 DialogflowCX 控制台中的 自訂工作負載欄位。確保您是在您使用CXone的虛擬客服的控制台中。使用指令碼中的 voice 或 chat Studio 動作的 customPayloadVarName (out) 變數將其配對到您的指令碼。例如，您可以使用這個設定下一個提示行為。

  • 使用 customPayload 設定的參數只能在外部 webhook 中使用。如果您想設定參數以便在外部 webhook 之外使用，請使用 session_params 欄位在 Snippet 動作中設定它們。範例：

    {
	"session_params":
	{ 
		"name": "Winnie Le Pooh"
		"job": "Food critic"
		"location": "Hundred Acre Wood"
	}
}

    使用以下文法存取 DialogflowCX 客服專員意圖中的工作階段參數：

    $session.params.name = Winnie Le Pooh

    $session.params.job = Food critic

    $session.params.location = 100 Acre Wood

    工作階段參數僅用於 DialogflowCX 虛擬客服。為了實現與 DialogflowES 中類似的結果，請使用上下文。

  • 語音上下文提示可與 speechContexts參數中的自訂工作負載一起傳遞。speechContexts.phrases 的值必須是您要給出的提示的Google類別權杖 一個箭頭從中心指向右上角的正方形。。權杖必須與連絡人的語言和地區相符合。範例：

    DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10
  • 使用時VOICEBOT EXCHANGE：要配置當聯絡人說話停頓時，虛擬客服需等待多長時間，可在 Next Prompt Behaviors 或 Default Next Prompt Behaviors Snippet動作中新增 maxPostEnergySilenceMS 參數。

Google Dialogflow ES 自訂工作負載的最佳做法

  • CustomPayload 用於為意圖Closed 聯絡人所說/所輸入內容背後的含義或目的；聯絡要傳達或實現什麼傳遞上下文。上下文幫助虛擬客服理解使用者的意圖。上下文並非必需，但可幫助虛擬客服配對話語Closed 聯絡人所說或所輸入的內容。與意圖。
  • 在指令碼的 Snippet 動作中，建立customPayload物件，它遵循 REST Resource:  projects.agent.sessions.context的Google Dialogflow ES 文件 表示連結到外部網站的圖示中的格式。Studio 線上說明提供了有關動態資料物件的其他資訊。
  • 您還可以在沒有上下文的情況下使用 customPayload 傳遞自訂資料。為此，請將標準 JSON 鍵值對包括在動態資料物件中。
  • 語音上下文是在 speech_contact 參數的自訂工作負載中傳遞。您可以在 Studio 追蹤和應用程式紀錄中查看此參數的內容。
  • customPayload動態物件作為虛擬客服參數以 JSON 形式傳遞，如範例指令碼中所示。

  • 語音上下文提示可與 speechContexts參數中的自訂工作負載一起傳遞。speechContexts.phrases 的值必須是您要給出的提示的Google類別權杖 一個箭頭從中心指向右上角的正方形。。權杖必須與連絡人的語言和地區相符合。範例：

    DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10

此指令碼是如何整合自訂工作負載與Google Dialogflow ES虛擬客服的範例。此指令碼使用 Voicebot Exchange 動作，但如果使用 TEXTBOT EXCHaNGE 動作，它也能正常工作。

範例指令碼，說明如何使用 Google Dialogflow CX 處理自訂工作負載。

下載此指令碼。