Textbot Exchange

整合自助虛擬客服 代替真人客服專員處理客戶互動的軟體應用程式。與聊天指令碼。這個動作在指令碼中的迴圈中使用。指令碼必須包含至少兩個 TextBot Exchange 動作。您的虛擬客服必須支援此動作。 TextBot Exchange 動作適適用於複雜虛擬客服或需要自訂不同輪次的虛擬客服行為時。其逐輪次監控聯絡人和虛擬客服之間的對話 代替真人客服專員處理客戶互動的軟體應用程式。。將每一段話語 聯絡人所說或所輸入的內容。傳送給虛擬客服。虛擬客服專員分析話語中的意圖 聯絡人所說/所輸入內容背後的含義或目的；聯絡要傳達或實現什麼和上下文，然後決定使用哪種回應。TextBot Exchange傳遞給聯絡人的回應。對話完成後，此動作將繼續執行指令碼。 點擊兩下此動作開啟 虛擬客服專員中心，您可以在其中管理所有的虛擬客服機器人。

Supported Script Types

電郵	聊天	SMS	數位

Supported Virtual Agents

此動作支援以下虛擬客服專員：

• Amazon Lex V1
• CXone SmartAssist Powered by Amelia
• Google Dialogflow CX
• Google Dialogflow ES
• Microsoft Azure

您必須先在 虛擬客服專員中心 中新增並配置虛擬客服專員，然後才可將該虛擬客服機器人指派給此動作。您只需要為您使用的每個虛擬客服專員提供一個應用程式。您可以在您的指令碼中將同一個應用程式指派給多個虛擬客服專員動作。有關配置詳細資訊，請參閱所使用之虛擬客服提供者的說明頁。

Comparison of Similar Actions

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

• Textbot Conversation: This action is only suitable for very simple virtual agents.It doesn't allow for customization of the virtual agent's behavior from turn to turn.It's not currently supported in CXone.
• Textbot Exchange：此action用於更複雜的虛擬客服互動。允許您包含交換參數，並自訂聯絡人和虛擬客服之間對話的各個方面。
• Voicebot Conversation：此action僅適用於非常簡單的虛擬客服。其不允許自訂虛擬客服在不同輪次中的行為。若要使用 SIP 後端通道連接，且虛擬客服專員支援該連接，則必須使用 Voicebot Conversation。
• Voicebot Exchange：此action用於更複雜的虛擬客服互動。允許您包含交換參數，並自訂聯絡人和虛擬客服之間對話的各個方面。

Input Properties

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

此動作的一個或多個屬性需要使用 自訂代碼的 Snippet 動作。

Property	Details
Caption	輸入在指令碼中唯一標識此操作的短語。標題出現在指令碼畫布上的動作圖示下。The default is the action name.
virtualAgentID	虛擬客服專員中心 中選擇的虛擬客服專員名稱。當您將虛擬客服應用程式分配給虛擬客服專員中心中的Studio動作時，它將自動填充此屬性。該名稱是在虛擬客服專員中心應用的Virtual Agent (Bot) Name欄位中使用的名稱。
automatedIntent	按名稱輸入虛擬客服要回應的特定意圖，而不是讓虛擬客服解釋收集的使用者輸入。此類的一個常見用例是讓虛擬客服顯示最初歡迎訊息。Welcome是初始問候的標準字串。
userInput	聯絡人在聊天視窗中寫入的訊息，並作為文字輸入傳遞給虛擬客服。
customPayload	只有在需要向虛擬客服傳遞自訂工作負載資料時才配置此屬性。自訂工作負載物件從Studio指令碼中填充。您可以用其從 CRM 管理聯絡人、銷售資訊、支援詳情和案例歷史的第三方系統。 傳遞聯絡人姓名等資訊，以便在歡迎訊息中使用。 輸入 JSON 物件的名稱，該物件將資料從指令碼傳遞給虛擬客服。您必須在一個 Snippet 動作中定義自訂的工作負載物件。該物件必須在 snippet 中或在customPayload屬性中轉換為 JSON。 對特定虛擬客服提供商的要求： Amazon Lex V1：即使您不需要向虛擬客服傳遞資料，也需要此屬性。新增一個帶有預留位置值的 snippet 。 Google Dialogflow ES：此屬性用於傳遞意圖 聯絡人所說/所輸入內容背後的含義或目的；聯絡要傳達或實現什麼的上下文。請與 Google Dialogflow ES 一起查看自訂工作負載的最佳做法，以確保您處理得當。 Google Dialogflow CX：請與 Google Dialogflow CX 一起查看自訂工作負載的最佳做法，以確保您處理得當。 如果您需要處理虛擬客服返回給指令碼的資料，請不要使用此屬性。而是使用 customPayloadVarName (out) 變數代替。
botSessionState	虛擬客服提供者為聯絡人和虛擬客服專員之間的每次對話都會分配一個唯一的識別碼。該識別碼可以防止每一次對話都建立一個新的會話。提供者在對話開始時建立識別碼，並將其與第一個回應一起傳遞給指令碼。指令碼將儲存 的此動作的botSessionStateVarName (out)屬性命名的變數中的識別碼。然後它將識別碼傳遞給botSessionState屬性。 此屬性必須正確配置，才能使您的虛擬客服正常運行。關於如何配置的更多資訊，可在機器人會話狀態 Snippet 説明頁面上找到。

Output Properties

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

屬性	描述
nextPromptVarName (out)	定義在下一個對話回合提示使用者的行為。
customPayloadVarName (out)	將自訂 JSON 資料從虛擬客服傳回到指令碼。如果您希望指令碼處理虛擬客服提供的資料，請使用此變數。可能包含履行資料。 如果要向虛擬客服提供資料，請使用 customPayload 屬性。
errorDetailsVarName (out)	提示錯誤意圖序列；可能會導致轉移至真人客服專員。
intentInfoVarName (out)	保留來自虛擬客服詳細資料的變數，表明目前使用者的意圖。
botSessionStateVarName (out)	保留變數，指令碼在其中存儲由虛擬客服提供者傳送的機器人會話狀態識別碼。變數的內容被傳遞給botSessionState屬性。 此屬性必須正確配置，才能使您的虛擬客服正常運行。關於如何配置的更多資訊可在機器人會話狀態 Snippet 説明頁面上找到。

Result Branch Conditions

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

條件	描述
Default	指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。如果沒有定義動作的其他分支，也會採用該路徑。
OnPromptAndCollectNextResponse	虛擬客服確定互動應繼續進行，並準備好接收更多來自聯絡的人工輸入時採用的路徑。提示對話的下一個回合。
OnError	出現意外問題（例如，連接不良、文法錯誤等）時採用的路徑。_ERR變數應填上針對問題的簡要說明。
OnReturnControlToScript	如果虛擬客服指示對話已完成並將控制權交還給 Studio 指令碼以轉移或結束通話，則會採用此路徑。在 customPayload 結果可能有履行資料尚待處理。

Snippet Action Code

此動作的一個或多個屬性需要使用以下自訂代碼的 Snippet action：

• Custom Payload
• Bot Session State

Best Practices for Custom Payload with Google Dialogflow CX

When using this action with Google Dialogflow CX follow these best practices for integrating custom payloads:

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

• 您可以使用 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		

Best Practices for Custom Payload with Google Dialogflow ES

When using this action with Google Dialogflow ES, follow these best practices for integrating custom payloads:

• CustomPayload 用於為意圖 聯絡人所說/所輸入內容背後的含義或目的；聯絡要傳達或實現什麼傳遞上下文。上下文幫助虛擬客服理解使用者的意圖。上下文並非必需，但可幫助虛擬客服配對話語 聯絡人所說或所輸入的內容。與意圖。
• 在指令碼的 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