自訂工作負載 Snippet

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

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

以下虛擬客服需要此 snippet:

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

傳遞一個預留位置

如果您使用Amazon Lex V1Amazon 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()}"	
  • 在您的指令碼中的 ExchangeConversation 動作中,使用變數配置 customPayload 屬性,變數在其值中使用 asJSON() 函數。可以在customPayload物件中找到此變數。
  • 使用 QueryParametersPayload 屬性將 customPayload JSON 傳遞給虛擬客服專員。有關 Google Dialogflow CX 請參見有關 QueryParameters 一個箭頭從中心指向右上角的正方形。Google 文件。
  • 透過 QueryParameters 傳遞的資料由 Dialogflow CX 中的 webhook 接收。您可以在 Dialogflow CX 控制台中編寫代碼以處理傳遞的資料。
  • 不要在 customPayload 物件中嵌套物件。嵌套的物件以文字字串的形式傳送。
  • 要從您的 DialogflowCX 虛擬客服將自訂資料傳遞回指令碼,請使用 DialogflowCX 控制台中的 自訂工作負載欄位。確保您是在您使用CXone的虛擬客服的控制台中。使用指令碼中的 voicechat 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 BehaviorsDefault Next Prompt Behaviors Snippet動作中新增 maxPostEnergySilenceMS 參數

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

  • CustomPayload 用於為意圖Closed 聯絡人所說/所輸入內容背後的含義或目的;聯絡要傳達或實現什麼傳遞上下文。上下文幫助虛擬客服理解使用者的意圖。上下文並非必需,但可幫助虛擬客服配對話語Closed 聯絡人所說或所輸入的內容。與意圖。
  • 在指令碼的 Snippet 動作中,建立customPayload物件,它遵循 REST Resource:  projects.agent.sessions.contextGoogle 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