SNIPPET

允許您在您的指令碼中新增自訂代碼。

相依性

• 此動作中的代碼必須用 Snippet 編寫，該語言是由 NICE CXone 開發的內部指令碼設計語言。Studio 技術參考指南 提供了有關 snippet 指令碼的詳細資訊。
• 動態資料物件的屬性不能被命名為__type （包含兩個底線字元）。該詞保留以用於解析來自動態物件的 JSON。
• 您可以使用 Snippet 動作進行 API 調用。最大回應大小為 32KB。這與 REST API 動作中的回應大小限制一致。嚴格執行該限制，以防止叢集不穩定和服務中斷。如果可以，請使用REST APIaction代替。此動作具有相同的限制，但可以處理更大的負載。如果必須使用 SNIPPET動作，請按照以下提示減少傳回資料的大小：

  • 篩選 API 回應中的資料。例如，如果您使用NICE報告 API 獲取聯絡人，您可以根據聯絡人的 startDate 和 endDate 篩選結果。此 API 調用還允許您返回和限制項目的最高計數。請參閱指令碼整合附帶的 API 文件，以確定可以使用哪些篩選功能。

  • 更新 API 請求，只返回您需要的資料。例如，如果您使用 NICE報告 API 獲取聯絡人資訊，您可以使用 contactId或 agentId 欄位只返回相關資料。請參閱指令碼整合附帶的 API 文件，以確定可以使用哪些資料限制。

  • 如果無法執行前述任一選項，請構建中介軟體。

支援的指令碼類型

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

輸入屬性

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

屬性	描述
Caption	輸入在指令碼中唯一標識此操作的短語。標題出現在指令碼畫布上的動作圖示下。The default is the action name.
Data	包含在 Snippet editor 中新增的自訂代碼。這可能包括多個 ASSIGN和 DYNAMIC 命令、各種流程控制語句以及內置和使用者定義的函數。
MaxStringSize	設定 Data 屬性中所有命令的最大字串大小。選項包括：Limit2K、Limit4K、Limit8K、Limit16K、Limit32K。此限制適用於與 Rest API 和 SOAP 的整合回應。

結果分支條件

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

條件	描述
Default	指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。如果沒有定義動作的其他分支，也會採用該路徑。
OnError	動作未能正確執行時採用的路徑。例如，當出現連接不良、語法錯誤等意外問題時。_ERR變數（帶有一個下畫線字元）應填入針對問題的簡要說明。

貼士與技巧

• 在 Snippet動作中使用 asjson() 函數，並將產生的 JSON 儲存在字串變數中。當您需要傳遞 JSON 資料時，在其他Studio動作的屬性中使用該字串變數。這種方法避免了在儲存指令碼時出現驗證錯誤的可能性。
• 如果您正在調整支援 ASR 允許聯絡人透過說話、點擊手機按鍵或兩者組合的方式來回應錄音的語音提示。 的 IVR 自動電話選單，允許呼叫者透過語音命令或按鍵輸入或二者進行互動，以獲取資訊、路由至呼入語音通話或二者兼有。 系統，有一組參數可以在 snippets 中使用。
• Snippet 語言提供關鍵字命令，允許您聲明變數和物件，建立迴圈和反覆運算語句，等等。
• Studio 包含您可以在指令碼中使用的內建函數。
• 您可以建立自己的自訂函數，在 snippet 中使用。
• 您可以在 Snippet editor 視窗中 測試和除錯 snippet 程式碼。

Snippet Editor 視窗

當您按兩下 Snippet 動作時，Snippet editor 視窗就會開啟。

Snippet動作中的Snippet editor視窗有兩個標籤。這兩個標籤都允許您建立相同類型的代碼。您可以在兩個標籤之間來回切換，並在任一位置編輯代碼。這些標籤是：

• 文字視圖標籤。這是一個自由格式文字欄位，您可以在此手動鍵入代碼。
• 樹狀視圖標籤。這是一個圖形介面，您可以用它來構建代碼。此標籤有一個清單，您可以從中選擇關鍵字，為 snippet 新增語句。

指令碼範例

在這個簡單的範例中，Snippet中的代碼用於測試是否可以使用來自第三方系統的資訊建立潛在客戶。

下載此指令碼。