Indicate

This help page is for Desktop Studio. This information is also available for CXone Studio.

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

Double-click the action to open a configuration wizard.

相依性

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

  • MAX 基於 ActionType 為所有指標使用一組預先定義的圖像。 使用 MAX 指定帶有 ImageFile 屬性的圖像，這不會變更客服專員看到的圖像。

支援的指令碼類型

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

通用

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

類似動作比較

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

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

輸入屬性

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

屬性

描述
Target

從下拉式清單中選擇接收者類型： Agents、Team、Skill、Everyone、Contact。 Everyone 選項已被棄用。
TargetIDs

目標的 ID，如客服專員 ID 或技能 ID。
Name

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

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

在 Salesforce Agent 或 Salesforce Agent Lightning 中使用 Indicate 動作時需要此屬性。

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

當滑鼠游標暫留在指示器圖示或文字上時出現的文字。
State

用於確定是否顯示指示器的On或Off下拉式清單。 通常，您需要兩個同名的indicate 動作：一個啟用按鈕，另一個停用按鈕。
ActionType
  • RunExe: Runs a local executable. This option uses a Java plugin that only works with Internet Explorer, which CXone does not support: do not select this option. This requires a local executable that resides in the Windows path or with the full path entered in the ActionValue field. The file path must include double back slashes (\\) in the path. For example, C:\\Program Files\\CXone\\studio.exe. Most modern browsers do not support running executable programs. If you want to use this type, ensure that your agents use a compatible browser.
  • OpenURL: Opens a default web browser to the URL specified in the ActionValue field.
  • SpawnScript: Spawns a script specified in the ActionValue field and passes parameters.
  • SignalScript: Signals a script specified in the ActionValue field and passes parameters.
  • ShowCustomForm: Launches a custom HTML form created in Studio. The captured data from the custom form will trigger the ONDATA event in the script.
ActionValue

指定的 ActionType 所需的值。 在此屬性中，變數可以用大括號 ( { } ) 括起來。

  • RunExe：Windows 可執行檔案的名稱或路徑。 檔案路徑中必須包含雙反斜線 (\\)。 例如，C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}。
  • OpenURL ：必須是完整網域名稱和 URL。 支援查詢字串參數。 例如 http://www.example.com/file.asp?ANI={ANI}。 您還可以自訂 MAX 介面中彈出顯示的標籤標題，只需將 icAgentPanelTitle= 參數附加至 URL 即可。
  • SpawnScript ：您要建置的指令碼名稱。 名稱必須為指令碼的完整路徑（從執行中指令碼的當前目錄獲取）。 指令碼建置參數 SkillID 是必填項。 指令碼在沒有 ACD 技能 ID 的情況下無法建置。
  • SignalScript ：您要傳輸的執行中指令碼的 ID。 您一般要建置一個相關的指令碼，可以使用 {ContactID} 來傳輸當前指令碼。 使用 {MasterID} 傳輸上層指令碼，或使用類似於 {SpawnID} 的參數來傳輸子指令碼。
  • ShowCustomForm ：此欄位允許您建立自訂 HTML 表單。 您可以使用現代瀏覽器支援的 HTML 和 CSS。 可以使用任何標準表單輸入欄位，包括輸入、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 時，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)">

    • Some characters used in HTML and CSS are interpreted as code, such as double quotes. To get around this, use the .char() function to add the character where it belongs. For example:

      //The double quotes in the HREF tag cause a problem:
      ASSIGN html = "ASSIGN html = "<a href="https://www.w3schools.com">Visit W3Schools</a>""
      //To get around that, replace those double quotes with the char equivalent:
      ASSIGN html = "ASSIGN html = "<a href={char(34)}https://www.w3schools.com{char(34)}>Visit W3Schools</a>"

結果分支條件

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

條件

描述

Default

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

OnError

動作未能正確執行時採用的路徑。 例如，當出現連接不良、語法錯誤等意外問題時。 _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 檔案中包含一個產生的指令碼的例子。

下載此指令碼。