Studio 基本概念

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

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

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

CXone 術語

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

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

指令碼和 CXone

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

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

該圖有幾處值得注意：

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

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

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

• 自訂指令碼可透過 CXone 平台 控制聯絡流程。指令碼以 POC 指定的預設 ACD 技能啟動。它可以包括 IVR 自動電話選單，允許呼叫者透過語音命令或按鍵輸入或二者進行互動，以獲取資訊、路由至呼入語音通話或二者兼有。 或 ASR 允許聯絡人透過說話、點擊手機按鍵或兩者組合的方式來回應錄音的語音提示。 選單或其他機制，以確定每個聯絡人要使用的更具體的技能。

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

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

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

CXone 和 Studio 中的聯絡人

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

• 貴組織中的客服專員與哪些人有互動。例如，客戶、顧客、網站訪客等。
• CXone 平台 中與互動相關的應用資料的項目。每個聯絡人都有一個與之關聯的 ID 編號。此 ID 可追蹤跨 平台 的互動。

當聯絡人進入系統時，系統會運行指令碼實例，而 ACD 會為該實例指派一個聯絡 ID。傳入和傳出互動都會出現這種情況。在互動過程中收集資訊，如聯絡人姓名、帳號等。互動過程中可能會產生其他資訊，如通話轉錄和錄音。所有這些資訊都與互動過程中指令碼中的聯絡 ID 相關聯。互動結束後，與聯絡 ID 相關的大部分資訊都會被丟棄，除非指令碼設計為可以儲存這些資訊。某些資訊，如通話記錄和聯絡人歷史記錄，會保留在 平台 中用於其他用途。

聯絡 ID 用於識別互動的一個分段。一個完整的互動可能涉及多個分段。當來電轉接到另一個客服專員或指令碼產生另一個指令碼時，可能會出現新的分段。發生這些事件時，新的聯絡 ID 將會開始。在大多數情況下，兩個聯絡 ID 在整個互動過程中都處於活動狀態。新的聯絡 ID 有時稱為子聯絡人。

為了跟蹤與單個互動相關的所有聯絡 ID，還為聯絡人指派了主 ID。指派給聯絡人的任何聯絡 ID 都歸入其主 ID 下。

要在指令碼中引用聯絡人時，需要在互動的適當部分使用聯絡 ID。聯絡 ID 和主 ID 儲存在 contactId 和 masterId 變數中。它們是預定義變數，可以在指令碼中使用。預設變數會在指令碼中自動建立，因此使用前無需聲明。

指令碼元件

指令碼包括以下元件：

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

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

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

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

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

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

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

指令碼媒體類型

指令碼有一個名為媒體類型的屬性。媒體類型是聯絡人和客服專員用於通訊的一種 通道 聯絡人與客服專員或機器人互動的方式。通道可以是語音、電郵、聊天、社交媒體等等。。指令碼的媒體類型必須與指派給它使用的通道類型相符合。

當您建立指令碼時，會提示您選擇媒體類型。如有必要，您可以稍後變更此設定。

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 環境的技術支援、計費和全域設定的高級組織分組.

抑制指令碼

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

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

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

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

Script Templates and Examples

Studio offers script templates for some features and applications in CXone, 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 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指令碼頁。

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

• DiscardDiscard：終止一個電郵指令碼。
• EndEnd：終止一個電話、語音郵件、SMS 或數位指令碼。不終止數位聯絡，但終止其他媒體類型的指令碼中的聯絡。
• End a ContactEnd a Contact：終止活躍聯絡。不終止當前指令碼。
• EndTextEndText：終止一個不包括 Regagent 動作的 SMS 工作流程（僅針對 數位 任何與Digital Experience相關的通道、聯絡或技能。通道）。
• EndWiEndWi：終止帶有原因代碼的工作項目。不終止當前指令碼。
• ExitExit：終止聊天工作階段並斷開聊天聯絡人的連線。
• HangupHangup：終止電話指令碼。
• ReturnReturn：終止子指令碼，並將控制權返回給原指令碼。

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

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

使用 snippet 的自訂編碼

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

自訂編碼需要更複雜的路由或 CXone 中的某些產品或功能。在某些情況下，Studio 動作或整個 CXone 應用程式需要 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

  

變更動作標籤

在指令碼中做注釋的另一個選項是變更指令碼中動作的標題。在每個動作的屬性中都有一個標題欄位，您可以在 中變更畫布上顯示的動作名稱上的動作名稱。您可以用來命名每個動作，用一個詞或短語來提醒該動作在指令碼中的用途。

例如，您可以變更 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顯示與指令碼相關的任何警告和錯誤。您可以使用這些資訊來幫助對指令碼進行測試和偵錯。
• 您可以import and export scripts as XML files。

• Studio 不允許指令碼在儲存後被重新命名。如果您需要變更指令碼名稱，您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 中，右鍵點擊瀏覽器標籤中的指令碼（檢視 > 瀏覽器），將滑鼠停留在歷程記錄選項。CXone Studio 中目前沒有此選項。
  • 在 CXone 中，點擊 ACD > 指令碼。在此頁，您也可以revert a script還原為先前版本。
• 您可以使用 CXone 中的 ACD > 指令碼排程選項執行排程指令碼。
• 在CXone 中的ACD > 指令碼頁面上，您可以spawn a script，其中包含指令碼用作變數的暫時自訂參數。
• 為了防止指令碼變得過於龐大和複雜，您可以將其分成多個較小的指令碼，並用 Runsub 或 Runscript 動作進行連結。
• 您可以用 Studio 的某些指令碼 API 以程式設計方式打開和儲存指令碼。這需要進階指令碼技能。

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