사전 정의된 변수

이 도움말 페이지의 정보는 CXone Studio 및 Desktop Studio에 모두 적용됩니다.

사전 정의된 변수는 이미 정의된 시스템 변수입니다. 만들지 않아도 스크립트에서 이를 사용할 수 있습니다. 사전 정의된 변수의 예상되는 값을 재정의할 수 있지만 권장하지 않습니다. 온라인 도움말 또는 CXone 계정 담당자에서 지시하는 경우에만 이를 재정의하십시오.

사전 정의된 변수는 자동으로 스크립트에 추가됩니다. 일부는 상호작용이 스크립트에 라우팅되기 전에 보이지 않게 실행되는 시스템 스크립트에서 가져옵니다. 이는 시스템 변수라고도 부릅니다. 다른 사전 정의된 변수는 스크립트에 추가한 작업에서 가져옵니다. 스크립트에서 변수를 확인하기 위해 추적 도구를 사용할 수 있습니다. 추적 출력에서 각 작업을 클릭해 감에 따라 변수 탭은 해당 시점의 스크립트 작업을 보여줍니다.

스크립트에서 사전 정의된 변수 보기

추적 도구를 사용하여 스크립트에서 변수를 볼 수 있습니다. 상호작용 중에 스크립트를 추적하면 전달되는 변수를 볼 수 있습니다. 이러한 변수는 시스템 스크립트와 전화 서비스 제공자 등 다른 소스에서 올 수 있습니다. 시뮬레이션된 상호작용으로 스크립트를 추적할 수 있지만 시스템 스크립트에서 전달되는 변수만을 볼 수 있습니다. 이 섹션에서는 시뮬레이션된 인바운드 통화 스크립트 추적을 설명합니다. 또한 다른 상호작용에 대한 추적 실행을 수행하여 스크립트 내에서 사전에 정의된 변수도 볼 수 있습니다.

Studio에서 스크립트를 엽니다.
스크립트 캔버스의 공백을 클릭한 다음 Properties 탭을 클릭합니다.
Inbound을(를) 클릭하여 확장하고 다음 속성을 작성합니다.
- PhoneNumber: 액세스할 수 있는 전화번호를 입력합니다.
- SimulateInbound: True을(를) 선택합니다.
- SimulationANI: PhoneNumber 속성에 사용한 것과 같은 번호를 입력합니다.
- SimulationDNIS: 다른 전화번호를 입력합니다. 실제 전화번호일 필요는 없습니다.
Studio 툴바에서 Start with Trace을(를) 클릭합니다.
전화가 울리면 받습니다. 스크립트 진행 중에 작업에 의해 추가되는 변수를 보려면 프롬프트를 따라갈 수 있습니다. 스크립트로 전달되는 시스템 변수를 보려면 끊어도 됩니다.
추적 출력 창에서 Begin 작업을 클릭합니다. Variables 탭에서는 시스템 스크립트로부터 스크립트로 전달되는 모든 변수를 표시합니다.

이미지 보기
변수를 두 번 클릭하여 변수의 이름과 그 값을 봅니다. Value 열에 맞지 않는 긴 값이 있는 변수에 유용합니다.

상호작용이 진행됨에 따라 스크립트에 추가되는 변수를 보려면 Trace Output 창의 기본 섹션에서 다른 작업을 클릭합니다.

일반적인 사전 정의된 변수

다음 테이블에는 더 자주 사용되는 사전 정의된 변수가 포함되어 있습니다. 모든 스크립트가 목록에 있는 모든 변수를 포함하지는 않습니다. 스크립트에서 사용 가능한 사전 정의된 변수는 스크립트의 미디어 유형과 스크립트에서 사용되는 작업에 따라 다릅니다. 또한, 일부 변수는 서비스 제공자에게서 기인합니다. 이러한 변수는 제공자에 따라 달라질 수 있습니다.

이 섹션의 어떤 변수든 사용하기 전에 추적 도구를 사용하여 작업 중인 스크립트에 해당 변수가 존재하는지 확인하십시오. 변수가 스크립트로 전달되지 않거나 작업에 의해 추가되지 않았을 때 스크립트 내의 사전 정의된 변수를 사용하면 스크립트가 의도한 대로 작동하지 않을 수 있습니다.

가능하면 시뮬레이션된 상호작용이 아니라 라이브 상호작용을 사용하여 스크립트 내의 변수를 확인합니다. 시뮬레이션된 상호작용에는 라이브 상호작용에 없는 변수가 포함되어 있을 수 있습니다. 이와 유사하게, 라이브 상호작용에는 시뮬레이션된 상호작용에 없는 변수가 포함되어 있을 수 있습니다.

변수 이름	설명
__agentContactID	상담원 애플리케이션 세션에 대한 세션 ID입니다.
__agentId	상호작용에 응답하는 상담원의 ID입니다. 상담원이 상호작용에 응답할 때까지는 변수에 아무 값도 포함되지 않습니다.
ANI	북미 번호 플랜 형식의 발신자가 건 전화번호입니다. 북미 지역 전화번호의 표준 형식입니다. e164ANI 변수는 같은 번호를 보유하지만 국제 형식입니다. 이 값은 전화의 통신사로부터 기인합니다. 가능한 값은 Restricted 및 Anonymous입니다.
busno	사업부 고급 조직 그룹화는 CXone 환경을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다.의 수입니다. CXone에 있는 회사의 고유 식별자입니다. 조직에서 두 개 이상의 사업부를 사용하는 경우에는 이 값을 사용하여 스크립트 내의 논리적 결정을 사용할 수 있습니다. 예를 들어 ACD 스킬 상담원 스킬, 능력 및 지식에 기반한 인터랙션의 전달을 자동화하는 데 사용됩니다.을 할당하기 전에 busno을(를) 확인하여 사업부에 존재하는 스킬을 할당하는지 확인할 수 있습니다.
contactId	각 컨택의 고유 식별자입니다. contactId을(를) 통해 특정 컨택을 찾고 보고할 수 있습니다. 신규 contactId은(는) 보조 스크립트가 생성되면 생성됩니다.
city	처음 통화가 발신된 도시의 이름입니다. 인바운드 상호작용의 경우, 이 값은 컨택의 서비스 제공자에게서 기인합니다. 아웃바운드 상호작용의 경우, 이 값은 사용자의 서비스 제공자에게서 기인합니다.
country	인바운드 또는 아웃바운드 통화의 전화번호 문자열에서 국가 코드(다음 항목 참조)로 지정된 국가의 이름입니다. CXone 전화 통신 플랫폼은 국제전기통신연합(ITU) 값에 따라 이를 자동으로 생성하고 통화 메타데이터 기타 데이터에 대한 정보를 제공하는 데이터.에 전달합니다. 인바운드 상호작용의 경우, 이 값은 컨택의 서비스 제공자에게서 기인합니다. 아웃바운드 상호작용의 경우, 이 값은 사용자의 서비스 제공자에게서 기인합니다.
countryCode	인바운드 콜의 경우 발신 국가를 지정하거나 아웃바운드 콜의 경우 목적지 국가를 지정하는 국제전기통신연합(ITU) 코드입니다. 이 코드는 전화번호 문자열의 시작 부분에 나타나며 통화 메타데이터에 전달됩니다. 예를 들어 미국의 ITU 코드는 +1입니다. 특정 국가의 국가 코드를 보려면 인터넷에서 국가 코드<country>를 검색하십시오. 형식은 발신자의 위치에 따라 달라질 수 있습니다. 인바운드 상호작용의 경우, 이 값은 컨택의 서비스 제공자에게서 기인합니다. 아웃바운드 상호작용의 경우, 이 값은 사용자의 서비스 제공자에게서 기인합니다.
DNIS	발신자가 건 전화는 북미 번호 플랜 형식입니다. 북미 지역 전화번호의 표준 형식입니다. e164DNIS 변수는 같은 번호를 보유하지만 국제 형식입니다.
e164ANI e164DNIS	E.164 전화 형식 표준에 따라 형식이 지정된 ANI 발신자 ID라고도 합니다. 들어오는 음성 통화의 나열된 전화번호입니다. 및 DNIS 인바운드 음성 통화를 위해 연결된 컨택 수와 상담원 또는 아웃바운드 음성 통화에서 연결된 시스템 수를 확인합니다.입니다. E.164는 미국 외 지역의 전화번호 형식 표준입니다.
from	발송자의 이메일 주소입니다.
isReskill	현재 컨택 ID가 리스킬되었는지를 나타냅니다. 값은 1(참) 또는 0(거짓)입니다.
__lastStateChange	컨택이 마지막으로 상태를 변경한 때의 타임 스탬프입니다. 예를 들어 컨택이 사전 대기 전 상태를 대기 중 상태로 변경하면 이 변수는 해당 변경이 적용된 시간의 타임스탬프로 채워집니다.
masterId	같은 상위 항목에서 기인하여 식별되도록 모든 스크립트를 활성화하는 고유 식별자입니다. 한 스크립트가 생성되거나 다른 것에서 실행될 때 사용됩니다. 상위 또는 스크립트의 경우 contactId 및 masterId은(는) 동일합니다. 모든 하위 스크립트의 경우 contactId은(는) 새로운 고유 값이며, masterId은(는) 상위 스크립트의 contactId과(와) 동일한 값입니다. 예를 들어 상호작용을 리스킬할 때는 리스킬된 상호작용의 masterId은(는) 원래 상호작용의 contactId과(와) 동일합니다. 상호작용이 두 번째로 리스킬되면 새롭게 리스킬된 상호작용의 masterId은(는) 하위 스크립트의 contactId과(와) 동일합니다.
__mediaServerName	미디어 서버의 이름입니다. 이 변수는 NICE CXone 기술 지원 작업 중에 서버 관련 문제를 해결할 때 유용합니다. 원격 지연 시간 또는 전화 문제 등의 항목을 포함합니다.
__POC	컨택 포인트 인바운드 컨택이 인터랙션을 개시하는 데 사용되는 진입점(예: 전화번호, 이메일 주소)입니다.의 고유 ID입니다. CXone ACD 애플리케이션에서 ID를 맞춥니다.
__SIPInvite	컨택에 대한 헤더 정보가 포함됩니다. 하나의 사업부 고급 조직 그룹화는 CXone 환경을 위해 기술 지원, 청구 및 글로벌 설정을 관리하는 데 사용됩니다.에서 통화를 전환하는 경우 이 변수에는 원래 통화에 관한 정보가 포함됩니다. 예를 들어 원래 에게서 통화의 contactID에 액세스할 수 있습니다.
__Skill	특정 ACD 스킬 상담원 스킬, 능력 및 지식에 기반한 인터랙션의 전달을 자동화하는 데 사용됩니다.에 대한 고유 식별자입니다. __Skill 변수를 사용하여 특정 스킬을 찾고 보고할 수 있습니다. 이 변수는 Reqagent 작업과 함께 변화할 수 있습니다.
_SkillName	ACD 스킬의 이름입니다. __Skill을(를) 동반하며, Reqagent 작업과 함께 변화할 수 있습니다.
state	발신자가 소재한 미국 내의 주입니다. 이 값은 컨택의 서비스 제공자에게서 기인합니다.
test	Snippet 작업 외부에서 이 변수를 설정하려고 시도하지 마십시오(CXone Studio의 도움말 페이지: 작업). 이렇게 하면 심각한 결과를 초래할 수 있습니다. 이는 Snippet 작업에서 코드를 디버깅할 목적으로 예약됩니다.
to	대상 이메일 주소입니다.

Uptivity의 사전 정의된 변수

변수 이름	설명
_customFilter	이 변수에 대한 값은 NICE Uptivity에서 ACD 게이트 필터로 사용됩니다.
_user1 - _user 8	이 변수에 대한 값은 NICE Uptivity에서 User 1~User 8 필드를 채우는 데 사용됩니다.
User9	User9은(는) 엄밀히 말하여 변수는 아니지만 상담원의 사용자 계정, 특히 사용자 정의 1 속성의 값이며 NICE Uptivity에서 User 9 필드를 채웁니다.
User10	User10은(는) 엄밀히 말해 변수는 아니지만 상담원의 사용자 계정, 특히 사용자 정의 2 속성의 값이며 NICE Uptivity에서 User 10 필드를 채웁니다.
_surveyDNIS	이 값은 사용자가 생성한 고유 ID로 NICE Uptivity 설문조사를 작성할 때 할당되며 콜백 고객이 대기열에 있고 고객이 대기열 앞으로 이동하면 고객을 자동으로 호출합니다. 중에 실행할 설문조사를 결정하는 데 사용됩니다.
_surveyCallbackDNIS	이 값은 설문조사의 콜백에 사용할 숫자입니다. 이 변수는 NICE Uptivity 설문조사에서만 사용할 수 있습니다.
_surveyCallbackANI	이 값은 설문조사에 사용된 콜백 중에 표시되는 발신자 ID입니다. 이 변수는 NICE Uptivity 설문조사에서만 사용할 수 있습니다.