Desktop Studio 基本概念

指令碼是 CXone Mpower 在聯絡中心工作的重要組成部分。 它們定義了與您的組織聯絡的人如何接觸到可以幫助他們的客服專員。 指令碼指定了在互動過程中和互動結束後資料的處理方式。 這包括以螢幕彈出畫面 彈出式視窗在事件（例如連接到聯絡人）發生後會顯示在客服專員的螢幕上，其中顯示聯絡人的相關資訊。的形式為客服專員顯示資料、從聯絡人處擷取資料以及將資料儲存到資料庫中。

您的聯絡中心可能有許多不同的指令碼，也可能只有幾個。 您需要的指令碼的確切數量和種類取決於貴組織使用的應用程式和功能，以及您處理的互動類型。 指令碼的範圍可以從非常簡單到相當複雜。 簡單的指令碼不需要太多的指令碼或編碼知識。 複雜的指令碼可能需要自訂指令碼代碼。

本頁概述了有關指令碼及其工作方式的基本資訊和概念。 本頁還介紹了指令碼與聯絡中心全域中的 CXone Mpower 相適應的方式。

CXone Mpower 術語

以下清單定義了編寫指令碼時必須了解的一些 CXone Mpower 術語：

• ACD 技能：ACD 技能用於自動將聯絡人路由至最有可能提供幫助的客服專員。 他們可以使用任何標準建立，例如部門、團隊、專業或訓練有素的能力。 他們還可以使用位置、語言等其他因素。 ACD 技能將指派給客服專員。 Studio 指令碼使用 ACD 技能執行自動路由。
• 通道：通道是與聯絡人溝通的一種方式，如電話、電郵、SMS 或文本訊息、聊天、社群媒體、語音郵件等。 在 Studio 中，每種通道都有自己的指令碼媒體類型。
• 聯絡人：與貴組織互動的人稱為聯絡人。 聯絡人有與之關聯的 ID 編號，用於跟蹤整個 平台 中的互動。 在 Studio 線上說明中，聯絡也可以指 CXone Mpower 中引用互動相關資料的項目。
• 數位：該術語指與 Digital Experience 相關的通道、技能、指令碼、聯絡人和互動。
• 互動：這是聯絡人和客服專員之間的完整對話。 互動可以是一次電話通話，也可以是長達數小時的聊天對話，還可以是包含多條來回訊息的電郵執行緒。 在數位通道上，互動可以持續數天、數周或更長時間。
• 媒體類型：媒體類型是指令碼工作的通道類型，如電話、聊天、電郵等。 建立指令碼時，您需要為特定媒體類型建立指令碼。
• 聯絡點：聯絡點 (POC) 是進入 CXone Mpower 平台 的入口點。 建立 POC CXone Mpower，以定義通道的特定實例。 為每個 POC 指派一個 ACD 技能和一個 Studio 指令碼。 指派給 POC 的指令碼必須定義在該通道上開始互動後聯絡人的流程。

指令碼和 CXone Mpower

如果沒有指令碼，CXone Mpower 無法運行。 貴組織與CXone Mpower使用的每種溝通方式，如電話、電郵、聊天等，都需要一個指令碼。 指令碼定義了貴組織的客服專員與他們交談的人之間互動期間和之後發生的事情。

下圖概述了 CXone Mpower 及其在組織大局中的位置。 它還顯示了指令碼如何與 CXone Mpower 的每個部分以及 CXone Mpower 以外的應用程式和系統互動。

該圖有幾處值得注意：

• 它表示兩個傳入通道，即語音和digital聊天。 在 CXone Mpower 中，還有許多其他可能的傳入通道，包括電郵和社群媒體。 傳入表示聯絡人開始與貴組織互動。 CXone Mpower 在某些通道上也支援傳出互動，這樣客服專員就可以開始互動。 CXone Mpower 需要為傳入和傳出互動分別編寫指令碼。

• 圖中顯示了兩種指令碼：

  • 系統指令碼在後臺運行。 它們會處理 CXone Mpower 中無法定制的流程。 您無法修改系統指令碼，也無法在 Studio 中看到它們，但知道它們存在還是很有幫助的。
  • 自訂指令碼是您和貴組織中的其他指令碼編寫者在 Studio 中建立的指令碼。 這些指令碼控制著聯絡人從互動開始時的情況。 自訂指令碼還可以控制互動過程中產生和收集的資料，以及互動結束後對這些資料的處理。
• 系統指令碼可識別互動使用的 POC 呼入聯絡人用來發起互動的入口點，如電話號碼或電郵地址。。 他們會指派 POC 指派的預設ACD技能，並將聯絡人路由到 POC 指派的自訂指令碼。 在 CXone Mpower 中建立 POC 時，指派了 ACD 技能和自訂指令碼。

• 自訂指令碼可透過 CXone Mpower 平台 控制聯絡流程。 指令碼以 POC 指定的預設 ACD 技能啟動。 它可以包括 IVR 互動式語音應答。 聯絡人透過語音或按鍵輸入來使用的自動化電話選單，能夠獲取資訊、路由呼入語音電話或此兩者。 或 ASR 自動語音識別。 允許聯絡人透過說話、按下電話鍵或使用此兩種方式回應提示。 選單或其他機制，以確定每個聯絡人要使用的更具體的技能。

  例如，電話指令碼可能包含一個 IVR 選單，供聯絡人選擇。 IVR 選單可能會顯示：「銷售請按 1，支援請按 2 或帳單請按 3」。 選單選項與 ACD 技能對應。

  作為指令碼編寫者，您可以設定指令碼，以便在按下 2 時，請求擁有 ACD 技能的客服專員提供支援。 要了解更多有關其工作原理的資訊，在開始使用Studio部分中的Develop a Basic Script tutorial的第二部分提供了配置指令碼以使用 ACD 技能進行路由的詳細步驟。

• 自訂指令碼可以與各種第三方應用程式整合，例如 CRM 管理聯絡人、銷售資訊、支援詳情和案例歷史的第三方系統。、資料庫、虛擬客服專員機器人 代替真人客服專員處理客戶互動的軟體應用程式。 或其他服務。 例如，您可以從 CRM 中檢索客戶資訊，以便在互動開始時向客服專員顯示。 您可以在互動完成後將互動過程中收集的資料儲存在 CRM 的聯絡人記錄中。

CXone Mpower 和 Studio 中的聯絡人

術語聯絡代表 CXone Mpower 中的兩個重要概念：

• 第一個概念：貴組織的客服專員與之互動的人員，如客戶、客戶、網站訪問者等。 這幾乎總是該術語在CXone Mpower連線説明中的含義。 例外是在Studio部分，有時它具有第二個含義。
• 第二個概念：CXone Mpower 平台中引用與交互相關數據的實體。 一個人（聯絡人）和客服專員之間的每次互動都有一個分配給它的 ID 號，稱為聯絡 ID。 此 ID 追蹤整個平台的互動。 它還識別與平台互動期間和互動結束後的互動相關的數據。 本節將詳細討論此概念。

當傳入或傳出互動開始時，將運行腳本的實例。 ACD為該實例指派一個聯絡 ID。 資訊在互動過程中收集，例如與客服專員互動的人員的姓名、他們的帳號等。 可以生成其它資訊，例如通話記錄和錄音。 所有這些資訊都與指令碼中的聯絡 ID 相關聯。 互動結束後，與聯絡 ID 相關的大部分資訊都會被丟棄，除非指令碼設計為可以儲存這些資訊。 某些資訊（如通話錄音和聯繫人歷史記錄）會保留在平台中以作其他用途。

聯絡人 ID 和主 ID

聯絡 ID 用於識別互動的一個分段。 一個完整的互動可能涉及多個分段。 當呼叫轉移給其他客服專員或指令碼產生另一個指令碼時，會出現新分段。 發生這種情況時，將開始一個新的聯繫人ID。 在大多數情況下，兩個聯絡 ID 在整個互動過程中都處於活動狀態。 新的聯絡 ID 也稱為子聯絡。

SPAWN 和 RESKILL 操作會觸發建立新聯絡 ID 的新指令碼。 這些是導致分配新聯繫人 ID 的唯一操作。

為了跟蹤與單個互動的分段關聯的所有聯絡 ID，聯絡人還具有主聯絡 ID，通常稱為主 ID。 主ID跟蹤腳本之間的直接父子關係。 它始終與當前指令碼的父指令碼中的聯絡 ID 匹配。 即觸發當前腳本的腳本。

在互動開始時，聯絡 ID 和主 ID 是相同的。 當初始指令碼觸發第二個指令碼（例如 SPAWN動作）時，將產生新的聯絡。 新聯絡人具有唯一的聯絡 ID，其主 ID 與前一個分段的聯絡 ID 匹配。 如果觸發第三個腳本，則會生成第三個聯繫人。 它有一個新的聯繫人 ID，其主 ID 與第二個段的聯絡 ID 匹配。 下圖顯示了此進度。

下圖演示了當腳本由 RUNSUB和 RUNSCRIPT 操作觸發時，聯絡 ID 不會更改。

整個互動（包括所有聯絡人 ID 和主 ID）透過互動 ID 綁定在一起。 互動 ID 不會變更。

在指令碼中使用聯絡人 ID

要在指令碼中引用聯絡人，請將聯絡 ID 用於互動的相應分段。 聯絡人和主 ID 儲存在contactId和masterId變數中，這些變數是預定義的系統變數，您可以在腳本中使用。 預定義的變數會在腳本中自動創建，因此在使用之前無需聲明它們。

變數將儲存由使用變數的指令碼所表示的互動段的 ID。 如果需要引用其他段的 ID，請在腳本中創建一個與需要引用的段對應的新變數，並從系統變數中寫入值。

如果互動中的其他分段仍處於活動狀態，您可以使用該分段的聯絡 ID 與他們進行互動。 SIGNAL和ONSIGNAL操作允許您向另一個分段發送資訊或從另一個分段接收資訊，只要您有適當的聯絡 ID。

主 ID 和連絡人 ID 在整個CXone Mpower 平台中的多個位置顯示。 您可以在「聯絡歷史記錄」報告和「呼叫詳情（綜合）」報告等報告中找到它們。 它們也用於應用程式等，例如Interaction Analytics。

為數位和傳統 ACD通道編寫指令碼

數位指與Digital Experience（Digital）相關的通道、技能、指令碼、聯絡人和互動。 數位實體與其 ACD 對應實體不同。 實體在 CXone Mpower平台 中的管理位置存在一些差異。 與傳統 ACD 通道上的互動相比，平台 處理數位互動的方式也存在其他差異。

在 Digital Experience 和傳統 ACD 中都有電郵、聊天和 SMS 通道。 這些通道的傳統 ACD 版本使用電郵、聊天和 SMS 指令碼媒體類型。 這些通道的數位版本均使用數位指令碼媒體類型。

此外，許多用於處理電郵、聊天和 SMS 的 Studio 動作僅適用於這些通道的傳統 ACD 版本。 您可以查看線上說明頁面中某動作的「支援的指令碼類型」部分，以確定是否可以在數位通道中使用該動作。

您可以在 Digital Experience 線上說明中了解 Digital Experience 中可用通道的更多資訊，以及如何管理數位實體。 如果您的組織使用數位通道，您可以在數位指令碼説明頁面了解更多與數位通道合作的資訊。

指令碼元件

指令碼包括以下元件：

• 動作：在 Studio 中，指令碼由稱為動作的連接塊組成。 每個動作在指令碼中起到具體的作用。 動作可以建立選項選單、播放音訊檔案或請求下一個可用的客服專員。 大多數動作都有一組屬性，必須對這些屬性進行配置，以便在指令碼中定義每個動作個體的特定行為。 屬性包括：選擇 ACD 技能 用於基於客服專員技能、能力和知識的互動的自動化傳遞。、設定變數以及選擇一個要播放的音訊檔案。

  您可以在Action Basics說明頁面中了解更多有關動作的資訊。 線上說明Studio Actions部分提供了單個動作的線上說明。

• 連接器：指令碼的流程由動作connected的方式定義。 動作之間的連接用線條和箭頭表示。

• 分支：您可以在您的指令碼中建立branches以涵蓋一個動作有多個可能的結果的情況。 例如，這允許您定義當出現錯誤時會發生什麼。 您也可以使用分支為聯絡人提供選擇，例如在 IVR 互動式語音應答。 聯絡人透過語音或按鍵輸入來使用的自動化電話選單，能夠獲取資訊、路由呼入語音電話或此兩者。 選單中。 多個分支可以源於單個動作。 在這種情況下，您可以定義指令碼採用每個分支必須滿足的條件。 您還可以在同一動作中包含多個分支端。

• 提示：提示是許多指令碼的常見組成部分。 當向聯絡人提供選擇或給他們提供資訊時，其是指令碼可以播放的訊息。 例如，IVR 選單使用提示可讓聯絡人了解他們繼續互動的選項。 這可能是一些訊息，如「對於銷售，請按 1。 對於支援，請按 2。」 您也可以使用提示來提供聯絡人資訊，如組織的工作時間或聯絡人的目前帳戶餘額。 提示可以是預先錄製的音訊檔案或由文字轉語音 (TTS 允許使用者將錄音的提示輸入為文字形式，並使用電腦產生的語音來講述內容。) 服務讀取的文字。

• 自訂代碼：有時需要在Studio指令碼中使用自訂指令碼。 自訂代碼允許您擴展指令碼的功能範圍。 使用某些產品時需要，例如虛擬客服專員 代替真人客服專員處理客戶互動的軟體應用程式。。 即使不需要，使用它也會有幫助，因為它可以簡化管理Studio指令碼的某些方面。

  自訂代碼必須用 Snippet 編寫，這是一種為 CXone Mpower 開發的內部指令碼語言。 線上說明的技術指南部分提供了Snippet的參考材料。

指令碼媒體類型

指令碼有一個名為媒體類型的屬性。 媒體類型是聯絡人和客服專員用於通訊的一種 通道 促進客戶在聯絡中心互動的各種語音和數位通訊媒介。。 指令碼的媒體類型必須與指派給它使用的通道類型相符合。

當您建立指令碼時，會提示您選擇媒體類型。 如有必要，您可以稍後變更此設定。 目前，Studio中沒有該選項，因此您必須使用Desktop Studio應用程式。

Studio中的媒體類型如下表所示：

通用	電郵	聊天	電話	語音郵件	工作項目	SMS	數位

媒體類型會影響指令碼中可使用的動作。 大多數動作適用於任何類型，但有些動作僅適用於特定的媒體類型。 例如，ASR 自動語音識別。 允許聯絡人透過說話、按下電話鍵或使用此兩種方式回應提示。 動作僅適用於電話指令碼。 如果您正在處理電郵指令碼，則在the Tools tab of that script中看不到 ASR 動作。

The Framework tab contains all actions available in Studio. It doesn't hide actions that aren't compatible with the type of script you're working with. If you try to add an incompatible action, Studio displays an error message. The Framework tab isn't visible by default in Studio. If you don't see it, it's not enabled for your 租戶 用於管理CXone Mpower系統的技術支援、帳單和全域設定的高階組織群組。.

抑制指令碼

抑制指令碼是用於呼出電話ACD技能的自訂子指令碼，其用於在打電話之前確定是否應該繼續請求進行呼叫還是執行自訂邏輯。 可以對由客服專員或撥號器撥打的通話執行抑制指令碼。

當請求呼出通話時，發出呼叫的系統指令碼會檢查是否為用於請求呼叫的ACD技能被指派了抑制指令碼。 如果存在抑制指令碼，則請求將被路由到抑制指令碼。 當抑制指令碼中的邏輯完成後，呼叫請求必須被返回到系統指令碼。

抑制指令碼必須以PERMITCALLaction或SUPPRESSCALLaction結尾。 如果呼叫可以繼續，請使用 PERMITCALL；如果不應撥打呼叫，請使用 SUPPRESSCALL。 這兩個動作都將呼叫請求返回到原始系統指令碼。  然後，系統指令碼會相應地完成請求。

您可以在設定呼叫抑制說明頁面上了解有關建立抑制指令碼的更多資訊.

Script Templates and Examples

Studio offers script templates for some features and applications in CXone Mpower, such as call suppression in Personal Connection. Script templates are in the Available Templates section of the Create New Script window.

The online help contains other scripts that you can base your own scripts on. Some products or features in CXone Mpower require scripts to work. The online help for those products provides information about those scripts. Additionally, the online help pages for many Studioactions 在Studio指令碼中執行一個流程，例如收集客戶資料或播放音樂。 provide script examples. These examples show how you can use a particular action in your scripts. The example scripts aren't complete and may require additional modification so they work in your contact center.

指令碼版本管理

您可以透過制定一個命名慣例來管理您的指令碼版本。 常見的命名慣例是在指令碼檔案名稱的末尾加入 DEV 或 PROD。 這些新增內容可以幫助您識別指令碼屬於開發還是生產階段。 如果符合您的組織的要求，您還可以加入其他資訊，如日期或版本號。

Studio 不允許在指令碼儲存後變更其名稱。 需要變更指令碼名稱時，請使用另存為製作該指令碼的副本並為其提供一個新名稱。 例如，將指令碼從開發階段轉入生產階段時需要這樣做。 在you put a script into production，您可以deactivate舊的生產和開發版本，以此保持指令碼資料夾的整潔。 如果您需要再次使用，您可以reactivate。

指令碼在 Studio 中有兩類歷史版本。 包括：

• 隨著指令碼在開發和生產過程中移入和移出而累積的單個檔案。
• 由 Studio 自動儲存和維護的以前版本。 每次儲存指令碼檔案時，Studio 都會在該檔案的歷程記錄中新增一個新版本。 如果需要，您可以將指令碼檔案revert為先前版本。 由 Studio 保留的版本數量是可配置的。

因為每次儲存指令碼時都會新增另一個版本，所以您可以在處理一個指令碼的過程中完全替換該指令碼的所有儲存版本。 您可能想在開始工作之前export一個指令碼的副本，特別是當您要做重大修改時。 這樣便可供您參考，或者在需要時完全還原。 給匯出的副本命名可能會非常有用，這樣您就能知道它是哪個版本，以及為什麼要保留它。

開始和結束指令碼

指令碼有三種啟動方式。 可能是：

• 從聯絡點 呼入聯絡人用來發起互動的入口點，如電話號碼或電郵地址。啟動。 這適用於從互動開始時開始處理聯絡的初始路由的指令碼。 對於這種指令碼，您可以透過將他們指派給聯絡點put them into production。
• Spawned或啟動來源為：
  • 使用 Runsub 或 Runscript 動作的另一個指令碼。
  • API。
  • ACD指令碼頁。
• 由 Digital Experience 中的工作流程自動化作業產生。

每個指令碼都以 Begin 動作開始。 指令碼以終止動作結束。 有幾個終止動作。 您使用哪一個至關重要，並取決於指令碼媒體類型：

• Discard ：終止一個電郵指令碼。
• End ：終止電話、語音郵件、SMS 或數位指令碼。 不終止數位聯絡，但終止其他媒體類型的指令碼中的聯絡。
• End a Contact: 終止活躍聯絡。 不終止當前指令碼。
• EndText: 終止不包含Regagent動作的 SMS 工作流程（僅適用於數位 任何與Digital Experience相關的通道、聯絡或技能。通道）。
• EndWi: 終止具有原因代碼的工作項目。 不終止當前指令碼。
• Exit ：終止聊天工作階段並斷開聊天聯絡人。
• Hangup ：終止電話指令碼。
• Return ：終止子指令碼並將控制權返回給源指令碼。

如果您使用 End 動作，則適用以下資訊：

• 如果您在一個不支援媒體類型的指令碼中使用End，可能無法正確結束所有流程或聯絡。 結束後台流程是終止動作的一個關鍵功能。 由於此原因，使用最適合您的指令碼的媒體類型的動作非常重要。
• 如果您在子指令碼中使用End，它將同時終止子指令碼和源指令碼。 如果您想終止子指令碼，但又想讓源指令碼繼續，請使用 Return 動作。
• End 應用來終止一個活躍指令碼的邏輯流程，並叫用 OnRelease 事件動作。 由於此原因，它不應在OnRelease事件邏輯之後使用。

使用 snippet 的自訂編碼

簡單的指令碼不需要自訂編碼。 對於這些指令碼，使用可用的動作足以管理 CXone Mpower 中的基本路由功能。

自訂編碼需要更複雜的路由或 CXone Mpower 中的某些產品或功能。 在某些情況下，Studio 動作或整個 CXone Mpower 應用程式需要 Snippet 代碼才能正常工作。 透過 Snippet 動作，您可以在指令碼中需要新增自訂代碼的地方插入代碼。

Studio 使用一種名為Snippet的內部指令碼語言。 該語言在伺服器端執行並編譯為 MSIL（Microsoft 中間語言），就像 C# 和 Visual Basic .NET 一樣。 線上說明提供了關於 Snippet 的完整參考指南。

指令碼中的注釋和注解

Studio 提供了幾種向指令碼新增注釋的方法。 此關鍵步驟可以確保您以及任何在您之後從事指令碼工作的人，都能理解該指令碼。 您可以：

• 使用 Note 和 ANnotation Studio 動作。
• 變更指令碼中的動作在畫布工作區上顯示的標籤。
• 為 Snippet 動作代碼新增註釋。

使用 NOTE 和 ANNOTATION 動作

您可以在您的指令碼中加入 Studio 的兩個動作：Note和 Annotation。 這些動作都不影響指令碼的工作方式。 它們只是提供資訊。 這些動作之間的區別在於：

• Note 動作可以放在指令碼畫布的任何位置，不需要與其他動作連接。 要新增或檢視使用此動作制定的備註，您必須點擊兩下。

  View image

  

• Annotation動作在畫布上以灰色矩形直接顯示您的評論。 如果您想直接指向注釋引用的指令碼部分，還可以將 Annotation 連接到另一個動作。

  View image

  

變更動作標籤

在指令碼中做注釋的另一個選項是變更指令碼中動作的標題。 在每個動作的屬性中都有一個新增標題或標題欄位，您可以在新增名稱或簡短描述，這些名稱或描述會出現在畫布上的 Studio 動作下。 在Desktop Studio中，它會變更畫布上的動作名稱。 您可以用來命名每個動作，用一個詞或短語來提醒該動作在指令碼中的用途。

例如，您可以變更 Snippet 動作的名稱，以表明它所包含的代碼。 或者，您可以在 IVR 互動式語音應答。 聯絡人透過語音或按鍵輸入來使用的自動化電話選單，能夠獲取資訊、路由呼入語音電話或此兩者。 選單中用播放中的音訊檔案或提示的名稱命名每個 Play 動作。

在 SNIPPET 動作中新增註釋

您可以在 Snippet 動作中為自訂代碼新增註釋。 註釋可以在單獨的連結上，也可以在一行代碼的末尾。 Snippet 語言使用兩個正斜線表示注釋 ( // )。 下面的範例顯示了 snippet 中的註釋：

//custom payload parameters are optional and
//customizable
DYNAMIC customPayload
customPayload.context.id="123"
customPayload.context.parameters.name="Beowulf"
CustomPayload.context.parameters.age=25
ASSIGN tokenjson = "{customPayload.asjson()}" //converts to JSON	

有關使用 Studio 的重要資訊

• Script Errors tab顯示與指令碼相關的任何警告和錯誤。 您可以使用這些資訊來幫助對指令碼進行測試和偵錯。
• You can import and export scripts as XML files 。

• Studio does not allow scripts to be renamed once they're saved. If you need to change a script's name, you can use Save As to create a copy with a new name, then deactivate the old script or move it into a separate folder so it's out of the way.

• 您可以在兩個位置檢視指令碼的先前版本：
  • 在 Desktop Studio 中，右鍵點擊瀏覽器標籤中的指令碼（檢視 > 瀏覽器），將滑鼠停留在歷程記錄選項。 Studio 中目前沒有此選項。
  • 在 CXone Mpower 中，點擊 ACD > 指令碼。 在此頁，您也可以revert a script還原為先前版本。
• 您可以使用 CXone Mpower 中的 ACD > 指令碼排程選項執行排程指令碼。
• 在 ACD> Scripts 頁面中的 CXone Mpower，您可以使用腳本用作變數的臨時自定義參數spawn a script。
• 為了防止指令碼變得過於龐大和複雜，您可以將其分成多個較小的指令碼，並用 Runsub 或 Runscript 動作進行連結。
• 您可以用 Studio 的某些指令碼 API 以程式設計方式打開和儲存指令碼。 這需要進階指令碼技能。

• 指令碼的變更會自動儲存在您的瀏覽器本地。 這可以防止您在瀏覽器意外關閉時遺失未儲存的工作。 如果發生這種情況，下次打開指令碼時，Studio會提示您打開包含未儲存變更的指令碼。