Indicate

此説明頁面適用於 Studio。 此資訊也可用於 Desktop Studio。

使用自訂功能擴展客服專員介面，尤其是客服專員點擊以啟動自訂功能的圖示。 客服專員介面上的這些圖示可用於執行指令碼或向指令碼發出訊號、開啟 URL 或構建基於 Web 的基本表單以及處理其資料。

相依性

  • 指令碼中的指示器也必須關閉，否則在聯絡結束後它將繼續顯示在客服專員介面。 通常使用 2 個 Indicate 動作，其中一個開啟按鈕，另一個關閉按鈕。
  • 由於 Indicate 動作高度靈活，因此務必要非常仔細地編寫指令碼並進行全面測試。
  • 確保與 Image File 屬性一起使用的連結有效。 中斷連結會給您的CXone Mpower伺服器帶來嚴重的性能問題。

  • MAX基於Action Type，對所有指標使用一組預定義的圖像。 使用 指定具有 Image FileMAX 屬性的圖像不會改變客服專員看到的圖像。

支援的指令碼類型

一個正方形，其上有一條通往其他三個正方形的分支線。

通用

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

類似動作比較

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

  • Runapp：從指令碼啟動自訂功能，特別是啟動表單、網頁或應用程式。
  • PopURL：打開網頁 URL，並為網頁彈出的面板提供位置和樣式選項。
  • Indicate：使用自訂功能擴展客服專員介面，尤其是客服專員點擊以啟動自訂功能的圖示。 這與 Runapp 類似，不同之處在於，對於 Indicate，Action Type 是由指令碼而不是客服專員啟動。

輸入屬性

這些屬性定義了動作執行時使用的資料。 此動作的所有屬性都接受變數替換。 為此，請在屬性欄位中輸入變數。 將變數用大括號 ( { } ) 括起來。

此動作的某些屬性名稱會在您配置時動態變化。 例如，如果您選擇客服專員作為目標，下一個欄位從聯絡 ID 變更為客服專員 ID。

屬性

描述

Add Caption

輸入在指令碼中唯一標識此操作的短語。 標題出現在指令碼畫布上的動作圖示下。

Target

從下拉式清單中選擇接收者類型：Agents、Team、Skill、Everyone 或 Contact。 預設為 Contact。 Everyone 選項已被棄用。 請勿選擇。

Contact ID、Agent ID、Team、Skill、Name

目標的 ID，如客服專員 ID 。此屬性的名稱因您選擇的Target而異。
Name

此屬性是用於標識值的名稱或金鑰。 這可以是任何名稱或數字。 名稱不區分大小寫。若您在使用多個 Indicate 動作，此名稱用來追蹤哪個 Indicate 動作被開啟或關閉。
State

用於確定是否顯示指示器的On或Off下拉式清單。 通常，您需要兩個同名的indicate 動作：一個啟用按鈕，另一個停用按鈕。
Image File

在CXone Mpower檔案伺服器上，在租戶Closed 用於管理 CXone Mpower 環境的技術支援、計費和全域設定的高級組織分組目錄下圖像檔案的 URL 這是客服專員將點擊的圖像。 檔案必須是 GIF、JPG 或 PNG 格式，大小為 16x16 像素。在 Salesforce Agent 或 Salesforce Agent Lightning 中使用 Indicate 動作時需要此屬性。

警告 Image File 的中斷連結可能導致相關租戶出現嚴重的性能問題。 在使用自訂圖示時，請務必驗證連結是否準確。
Tool Tip

當滑鼠游標暫留在指示器圖示或文字上時出現的文字。
Action Type
  • Run Exe：執行本機可執行檔。 此選項使用了僅適用於 Internet Explorer 的 Java 外掛程式，而 CXone Mpower 不支援該瀏覽器：不要選擇此選項。 在 URL 欄位中輸入可執行文件的路徑。
  • Open URL：開啟一個預設網頁瀏覽器並轉至 URL 欄位中指定的 URL。
  • Spawn Script：產生在 Script Name 欄位中指定的指令碼，並傳遞指定的 Skill # 和 Parameters。
  • Signal Script：向Contact ID欄位中的 ID 指定的指令碼發出信號，並傳遞 Parameters。
  • Show Custom Form：啟動自訂 HTML 表單。 將用於表單的 HTML 代碼貼上到HTML屬性中。 從自訂表單中擷取的資料觸發指令碼中 ONDATA 事件動作。
URL

指定要開啟的 URL。 只有當您選擇 Open URL 或 Run Exe 作為 Action Type 時，此屬性才會出現。

對於打開 URL，您必須使用完全合格的網域名稱和 URL。 支援查詢字串參數。 例如 http://www.example.com/file.asp?ANI={ANI}。 您還可以自訂 MAX 介面中彈出顯示的標籤標題，只需將 icAgentPanelTitle= 參數附加至 URL 即可。

對於運行 Exe，您必須使用本地執行檔，該執行檔位於 Windows 路徑中，或在URL欄位中輸入完整路徑。 檔案路徑中必須包含雙反斜線 (\\)。 例如 C:\\Program Files\\CXone Mpower\\studio.exe。 如今大部分瀏覽器都支援執行可執行程式。 如果您要使用此類型，請確保客服專員使用相容的瀏覽器。
Script Name

輸入要產生的指令碼的完整路徑和名稱。 只有當您選擇 Spawn script 作為 Action Type 時，此屬性才會出現。

路徑必須是從目前指令碼所在的資料夾開始的相對路徑。 例如，如果指令碼在同一資料夾中，請輸入指令碼名稱。 如果指令碼在當前指令碼位置的子資料夾中，請指定路徑和指令碼名稱。 例如，/子資料夾/ScriptName。

您必須同時指定 Skill#。 這將會傳送到產生的指令碼中。 您可以指定任何其他要傳遞到再生指令碼中的Parameters。
Skill#

輸入 ACD 技能的編號，以傳入所產生的指令碼。 只有當您選擇 Spawn script 作為 Action Type 時，此屬性才會出現。

您還必須指定要產生的 Script Name。 您可以指定要傳入指令碼的任何其他 Parameters。
Contact ID

輸入要傳送訊號的指令碼 ID。 只有當您選擇 Signal script 作為 Action Type 時，此屬性才會出現。

預設情況下，此屬性將使用 {contactId} 變數。 您可以使用 {masterID} 傳輸上層指令碼，或使用類似於 {spawnID} 的參數來傳輸子指令碼。
Parameters

指定任何其他參數，以傳送至產生的指令碼或已訊號化的指令碼。 僅當您選擇Spawn script或Signal script作為動作類型時，才會顯示該屬性。

新增參數是可選的。
Html

輸入要啟動的自訂表單的 HTML。 只有當您選擇 Show Custom Form 作為 Action Type 時，此屬性才會出現。

您可以使用任何標準的表單輸入欄位，包括Input、Textarea、Password、Checkbox、Radio、Select、Button 和 Submit。 但是，請勿包含 <form> 標記。 新增欄位時：

  • 每個輸入欄位必須包含名稱。 沒有名稱的欄位將被忽略。 例如，<input type="text" name="phone">。 可使用 Ondata 動作將名稱和值作為變數傳回指令碼。 如果指令碼缺少 Ondata 動作，則該表單將無用。 支援多個值的表單欄位（如 Checkbox 和 Select）將含有一個以逗號分隔的陣列。
  • 可使用多個同名或不同名的「提交」按鈕，任何「提交」按鈕都可提交資料並關閉視窗。 如果您需要某個按鈕不進行提交，則使用「按鈕」而不要使用「提交」。
  • 不支援連結的樣式表，但支援內嵌樣式。 例如，<div style="position: absolute; left: 10px; top: 100px;">。

  • 當連結至某個外部指令碼時，JavaScript 將會工作，但內容必須是 HTTPS 以避免錯誤。 範例：

    <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)">

結果分支條件

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

條件

描述

Default

指令碼未能滿足需要它採用其中一個分支的條件時採用的路徑。 如果沒有定義動作的其他分支，也會採用該路徑。

Error

動作未能正確執行時採用的路徑。 例如，當出現連接不良、語法錯誤等意外問題時。 _ERR變數（帶有一個下畫線字元）應填入針對問題的簡要說明。

貼士與技巧

支援 Fieldset 和 Legend，以便以更可讀的方式佈局表單。 內置樣式可應用於 HTML 實體。 範例：

<fieldset>
	<legend>Gender:</legend>
	<input type="radio" name="gender" value="male"/>Male
	<input type="radio" name="gender" value="female"/>Female<br/>
</fieldset>

指令碼範例

下面是一個範例，說明如何在指令碼中使用此動作。 這不是一個完整的指令碼。 可能需要額外的指令碼。

此範例演示如何整合 Indicate 動作至指令碼。 其中包括如何將不同類型的資料傳遞給產生的指令碼的範例。 在可下載的 ZIP 檔案中包含一個產生的指令碼的例子。 下面是一個範例，說明如何在指令碼中使用此動作。 這不是一個完整的指令碼。 可能需要額外的指令碼。

下載此指令碼。