預先定義的變數

本説明頁面上的資訊同時適用於 CXone StudioDesktop Studio

預定義變數是已經定義的系統變數。您可以在指令碼中使用它們,而無需建立它們。可以覆寫預定義變數的預期值,但不建議這樣操作。只有在線上說明或 CXone 客戶代表 指示您覆寫這些內容的情況下才可覆寫。

預定義的變數是自動新增到指令碼中。有些是來自於系統指令碼,這些指令碼在互動被路由到您的指令碼之前在幕後運行。這些也被稱為系統變數。其他的預定義變數來自於您新增到指令碼中的動作。您可以使用追蹤工具來查看指令碼中的變數。當您點擊追蹤輸出中的每個動作時,「變數」標籤會顯示該點的指令碼中的動作。

檢視指令碼中的預設變數

您可以使用追蹤工具檢視指令碼中的變數。如果在互動過程中追蹤指令碼,就可以看到傳入指令碼的變數。這些變數來自系統指令碼和其他來源,如電話服務提供者。您可以透過模擬互動追蹤指令碼,但只能看到從系統指令碼傳入的變數。本節介紹如何追蹤模擬呼入電話指令碼。您還可以透過在其他互動上運行追蹤來檢視指令碼中的預定義變數。

  1. Studio 中,打開一個指令碼。
  2. 點擊指令碼畫布上的空白處,然後點擊Properties標籤。
  3. 點擊Inbound展開,然後完成以下屬性:

    • PhoneNumber:輸入您可以存取的電話號碼。
    • SimulateInbound:選擇True
    • SimulationANI:輸入與用於PhoneNumber屬性相同的數字。
    • SimulationDNIS:輸入另一個電話號碼。不必是真實電話號碼。
  4. Studio工具列中,點擊Start with Trace
  5. 當電話鈴聲響起時,請接聽電話。如果您想檢視指令碼中由後續動作新增的變數,可以根據提示進行操作。如果您想檢視傳入指令碼的系統變數,可以掛斷。
  6. 在「追蹤輸出」視窗中,點擊Begin動作。Variables 標籤顯示從系統指令碼傳入指令碼的所有變數。

  7. 點擊兩下變數可檢視變數名稱及其值。如果變數的值較長,無法在Value欄中顯示,這項功能會很有用。

    如果您想檢視隨著互動的進行新增到指令碼中的其他變數,請點擊Trace Output 視窗主窗格中的其他動作。

常見預定義變數

下表包含了一些比較常見的預定義變數。不是每個指令碼都會包含清單中的所有變數。指令碼中可用的預定義變數取決於指令碼的媒體類型和指令碼中使用的操作。此外,一些變數來自服務提供者。這些變數可能因提供者而異。

在使用本節中的任何變數之前,請使用追蹤工具驗證這些變數是否存在於您正在處理的指令碼中。在指令碼中使用預定義變數時,如果該變數沒有傳入指令碼或由動作新增,則可能導致指令碼無法按您的意圖運行。

在可能的情況下,使用即時互動而不是模擬互動來驗證指令碼中的變數。模擬互動可能包含即時互動未包含的變數。同樣,即時互動可能包含模擬互動未包含的變數。

變數名稱 描述
__agentContactID 客服專員應用程式工作階段的工作階段 ID。
__agentId 接聽互動的客服專員 ID。客服專員回答互動之前,該變數不包含任何值。
ANI

呼叫者的電話號碼(北美號碼計劃格式)。這是北美電話號碼的標準格式。e164ANI變數包含相同的號碼,但為國際格式。

該值來自電訊商。可能的值包括RestrictedAnonymous

busno

業務單位Closed 用於管理 CXone 環境的技術支援、計費和全域設定的高級組織分組的號碼。這是 CXone貴公司的唯一識別碼

如果貴組織有多個業務單位租戶,則可以使用此值在指令碼中進行邏輯判斷。例如,您可以在指派技能Closed 用於基於客服專員技能、能力和知識的互動的自動化傳遞之前檢查busno,以確保您指派的技能存在於ACD業務單位中。

contactId 每個聯絡人的唯一識別碼。contactId 使尋找和報告特定的聯絡人成為可能。如果建立了次要指令碼,則將建立一個新的 contactId
city 發起呼叫的城市名稱。

對於呼入互動,該值來自聯絡人的服務提供者。對於呼出互動,該值來自您的服務提供者。

country

由傳入或傳出電話的電話號碼字串中的國家/地區代碼(見下一項)指定的國家/地區名稱。CXone 電話平台根據國際電信聯盟 (ITU) 的值自動產生此值,並將其傳遞到呼叫元資料Closed 提供有關其他資料之資訊的資料。中。

對於呼入互動,該值來自聯絡人的服務提供者。對於呼出互動,該值來自您的服務提供者。

countryCode

國際電訊聯盟 (ITU) 代碼,用於指定傳入電話的來源國家/地區,或傳出電話的目的地國家/地區。此代碼出現在任何電話號碼字串的開頭,並在呼叫中繼資料中傳遞。例如,美國的 ITU 代碼是 +1。如需查看任何給定國家/地區的國家/地區代碼,請在 Internet 上搜尋國家/地區代碼 <country>。根據呼叫來源的不同,其格式也可能不同。

對於呼入互動,該值來自聯絡人的服務提供者。對於呼出互動,該值來自您的服務提供者。

DNIS 呼叫者以北美號碼計劃格式撥打的號碼。這是北美電話號碼的標準格式。e164DNIS變數包含相同的號碼,但為國際格式。

e164ANI

e164DNIS

按照 E.164 電話格式標準格式化的 ANIClosed 也被稱為呼叫者 ID。顯示語音來電的電話號碼。DNISClosed 識別聯絡人為聯絡您進行呼入語音通話而撥打的號碼,以及客服專員或系統在進行呼出語音通話時撥打的號碼。。E.164 是用於格式化美國境外電話號碼的國際標準。
from 寄件者的電郵地址。
isReskill 指示當前聯絡 ID 是否已重新指派技能。值為1 (true) 或0 (false)。
__lastStateChange 聯絡人上次更改狀態的時間戳記。例如,當聯絡人將狀態從「佇列前」變更為「已進入佇列」時,該變數會填充到發生變更的時間戳記中。
masterId

唯一識別碼,這使得來自同一上層的所有指令碼都是可識別。當一個指令碼從另一個指令碼產生或運行時使用。對於上層指令碼,contactIdmasterId是相同的。對於任何下層指令碼,contactId將是一個新的唯一值,而masterId將與上層指令碼的contactId相同。

例如,當您重新處理互動時,該互動masterId與原始互動的contactId相同。如果該互動第二次重新指派技能,重新指派技能的互動的masterId與下層指令碼的contactId相同。

__mediaServerName 媒體伺服器的名稱。在與NICE CXone技術支援部門合作時,該變數對排除伺服器相關問題非常有用。問題包括遠端延遲或電話問題等。
__POC 聯絡點Closed 呼入聯絡人用來發起互動的入口點,如電話號碼或電郵地址。的唯一 ID。與CXoneACD 應用程式中的 ID 一致。
__SIPInvite 包含聯絡人的標頭資訊。如果您從一個業務單位Closed 用於管理 CXone 環境的技術支援、計費和全域設定的高級組織分組轉接呼叫,此變數包含原始呼叫的資訊。例如,您可以從原來的 存取呼叫的contactID
__Skill

特定ACD技能Closed 用於基於客服專員技能、能力和知識的互動的自動化傳遞的唯一識別碼。 __Skill 變數使尋找和報告特定的技能成為可能。該值可透過Reqagent動作進行變更。

_SkillName ACD技能的名稱。它與 __Skill同時存在,可隨Reqagent動作而變更。

state 呼叫者居住的美國州。該值來自聯絡人的服務提供者。
test 不要嘗試在Snippet 動作CXone Studio中的說明頁面:動作之外設定此變數。否則可能會導致嚴重的後果。專門為Snippet動作中的偵錯程式碼保留。
to 目標電郵地址。

來自 Uptivity 的預定義變數

變數名稱 描述
_customFilter

此變數的值被用作 NICE Uptivity 中的 ACD Gate 篩選器

_user1 - _user 8

這些變數的值用於填入 NICE Uptivity 中的 User 1 至 User 8 欄位

User9

雖然 User9 在技術上不是一個變數,但它確實從客服專員的使用者帳戶中獲取其值,特別是 Custom 1 屬性中的值,並在 NICE Uptivity 中填入 User 9 欄位。

User10 雖然 User10 在技術上不是一個變數,但它確實從客服專員的使用者帳戶中獲取其值,特別是 Custom 2 屬性中的值,並在 NICE Uptivity 中填入 User 10 欄位。
_surveyDNIS

是使用者建立的唯一 ID,於建立 NICE Uptivity 調查時指派,並用於確定在回呼Closed 保留客戶在佇列中的位置,並在客戶移至佇列靠前位置時自動呼叫客戶。期間運行哪個調查。

_surveyCallbackDNIS

此值是將在調查的回呼中使用的數字。此變數僅用於 NICE Uptivity 調查。

_surveyCallbackANI

該值是用於調查的回呼期間將顯示的呼叫者 ID。此變數僅用於 NICE Uptivity 調查。