預先定義的變數

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

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

檢視指令碼中的預設變數

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

1. 在 CXone Mpower 中，點擊應用程式選擇器 並選擇全通路路由 > Studio 。
2. 在「指令碼」頁面中，找到並按兩下以開啟您要處理的指令碼或建立新的指令碼。 指令碼在新標籤頁中打開。
3. 點擊追踪 > 從追踪開始。
4. 選擇呼入電話ACD技能。
5. 選擇模擬呼入通話。
6. 輸入您希望指令碼撥打的Phone Number。 這必須是您在測試期間可以接聽的電話的號碼。 這條線表示呼叫貴組織的聯絡人。
7. 輸入此通道的 DNIS。 這是聯絡人為聯絡您的組織而撥打的號碼。 您可以將您可以存取的另一部電話的電話號碼用作該號碼。 這條線表示客服專員分支 您與CXone Mpower進行音訊連接以完成通話和語音郵件。。
8. 輸入 ANI。 ANI 是電話號碼，作為來電的呼叫者 ID。 它可以與Phone Number欄位中使用的號碼相同。
9. 點擊 Start Trace。
10. 當您的電話鈴聲響起時，接聽電話，並執行測試指令碼所需的動作。 例如，如果測試 IVR，您可能需要多次重複這些步驟來測試每個選單選項。

11. 在「追蹤輸出」視窗中，點擊Begin動作。 Variables 標籤顯示從系統指令碼傳入指令碼的所有變數。

    檢視圖像

    

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

    如果您想看到隨著互動的進行而新增到指令碼中的其他變數，請點擊「追蹤輸出」視窗主要部分中的其他動作。

常見預定義變數

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

變數名稱	描述
__agentContactID	客服專員應用程式工作階段的工作階段 ID。
__agentId	接聽互動的客服專員 ID。 客服專員回答互動之前，該變數不包含任何值。
ANI	呼叫者的電話號碼（北美號碼計劃格式）。 這是北美電話號碼的標準格式。 e164ANI變數包含相同的號碼，但為國際格式。 該值來自電訊商。 可能的值包括Restricted和Anonymous。
busno	貴業務單元 用於管理CXone Mpower系統的技術支援、帳單和全域設定的高階組織群組。的號碼。 這是唯一識別碼的CXone Mpower 系統。 如果貴組織有多個業務單元租戶，則可以使用此值在指令碼中進行邏輯判斷。 例如，您可以在指派技能 用於基於客服專員技能、能力和知識的互動的自動化傳遞。之前檢查busno，以確保您指派的技能存在於ACD業務單元中。
contactId	每個聯絡人的唯一識別碼。 contactId 使尋找和報告特定的聯絡人成為可能。 如果建立了次要指令碼，則將建立一個新的 contactId。
city	發起呼叫的城市名稱。 對於呼入互動，該值來自聯絡人的服務提供者。 對於呼出互動，該值來自您的服務提供者。
country	由傳入或傳出電話的電話號碼字串中的國家/地區代碼（見下一項）指定的國家/地區名稱。 CXone Mpower 電話平台根據國際電信聯盟 (ITU) 的值自動產生此值，並將其傳遞到呼叫中繼資料 提供有關其他資料之資訊的資料。中。 對於呼入互動，該值來自聯絡人的服務提供者。 對於呼出互動，該值來自您的服務提供者。
countryCode	國際電訊聯盟 (ITU) 代碼，用於指定傳入電話的來源國家/地區，或傳出電話的目的地國家/地區。 此代碼出現在任何電話號碼字串的開頭，並在呼叫中繼資料中傳遞。 例如，美國的 ITU 代碼是 +1。 如需查看任何給定國家/地區的國家/地區代碼，請在 Internet 上搜尋國家/地區代碼 <country>。 根據呼叫來源的不同，其格式也可能不同。 對於呼入互動，該值來自聯絡人的服務提供者。 對於呼出互動，該值來自您的服務提供者。
DNIS	呼叫者以北美號碼計劃格式撥打的號碼。 這是北美電話號碼的標準格式。 e164DNIS變數包含相同的號碼，但為國際格式。
e164ANI e164DNIS	按照 E.164 電話格式標準格式化的 ANI 也稱為來電顯示。 顯示語音來電的電話號碼。 和 DNIS 呼入或呼出語音電話撥打的號碼。。 E.164 是用於格式化美國境外電話號碼的國際標準。
from	寄件者的電郵位址。
__httpstatuscode	從 REST APIaction 呼叫的伺服器傳回的 HTTP 狀態碼。
__httpstatusdescription	從REST API動作呼叫的伺服器傳回的 HTTP 狀態描述。
isReskill	指示當前聯絡 ID 是否已重新指派技能。 值為1 (true) 或0 (false)。
__lastStateChange	聯絡人上次更改狀態的時間戳記。 例如，當聯絡人將狀態從「佇列前」變更為「已進入佇列」時，該變數會填充到發生變更的時間戳記中。
masterId	唯一識別碼，這使得來自同一上層的所有指令碼都是可識別。 當一個指令碼從另一個指令碼產生或運行時使用。 對於上層指令碼，contactId和masterId是相同的。 對於任何下層指令碼，contactId將是一個新的唯一值，而masterId將與上層指令碼的contactId相同。 例如，當您重新處理互動時，該互動masterId與原始互動的contactId相同。 如果該互動第二次重新指派技能，重新指派技能的互動的masterId與下層指令碼的contactId相同。
__mediaServerName	媒體伺服器的名稱。 當與 CXone Mpower 技術支援時，此變數對於與伺服器相關的問題進行疑難排解很有用。 問題包括遠端延遲或電話問題等。
__POC	聯絡點 呼入聯絡人用來發起互動的入口點，如電話號碼或電郵地址。的唯一 ID。 與CXone MpowerACD 應用程式中的 ID 一致。
__SIPInvite	包含聯絡人的標頭資訊。 如果您從一個業務單元 用於管理CXone Mpower系統的技術支援、帳單和全域設定的高階組織群組。轉接呼叫，此變數包含原始呼叫的資訊。 例如，您可以從原始營業單位訪問呼叫contactID。
__Skill	特定ACD技能 用於基於客服專員技能、能力和知識的互動的自動化傳遞。的唯一識別碼。 __Skill 變數使尋找和報告特定的技能成為可能。 此值可以隨著 Reqagent action而變更。
__SkillName	ACD技能的名稱。 它與 __Skill同時存在，可隨Reqagent動作而變更。
state	呼叫者居住的美國州。 該值來自聯絡人的服務提供者。
__targetScript	系統指令碼正在啟動的指令碼。
test	請勿嘗試Snippet action之外設定或使用此變數。 否則可能會導致嚴重的後果。 它保留用於在偵錯程式碼偵錯程式碼Snippet。
to	目標電郵位址。

來自 Uptivity 的預定義變數

變數名稱	描述
_customFilter	此變數的值用作Uptivity中的ACD 門篩選器。
_user1 - _user 8	這些變數的值用於填充 Uptivity 中的使用者 1 到使用者 8 欄位。
User9	雖然User9 從技術上講，這不是一個變數，但它確實從客服專員的使用者帳戶中獲取值，特別是從自訂 1 屬性中的值中，並填充 Uptivity 中的使用者 9 欄位。
User10	雖然User10 從技術上來說不是一個變數，但它確實從客服專員的使用者帳戶中獲取值，特別是自訂 2 屬性中的值，並填充 Uptivity 中的使用者 10 欄位。
_surveyDNIS	此值是使用者建立的唯一 ID，在您建立 Uptivity 調查時指派此值，並用於確定在回呼 保留客戶在佇列中的位置，並在客戶移至佇列靠前位置時自動呼叫客戶。期間要執行的調查。
_surveyCallbackDNIS	此值是將在調查的回呼中使用的數字。 此變數僅用於 Uptivity 調查。
_surveyCallbackANI	該值是用於調查的回呼期間將顯示的呼叫者 ID。 此變數僅用於 Uptivity 調查。