이 문서에서는 모든 음성 통화가 끝날 때 UJET에서 내보내는 JSON 문서인 통화 세션 메타데이터 레코드의 스키마를 제공합니다. UJET은 레코드를 세션 종료 명령어의 본문으로 CRM 통합에 전달하고 레코드를 외부 스토리지 구성에 metadata.json 파일로 작성합니다. 각 호출은 정확히 하나의 레코드를 생성합니다. 최상위 id는 각 레코드를 고유하게 식별합니다. 이 스키마를 사용하여 레코드를 다운스트림 시스템으로 수집하거나, 수신된 페이로드를 검증하거나, 필드를 데이터 웨어하우스 열에 매핑합니다.
스키마 루트
통화 세션 메타데이터 레코드는 음성 통화 세션을 나타내는 단일 JSON 객체입니다. 최상위 수준의 세 가지 개념이 레코드의 ID와 모양을 결정합니다.
기본 키 — id (정수)
최상위 id는 테넌트 내에서 통화 세션을 고유하게 식별합니다. 통화당 하나의 레코드가 있습니다. 다른 모든 최상위 필드, 배열, 중첩 객체는 이 id가 식별하는 호출의 속성을 설명합니다.
핸들러 구분자 — agent_info (객체, oneOf)
호출의 마지막 핸들러에 따라 모양이 달라지는 단일 객체입니다. 두 변형은 상호 배타적입니다. 레코드에는 하나의 변형만 포함됩니다.
상담사 변형: 상담사가 마지막으로 통화를 처리한 경우 표시됩니다. 공유된
id,name,avatar_url필드 외에email,first_name,last_name,agent_number를 전달합니다.가상 에이전트 변형: 가상 에이전트가 마지막으로 통화를 처리한 경우 표시됩니다.
va_alias를 전달하고email,first_name,last_name,agent_number를 생략합니다.
레코드에 포함된 변형을 감지하려면 변형별 필드가 있는지 확인하세요. 일반적으로 인간 상담사 변형의 경우 agent_info.email, 가상 상담사 변형의 경우 agent_info.va_alias입니다. 각 변형의 전체 모양은 agent 및 virtual_agent를 참고하세요.
호출 모양 식별자: call_type, session_type, session_type_v2 (문자열)
동일한 기본 통화 유형의 세 가지 병렬 뷰 레코드가 나타내는 통화 유형에 대해서는 의견이 일치하지만 통화 유형의 이름을 지정하는 데 사용하는 어휘만 다릅니다.
call_type는 기존 열거형 어휘 (예:Voice Inbound (App),Voice Outbound,Voice Internal)를 사용합니다.session_type는 항상call_type과 동일한 문자열을 반환합니다. UJET은 이 필드를 이 필드를 키로 사용하는 통합과의 하위 호환성을 위해 제공합니다.call_type의 지원 중단된 별칭으로 취급하세요. 버전 관리 및 지원 중단을 참고하세요.session_type_v2은 현재 enum 어휘를 사용합니다. 이 어휘는 더 세분화된 인바운드 구분(예: 더 광범위한Voice Inbound (App)및Voice Inbound (IVR using App)대신Voice Inbound (Mobile)및Voice Inbound (IVR using Mobile))을 사용하여call_type어휘를 확장합니다. v2 전용 값이 없는 호출 유형의 경우session_type_v2는call_type와 동일한 문자열을 반환합니다. 새 통합은session_type_v2를 파싱해야 합니다.
각 필드의 값은 핵심 정보를 참고하세요.
핵심 정보
이러한 속성은 통화의 핵심 정보를 캡처합니다.
id(정수): 각 통화 세션의 고유 식별자입니다. 이는 한 호출을 다른 호출과 구분하는 기본 키입니다.call_uuid(문자열 또는 null): 동적 통화 라우팅 (DCR) 상호작용에서 출처와 수신 테넌트 간 통화를 연결하는 고유 식별자입니다. DCR 호출의 두 레그는 동일한call_uuid값을 공유하므로 고객이 환경 간에 데이터를 연결할 수 있습니다. DCR 상호작용이 아닌 통화와 UJET에서 필드를 추가하기 전에 발생한 통화의 경우 필드가 null이거나 비어 있습니다.lang(문자열): 통화의 ISO 639 언어 코드입니다 (예: 영어의 경우 'en', 스페인어의 경우 'es'). 이 코드를 사용하면 언어별 분석 및 보고를 실행할 수 있습니다.call_type(문자열): 기존 유형 어휘를 사용하는 호출 유형입니다. 값에는 '음성 인바운드 (앱)', '음성 인바운드 (웹)', '음성 인바운드(IVR)', '음성 인바운드 (앱을 사용하는 IVR)', '음성 인바운드 (API)', '음성 인바운드(직접)', '음성 인바운드 (확장 프로그램)', '음성 예약 (앱)', '음성 예약 (웹)', '음성 예약 (API)', '음성 콜백', '음성 콜백(웹)', '음성 아웃바운드', '음성 아웃바운드 (API)', '음성 아웃바운드 (직접)', '음성 아웃바운드 (UCaaS)', '음성 내부', '음성 캠페인 (Acqueon)', '음성 캠페인 (<브랜드 이름>)', '상담사 예약 통화'가 포함됩니다.session_type(문자열): UJET에서 하위 호환성을 위해 유지하는call_type의 중복입니다 (값이 동일함). 버전 관리 및 지원 중단: 기존 중복을 참고하세요.session_type_v2(문자열): 현재 유형 어휘를 사용하는 호출 유형입니다. 더 세분화된 인바운드 구분 (예: '음성 인바운드 (앱)' 및 '음성 인바운드 (앱을 사용하는 IVR)' 대신 '음성 인바운드 (모바일)' 및 '음성 인바운드 (모바일을 사용하는 IVR)')을 사용하여call_type값을 개선합니다. 값에는 '음성 인바운드 (모바일)', '음성 인바운드 (웹)', '음성 인바운드 (IVR)', '음성 인바운드 (모바일을 사용하는 IVR)', '음성 인바운드(API)', '음성 인바운드 (직접)', '음성 인바운드 (확장 프로그램)', '음성 예약 (모바일)', '음성 예약 (웹)', '음성 예약 (API)', '음성 콜백', '음성 콜백 (웹)', '음성 아웃바운드', '음성 아웃바운드(API)', '음성 아웃바운드 (직접)', '음성 아웃바운드 (UCaaS)', '음성 내부', '음성 캠페인 (Acqueon)', '음성 캠페인 (<브랜드 이름>)', '상담사 예약 통화'가 포함됩니다.status(문자열): 통화의 현재 상태입니다. 가능한 값은 'scheduled', 'queued', 'connected', 'finished', 'failed', 'deflected'입니다. 이는 수명 주기를 통한 호출의 진행 상황을 추적합니다.created_at(문자열, date-time): UJET이 통화 레코드를 생성한 정확한 타임스탬프입니다.queued_at(문자열, 날짜-시간 또는 null): 통화가 대기열에 들어간 타임스탬프입니다. 통화가 대기열에 들어가지 않은 경우 null입니다.assigned_at(문자열, 날짜-시간 또는 null): UJET이 상담사에게 통화를 할당한 타임스탬프입니다. UJET이 통화를 할당하지 않은 경우 null입니다.connected_at(문자열, 날짜/시간 또는 null): 통화가 연결된 타임스탬프입니다.ends_at(문자열, 날짜-시간 또는 null): 통화가 종료된 타임스탬프입니다.scheduled_at(문자열, 날짜-시간 또는 null): UJET이 통화를 예약한 타임스탬프입니다. 통화가 즉시 이루어진 경우 null입니다.updated_at(문자열, 날짜-시간): UJET이 통화 데이터를 마지막으로 업데이트한 타임스탬프입니다.wait_duration(정수 또는 null): 소비자가 전체 통화에서 대기열에 소비한 총 시간(초)입니다. UJET에서 대기열 시간을 기록하지 않은 경우 null입니다. 개별 세그먼트별로 분류된 대기열 시간은queue_durations배열 (대기열 기간)을 참고하세요. 버전 관리 및 지원 중단: 대기 시간 필드 명명법을 참고하세요.call_duration(정수 또는 null): 통화의 총 시간(초)입니다.hold_duration(정수 또는 null): 소비자가 대기한 총 시간(초)입니다. 대기 시간이 없는 경우 null입니다.rating(정수 또는 null): 소비자가 제출한 고객 만족도 (CSAT) 등급입니다. 소비자가 등급을 제출하지 않은 경우 null입니다.has_feedback(불리언): 통화 후 소비자가 의견을 제공했는지 여부를 나타내는 플래그입니다.voip_provider(문자열): 통화의 VoIP 제공업체입니다. (참고: 이 필드는 지원 중단되었으며 항상 'deprecated'를 반환합니다.)out_ticket_id(문자열 또는 null): UJET이 외부 CRM 시스템에서 생성한 티켓의 ID입니다.out_ticket_url(문자열, URI 또는 null): CRM 티켓의 URL입니다.is_out_ticket_account(불리언 또는 null): CRM 티켓이 고객을 나타내는지 (true) 아니면 통화 상호작용을 나타내는지 (false) 나타냅니다.verified(불리언): 확인 스마트 작업이 상호작용을 확인했는지 여부를 나타냅니다.recording_url(문자열, URI 또는 null): 통화 녹음 파일의 URL입니다. 녹음 파일을 사용할 수 없는 경우 null입니다.recording_permission(문자열 또는 null): 소비자의 녹화 권한 상태입니다. 가능한 값: 'not_asked', 'granted', 'denied'voicemail_reason(문자열): 음성사서함의 이유입니다(해당하는 경우). 옵션에는 'not_voicemail', 'temporary_redirection', 'after_hour_deflection'이 포함됩니다.disconnected_by(문자열 또는 null): 통화를 종료한 당사자를 나타냅니다. 가능한 값:disconnected_by_unknown,disconnected_by_agent,disconnected_by_end_user,disconnected_by_virtual_agent,disconnected_by_system.fail_reason(문자열 또는 null): 통화가 실패한 이유입니다. 실패하지 않은 통화의 경우 'nothing'입니다. 가능한 값은nothing,unknown,expired,eu_canceled,eu_rejected,eu_abandoned,eu_in_menu_abandoned,eu_busy,eu_wrong_number,eu_no_answer,eu_noti_failed,ag_canceled,ag_ignored,ag_mic_no_device,ag_mic_denied,voip_twilio_error,voip_tokbox_error,voip_invalid_token,voip_conn_general,voip_conn_timeout,voip_conn_signal입니다.fail_details(문자열 또는 null): 사용 가능한 경우fail_reason와 함께 제공되는 추가적인 사람이 읽을 수 있는 세부정보입니다.adapter_fail_code(정수 또는 null): 호출 수준에서fail_reason에 해당하는 숫자 코드입니다. 호출이 실패하지 않은 경우 null입니다. 동일한 열거형이 §17의 참여자별adapter_fail_code에 사용됩니다.adapter_fail_message(문자열 또는 null):adapter_fail_code에 해당하는 사람이 읽을 수 있는 메시지입니다. 호출이 실패하지 않은 경우 null입니다.support_number(문자열 또는 null): 소비자가 고객센터에 연결하기 위해 다이얼한 전화번호입니다(E.164 형식). IVR에서 시작된 통화에 대해 채워집니다. 다른 채널의 경우 null일 수 있습니다.queue_priority_level(정수, 계정에서 대기열 우선순위가 사용 설정된 경우에만 표시됨): 통화에 할당된 대기열 우선순위입니다.
상담사 및 가상 에이전트 정보
이 섹션에서는 누가 또는 무엇이 전화를 처리했는지 설명합니다.
agent_info(객체): 이 필드는 실제 상담사 또는 가상 에이전트에 관한 정보를 보유할 수 있습니다.oneOf키워드를 사용하여 두 가지 유형 중 하나일 수 있음을 지정합니다.agent(객체): 상담사에 관한 정보입니다.id(정수): 에이전트의 고유 ID입니다.agent_number(문자열 또는 null): 에이전트에 할당된 식별자입니다.email(문자열, 이메일): 상담사의 이메일 주소입니다.name(문자열): 에이전트의 전체 이름입니다.last_name(문자열): 상담사의 성입니다.first_name(문자열): 상담사의 이름입니다.avatar_url(문자열, uri): 상담사 아바타 이미지의 URL입니다.
virtual_agent(객체): 가상 에이전트에 관한 정보입니다.id(정수): 가상 에이전트의 고유 ID입니다.name(문자열): 가상 에이전트의 이름입니다.avatar_url(문자열, URI 또는 null): 가상 상담사의 아바타 이미지 URL입니다.va_alias(문자열 또는 null): 설정한 경우 가상 상담사의 표시 이름입니다. 항상 페이로드에 표시됩니다. 별칭이 설정되지 않은 경우 null입니다.
메뉴 탐색
selected_menu(객체 또는 null): 호출 중에 소비자가 선택한 메뉴에 관한 정보입니다.id(정수): 메뉴의 고유 ID입니다.name(문자열): 메뉴의 이름입니다.parent_id(정수 또는 null): 상위 메뉴의 ID입니다(있는 경우).position(정수): 동일한 수준의 다른 메뉴에 대한 메뉴 위치입니다.deleted(불리언): 메뉴가 삭제되었는지 여부입니다.menu_type(문자열): 메뉴 유형 (예:ivr_menu또는sms_menu)hidden(불리언): 메뉴가 표시되고 사용할 수 있는지 여부입니다.
menu_path(객체 또는 null): 소비자가 탐색한 메뉴의 계층적 경로를 설명합니다.items_count(정수): 경로에 있는 메뉴 수입니다.name(문자열): 슬래시로 구분된 메뉴 이름 문자열입니다 (예: 'Support/Billing').materialized_path(문자열): 슬래시로 구분된 메뉴 ID 문자열입니다.
automation_redirection(객체, 통화의 첫 번째 전환 로그가 리디렉션 그룹과 연결된 경우에만 표시됨): 이 통화의 라우팅에 영향을 미친 비율 기반 대기열 리디렉션에 관한 세부정보입니다.percent_redirection(불리언): 소스 메뉴에서 비율 기반 리디렉션을 사용 설정했는지 여부입니다.redirection_group(배열): 리디렉션 그룹 세부정보가 포함된 단일 요소 배열입니다.group_label(문자열): 리디렉션 그룹의 사람이 읽을 수 있는 라벨입니다 (예: '리디렉션 그룹 1').destination(객체 또는 null): 그룹에 구성된 리디렉션 대상입니다.after_hours(불리언 또는 null): 그룹에서 근무 시간 외 전환 옵션을 사용 설정했는지 여부입니다.ah_destination(객체 또는 null): 그룹에 구성된 근무 시간 외 리디렉션 대상입니다.
최종 사용자 세부정보
end_user(객체 또는 null): 소비자 정보입니다.id(정수 또는 null): 소비자의 내부 ID입니다.identifier(문자열 또는 null): 소비자의 외부 식별자입니다.out_contact_id(문자열 또는 null): CRM의 소비자 ID입니다.
맞춤 데이터 및 SDK 제공 데이터
customer_flag(객체, 웹사이트에서 맞춤 인증 데이터를 전달한 경우에만 표시됨): 세션 시작 시 소비자의 앱 또는 웹사이트에서 전달한 인증 관련 맞춤 데이터 속성입니다. 페이로드에는 인증 매개변수로 지정한 하위 집합만 포함됩니다.api_dap_request(객체, 데이터 매개변수를 사용 설정하고 세션 메타데이터에 포함되도록 구성한 경우에만 표시됨): 계정의 외부 API 설정에서 구성한 대로 통화의 데이터 매개변수 값의 스냅샷입니다. 키와 값 유형은 데이터 매개변수 구성에 따라 달라집니다.form_responses(배열, 소비자가 하나 이상의 양식 응답을 제출한 경우에만 표시됨): 세션 중에 통화 내 SDK 양식이 수집한 응답입니다. 각 항목에는 다음이 포함됩니다.id(문자열 또는 정수): 양식 응답 식별자입니다.title(문자열): 소비자에게 표시되는 양식 제목입니다.smart_action_id(정수 또는 null): 양식을 트리거한 스마트 작업의 식별자입니다(있는 경우).questions(배열): 수집된 질문 및 답변 쌍입니다.
첨부파일
photos(배열): 통화 중에 소비자가 업로드한 사진입니다.id(정수): 사진의 고유 식별자입니다.photo_type(문자열): 사진의 유형 또는 소스입니다 (예: 'photo').url(문자열, uri): 저장된 사진의 URL입니다.smart_action_type(문자열 또는 null): 사진을 생성한 스마트 작업입니다(있는 경우).transfer_id(정수 또는 null): 소비자가 전송 후 사진을 업로드한 경우 사진의 전송 이벤트 ID입니다.
videos(배열): 통화 중에 소비자가 업로드한 동영상입니다.id(정수): 동영상의 고유 식별자입니다.url(문자열, uri): 저장된 동영상의 URL입니다.smart_action_type(문자열 또는 null): 동영상을 생성한 스마트 작업입니다(있는 경우).transfer_id(정수 또는 null): 소비자가 전송 후 동영상을 업로드한 경우 동영상의 전송 이벤트 ID입니다.
통화 착신전환
deflection(문자열): 통화가 리디렉션되었는지 여부와 리디렉션된 방법을 나타냅니다 (예: 'no_deflection', 'over_cap_phone', 'after_hours_voicemail').deflection_details(배열): 통화 중 전환에 관한 자세한 로그를 제공합니다. 각 항목 내의 편향 필드는 정의: 편향에 정의된 열거형을 사용합니다. 각 항목에는 다음이 포함됩니다.id(정수): 전환 로그 레코드의 고유 식별자입니다.call_id(정수): 통화의 고유 식별자입니다.transfer_id(정수 또는 null): 전환과 연결된 트랜스퍼의 고유 식별자입니다(해당하는 경우).deflection(문자열, 허용된 값은 정의: 전환 참고): 전환 유형입니다.created_at(문자열, 날짜/시간): 전환이 발생한 시점의 타임스탬프입니다.from_menu_path(객체 또는 null): 편향이 시작된 메뉴 경로입니다.to_menu_path(객체 또는 null): UJET이 통화를 리디렉션한 메뉴 경로입니다.to_sip_uri(문자열, UJET이 SIP 대상으로 통화를 전환한 경우에만 표시됨): UJET이 통화를 전환한 SIP URI입니다(해당하는 경우).to_sip_headers(객체, UJET이 SIP 대상으로 통화를 전환한 경우에만 표시됨): UJET이 통화를 전환한 SIP 헤더입니다(해당하는 경우).
전송
transfers(배열): 통화 중 트랜스퍼 이벤트당 항목 하나입니다. 상담사, 가상 상담사, 메뉴 간의 사전 안내 후 전달 및 콜드 트랜스퍼를 모두 기록합니다.id(정수): 트랜스퍼의 고유 식별자입니다.status(문자열): 전송의 현재 상태입니다 (예: transferring, connected, failed).fail_reason(문자열): 전송이 실패한 이유입니다. 실패하지 않은 경우 'nothing'입니다.created_at(문자열, 날짜-시간): 전송이 시작된 시간입니다.assigned_at(문자열, 날짜-시간 또는 null): UJET이 수신자에게 트랜스퍼를 할당한 시간입니다.connected_at(문자열, 날짜-시간 또는 null): 전송이 연결된 시간입니다.updated_at(문자열, 날짜-시간): UJET이 트랜스퍼 레코드를 마지막으로 업데이트한 시간입니다.call_duration(정수): 트랜스퍼된 세그먼트의 통화 시간(초)입니다.wait_duration(정수): 트랜스퍼 중에 소비자가 대기한 시간(초)입니다.deflection(문자열): 트랜스퍼와 연결된 전환 유형입니다(있는 경우).answer_type_path(문자열 또는 null): 트랜스퍼된 통화가 해결된 방식을 설명하는 경로입니다.from_menu_path/to_menu_path(객체 또는 null): 전송 전후의 메뉴 경로입니다. 정의의menu_path와 모양이 동일합니다.from_agent/to_agent(객체 또는 null): 트랜스퍼의 각 측면에 있는 상담사입니다. 정의의agent객체와 모양이 동일합니다.from_virtual_agent/to_virtual_agent(객체 또는 null): 트랜스퍼의 각 측면에 있는 가상 상담사입니다. 정의의virtual_agent객체와 모양이 동일합니다.from_queue_priority_level/to_queue_priority_level(정수 또는 null): 전송 전후의 큐 우선순위입니다. 계정에서 대기열 우선순위를 사용 설정한 경우에만 표시됩니다.
통화 처리 시간
handle_durations(배열): 객체의 배열로, 각각 상담사가 처리한 통화의 세그먼트를 나타냅니다. 이를 통해 상담사 처리 시간을 분석할 수 있습니다.id(정수): 핸들 기간의 고유 식별자입니다.agent_id(정수): 에이전트의 ID입니다.acw_duration(정수): 통화 후 작업 시간입니다.bcw_duration(정수): 통화 전 작업 시간입니다.call_duration(정수): 이 세그먼트의 통화 시간입니다.menu_path_id(정수 또는 null): 메뉴 경로의 ID입니다.menu_path(문자열): 메뉴 경로의 이름입니다.lang(문자열): 사용된 언어입니다.barged(불리언): 관리자가 통화에 끼어들었는지 여부입니다.transfer(불리언): 트랜스퍼가 발생했는지 여부입니다.transfer_id(정수 또는 null): 트랜스퍼의 ID입니다.transfer_cold(불리언 또는 null): 트랜스퍼가 콜드 트랜스퍼인지 여부입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.ended_at(문자열, 날짜/시간 또는 null): 종료 타임스탬프입니다.scheduled_at(문자열, 날짜-시간 또는 null): 예약된 타임스탬프입니다.hold_duration(정수 또는 null): 이 세그먼트의 대기 시간입니다.assigned_connection_duration(정수): 이 단계에서 상담사가 연결되는 동안 소비자가 기다린 시간입니다.session_breakthrough(객체, 상담사의 'Unavailable' 상태를 뚫고 통화가 연결된 경우에만 표시됨): 상담사의 'Unavailable' 상태를 뚫고 연결된 통화의 할당에 관한 세부정보입니다(해당하는 경우).
큐 지속 시간
queue_durations(배열): 소비자가 대기열에 있었던 통화의 세그먼트를 각각 나타내는 객체의 배열입니다. 이를 통해 대기 시간과 서비스 수준을 분석할 수 있습니다.id(정수): 대기열 기간의 고유 식별자입니다.agent_id(정수): 에이전트의 ID입니다.ended_at(문자열, date-time): 종료 타임스탬프입니다.lang(문자열): 사용된 언어입니다.menu_path_id(정수): 메뉴 경로의 ID입니다.menu_path(문자열): 메뉴 경로의 이름입니다.queue_duration(정수): 큐 세그먼트의 길이입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.transfer_cold(불리언): 통화가 콜드 트랜스퍼되었는지 여부입니다.transfer(불리언): 트랜스퍼가 발생했는지 여부입니다.transfer_id(정수 또는 null): 트랜스퍼의 ID입니다.service_level_abandon_time_threshold(정수): 서비스 수준 포기의 시간 기준점입니다.service_level_event(문자열): 서비스 수준 이벤트 상태입니다 ('excluded', 'in_sla', 'not_in_sla').service_level_target_percent(정수): 서비스 수준 규정 준수의 목표 비율입니다.service_level_target_time(정수): 서비스 수준 규정 준수의 목표 시간입니다.
가상 에이전트에서 상담사로의 에스컬레이션
escalations(배열): 각 항목은 가상 에이전트에서 상담사로의 에스컬레이션을 나타냅니다.id(정수): 에스컬레이션의 고유 식별자입니다.status(문자열): 현재 상태 (예: 에스컬레이션 중, 에스컬레이션됨, 실패)입니다.reason(문자열): 세션이 에스컬레이션된 이유입니다.created_at(문자열, 날짜-시간): 에스컬레이션이 시작된 시간입니다.escalated_at(문자열, 날짜/시간 또는 null): 에스컬레이션이 완료된 시간입니다.from_virtual_agent(객체 또는 null): 통화를 에스컬레이션한 가상 상담사입니다. 정의의virtual_agent객체와 모양이 같습니다.to_agent(객체 또는 null): 통화가 에스컬레이션된 실제 상담사입니다. 정의의agent객체와 모양이 동일합니다.from_menu_path/to_menu_path(객체 또는 null): 에스컬레이션 전후의 메뉴 경로입니다.
가상 에이전트 에스컬레이션
virtual_agent_deflected_escalations(배열): 가상 에이전트에서 전환된 에스컬레이션의 세부정보입니다.id(정수): 고유 식별자입니다.deflection(문자열): 전환 유형입니다.escalation_id(정수): 에스컬레이션 이벤트 식별자입니다.escalation_reason(문자열): 에스컬레이션 이유escalated_at(문자열, 날짜-시간): 에스컬레이션 타임스탬프입니다.menu_path_id(정수): 메뉴 경로 ID입니다.menu_path(문자열): 메뉴 경로입니다.lang(문자열): 언어입니다.virtual_agent(객체): 가상 에이전트 세부정보입니다. 정의를 참고하세요.
가상 에이전트 처리 시간
virtual_agent_handle_durations(배열): 가상 상담사가 통화를 처리한 시간 세그먼트입니다.id(정수): 고유 식별자입니다.virtual_agent(객체): 가상 에이전트 세부정보입니다. 정의를 참고하세요.call_duration(정수): 세그먼트의 길이입니다.escalation_reason(문자열): 에스컬레이션 이유finish_reason(문자열): 상호작용이 종료된 이유입니다.sentiment(정수): 소비자 감정입니다.response_count(정수): 가상 에이전트 응답 수입니다.fallback_response_count(정수): 대체 응답 수입니다.initiated_by(문자열): 가상 에이전트 세션이 시작된 방식입니다.menu_path_id(정수): 메뉴 경로 ID입니다.menu_path(문자열): 메뉴 경로입니다.lang(문자열): 언어입니다.transfer(불리언): 통화가 트랜스퍼되었는지 여부입니다.transfer_id(정수 또는 null): 트랜스퍼 이벤트 식별자입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.ended_at(문자열, 날짜/시간 또는 null): 종료 타임스탬프입니다.
고객 응대 시간
consumer_handle_durations(배열): 소비자가 통화한 시간입니다.id(정수): 고유 식별자입니다.call_duration(정수): 소비자 세그먼트 기간입니다.hold_duration(정수 또는 null): 소비자 보류 기간입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.ended_at(문자열, date-time): 종료 타임스탬프입니다.
소비자 이벤트 기간
consumer_event_durations(배열): 고객 통화 이벤트 (예: CSAT 또는 결제)의 세부정보입니다.id(정수): 고유 식별자입니다.duration(정수): 이벤트 기간입니다.type(문자열): 이벤트 유형입니다.event(문자열): 이벤트 결과입니다.menu_path_id(정수): 메뉴 경로 ID입니다.menu_path(문자열): 메뉴 경로입니다.lang(문자열): 언어입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.ended_at(문자열, date-time): 종료 타임스탬프입니다.
소비자 인메뉴 지속 시간
consumer_in_menu_durations(배열): 메뉴 내 소비자 상호작용의 지속 시간입니다.id(정수): 고유 식별자입니다.duration(정수): 메뉴 내 지속 시간입니다.event(문자열): 메뉴 상호작용 결과입니다.menu_path_id(정수): 메뉴 경로 ID입니다.menu_path(문자열): 메뉴 경로입니다.lang(문자열): 언어입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.ended_at(문자열, date-time): 종료 타임스탬프입니다.
참여자
participants(배열): 통화에 참여하는 각 참여자 (예: 소비자, 상담사 또는 가상 에이전트)에 관한 정보입니다.id(정수): 참여자의 고유 식별자입니다.type(문자열): 참여자 유형입니다 ('end_user', 'agent', 'virtual_agent' 등).entry_type(문자열): 참여자가 통화에 참여한 방법입니다.user_id(정수 또는 null): 참여자가 상담사인 경우 사용자 ID입니다.end_user_id(정수 또는 null): 참여자가 소비자인 경우 소비자 식별자입니다.virtual_agent_id(정수 또는 null): 참여자가 가상 에이전트인 경우 가상 에이전트 ID입니다.virtual_agent_params(객체, 포함할 가상 에이전트 맞춤 메타데이터를 구성한 경우에만 표시됨): 가상 에이전트가 사용하는 맞춤 메타데이터입니다.status(문자열): 참여자의 상태입니다 ('waiting', 'connected', 'finished' 등).fail_reason(문자열): 실패 이유(있는 경우)connected_at(문자열, 날짜-시간 또는 null): 참여자가 연결된 타임스탬프입니다.phone_number(문자열, 소비자 참여자에게만 표시됨): 참여자의 전화번호입니다.call_id(정수): 통화의 식별자입니다.call_duration(정수 또는 null): 참여자의 통화 시간입니다.hold_duration(정수 또는 null): 참여자의 대기 시간입니다.ended_at(문자열, 날짜-시간 또는 null): 참여자의 참여가 종료된 시점의 타임스탬프입니다.adapter_fail_code(정수 또는 null): 실패 이유에 해당하는 숫자 코드입니다.adapter_fail_message(문자열 또는 null):fail_reason에 대한 사람이 읽을 수 있는 설명입니다(있는 경우).agent_assist(객체, 상담사 지원을 구성할 때 상담사 참여자에게만 표시됨): 이 참여자의 활성 상담사 지원 설정입니다.virtual_agent(객체, virtual-agent 참여자에게만 표시됨): 이 참여자 역할을 하는 가상 에이전트의 세부정보입니다. 최상위agent_info및virtual_agent_params와는 다릅니다.caller_id(문자열, 계정에서 SIP 헤더 발신번호 표시를 사용 설정한 경우에만 표시되며 소비자 참여자에게만 표시됨): UJET이 이 소비자 참여자의 인바운드 SIP 헤더에서 추출한 발신번호 표시입니다.sip_headers(객체 또는 null): 이 참여자와 연결된 SIP 헤더입니다. 항상 페이로드에 표시됩니다. UJET이 헤더를 캡처하지 않으면 null입니다.location(문자열 또는 null, 에이전트 참여자에게만 표시됨): 에이전트의 위치입니다.location_id(정수 또는 null, 에이전트 참여자에게만 표시됨): 위치 ID입니다.email(문자열, 이메일, 에이전트 참여자에게만 표시됨): 에이전트의 이메일 주소입니다.first_name(문자열 또는 null, 에이전트 참여자에게만 표시됨): 에이전트의 이름입니다.last_name(문자열 또는 null, 에이전트 참여자에게만 표시됨): 에이전트의 성입니다.middle_name(문자열 또는 null, 에이전트 참여자에게만 있음): 에이전트의 중간 이름입니다.teams(배열, 상담사 참여자에게만 표시됨): 상담사 팀의 { id, name } 객체 배열입니다.
녹화
recordings(배열): 통화 오디오 녹음에 관한 정보입니다.id(정수): 녹음 콘텐츠의 고유 식별자입니다.call_id(정수): 통화 식별자입니다.conference_sid(문자열 또는 null): VoIP 제공업체의 통화 식별자입니다.duration(정수 또는 null): 녹음 시간입니다.recording_type(문자열): 녹음 유형입니다.redaction_times(배열): 수정된 시간 세그먼트입니다.start(문자열, 날짜-시간): 수정 간격이 시작된 시간입니다.end(문자열, 날짜-시간): 수정 간격이 종료된 시간입니다.duration(정수): 수정 시간(초)입니다.start_agent_id(정수 또는 null): 수정 작업을 시작한 에이전트입니다.end_agent_id(정수 또는 null): 수정 작업을 종료한 에이전트입니다.
started_at(문자열, 날짜-시간): 녹화 시작 타임스탬프입니다.
post_processed_recordings(배열, 계정에서 후처리된 녹음을 사용 설정한 경우에만 표시됨): 후처리에서 생성된 오디오 녹음 파일 (예: 형식 변환 또는 수정)입니다.id(정수): 후처리된 녹음 파일의 고유 식별자입니다.call_id(정수): 통화 식별자입니다.duration(정수): 녹화 시간(초)입니다.started_at(문자열, 날짜-시간): 녹화 시작 타임스탬프입니다.recording_file_name(문자열): 후처리된 오디오 애셋의 파일 이름입니다.recording_url(문자열, uri): 후처리된 오디오 파일의 URL입니다.agent_id(정수 또는 문자열): 세그먼트와 연결된 에이전트의 식별자입니다.virtual_agent_id(정수 또는 문자열): 세그먼트와 연결된 가상 에이전트의 식별자입니다(있는 경우).conversation_id(문자열): 이 녹음 파일을 대화 기록과 연결하는 식별자입니다.
segments(배열, 계정에서 사후 처리된 통계 녹음을 사용 설정한 경우에만 표시됨): 시스템에서 다운스트림 통계 파이프라인을 위해 생성하는 참여자별 오디오 (선택사항인 화면 녹화) 세그먼트입니다.id(정수): 세그먼트의 고유 식별자입니다.call_id(정수): 통화 식별자입니다.duration(정수): 세그먼트 길이(초)입니다.started_at(문자열, 날짜-시간): 세그먼트 시작 타임스탬프입니다.audio_file_name(문자열): 세그먼트의 오디오 애셋 파일 이름입니다.audio_url(문자열, uri): 세그먼트의 오디오 파일 URL입니다.agent_id(정수 또는 문자열): 세그먼트와 연결된 에이전트의 식별자입니다.virtual_agent_id(정수 또는 문자열): 세그먼트와 연결된 가상 에이전트의 식별자입니다(있는 경우).participant_id(정수 또는 문자열): 세그먼트가 속한 참여자의 식별자입니다.conversation_id(문자열): 이 세그먼트를 대화 기록과 연결하는 식별자입니다.screen_recording_url(문자열, URI 또는 null): 일치하는 화면 녹화 애셋의 URL입니다. 계정에서 화면 녹화를 사용 설정한 경우에만 표시됩니다.screen_recording_file_name(문자열 또는 null): 화면 녹화의 파일 이름입니다.screen_recording_url와 동일한 조건으로 제공됩니다.
혜택 이벤트
offer_type(문자열 또는 null): UJET이 상담사에게 통화를 제공한 방식입니다.offer_events(배열): UJET이 상담사에게 통화를 제안한 경우의 이벤트입니다.casting_time(문자열, date-time): UJET에서 통화를 제안한 시간입니다.group(문자열): UJET에서 통화를 제안한 그룹입니다.
기타 세부정보
answer_type(문자열 또는 null): 통화가 해결된 방식 ('manual' 또는 'auto')입니다.outbound_number(문자열 또는 null): 사용된 아웃바운드 전화번호입니다.wait_time_sms(배열, 이 통화에서 대기 시간 SMS 상호작용이 발생한 경우에만 표시됨): 예상 대기 시간에 관해 UJET이 소비자에게 보낸 SMS 상호작용입니다. 각 항목에는 다음이 포함됩니다.transfer_id(정수 또는 null): 트랜스퍼와 연결된 경우 트랜스퍼 이벤트 식별자입니다.status(문자열): SMS 상태입니다. 가능한 값:not_triggered,triggered,triggered_allowed,triggered_denied,triggered_no_selection,triggered_sent,triggered_failed.received(불리언): 소비자가 SMS를 수신했는지 여부입니다.
in_call_sms(배열, 이 통화에서 통화 중 SMS 상호작용이 발생한 경우에만 표시됨): 통화 중 SMS 상호작용입니다. 각 항목에는 다음이 포함됩니다.transfer_id(정수 또는 null): 트랜스퍼와 연결된 경우 트랜스퍼 이벤트 식별자입니다.preset_sent(불리언): UJET이 사전 설정된 메시지를 보냈는지 여부입니다.custom_sent(불리언): 상담사가 맞춤 (자유 형식) 메시지를 보냈는지 여부입니다.received(불리언): UJET이 소비자로부터 SMS를 수신했는지 여부입니다.
dispositions(배열, 계정에서 종료 코드 또는 메모를 사용 설정한 경우에만 표시됨): 상담사가 기록한 종료 코드 및 메모입니다. 각 항목에는 마무리 구성에 따라 동적으로 렌더링된 필드가 포함됩니다.user_id(정수): 에이전트 식별자입니다.transfer_id(정수 또는 null): 트랜스퍼 후 기록된 경우 트랜스퍼 이벤트 식별자입니다.participant_id(정수): 참여자 식별자입니다.note(문자열): 자유 형식 상담사 메모입니다.original_note(문자열): 메모의 원본 (수정 전) 버전입니다.code(문자열): 처리 코드 이름입니다.ujet_code_id(정수 또는 빈 문자열): 처리 코드의 UJET ID입니다. 코드의 안정적인 키입니다 (코드 표시 이름은 변경될 수 있음). 사용할 수 없는 경우 빈 문자열입니다.list(문자열): 코드가 속한 목록의 이름입니다.list_path(문자열): 코드 목록의 슬래시로 구분된 경로입니다.ujet_list_id(정수 또는 빈 문자열): 처분 코드가 속한 목록의 UJET ID입니다. 목록의 안정적인 키입니다. 사용할 수 없는 경우 빈 문자열입니다.custom_list_id(문자열 또는 정수): 매핑된 경우 고객 정의 목록 식별자입니다.custom_code_id(문자열 또는 정수): 매핑된 경우 고객 정의 코드 식별자입니다.
email(문자열, 이메일 또는 null): 소비자 이메일 주소입니다.feedback(문자열 또는 null): 소비자 의견입니다.smart_action_text(문자열 또는 null): 실행된 스마트 작업의 텍스트입니다.custom_data_secured(객체 또는 null): 맞춤 보안 서명 데이터입니다.custom_data_not_secured(객체 또는 null): 맞춤, 보안 서명되지 않은 데이터입니다.in_queue_wait_time_va(배열, 계정에서 가상 상담사의 대기열 내 대기 시간 추적을 사용 설정한 경우에만 표시되며, 보존된 VA 에스컬레이션이 하나 이상 발생한 경우에만 표시됨): 에스컬레이션 후 UJET이 소비자를 위해 가상 상담사를 보존하는 동안 소비자가 대기열에서 대기한 시간 간격입니다. 각 항목에는 다음이 포함됩니다.start(문자열, 날짜-시간): 대기열 대기가 시작된 시간입니다.end(문자열, 날짜-시간 또는 null): 큐 대기가 종료된 시간입니다. 완료되지 않은 경우 null입니다.duration(정수 또는 null): 대기 시간(초)입니다.end이 null이면 null입니다.
auto_session_summaries(배열, 계정에서 대화 요약을 사용 설정하고 UJET에서 요약을 생성한 경우에만 표시됨): UJET이 CRM 기록에 저장하는 AI 생성 세션 요약입니다. 각 항목에는 다음이 포함됩니다.user_id(정수): 요약이 연결된 에이전트 참여자의 식별자입니다.participant_id(정수): 참여자 식별자입니다.session_summary(문자열): 요약 텍스트입니다.session_summary_sections(배열 또는 객체): 구조화된 섹션의 요약입니다(있는 경우).
sip_headers(객체, 계정에서 SIP 헤더 캡처를 사용 설정하고 세션 메타데이터에 포함되도록 구성한 경우에만 표시됨): UJET이 통화에 대해 캡처한 인바운드 SIP 헤더입니다. 키와 값은 업스트림 전화 통신 제공업체에서 수신한 SIP 헤더를 반영합니다.
정의
이 섹션에서는 각 하위 스키마를 한 번 정의합니다. 하위 스키마를 참조하는 속성 그룹은 모양을 인라인으로 재정의하는 대신 이러한 정의에 연결됩니다.
menu_path (객체)
호출이 이동한 계층적 메뉴 경로를 설명합니다. 필드의 전체 목록은 메뉴 탐색을 참고하세요.
참조 대상: 최상위 menu_path 필드, 각 transfers[].from_menu_path 및 transfers[].to_menu_path, 각 escalations[].from_menu_path 및 escalations[].to_menu_path, 각 deflection_details[].from_menu_path 및 deflection_details[].to_menu_path
agent (객체)
상담사를 설명합니다. 이 객체는 최상위 agent_info 식별자의 두 변형 중 하나입니다 (스키마 루트 참고). 필드의 전체 목록은 에이전트 및 가상 에이전트 정보를 참고하세요.
참조 대상: 상담사가 마지막으로 통화를 처리한 경우 agent_info 필드, 각 transfers[].from_agent 및 transfers[].to_agent, 각 escalations[].to_agent
virtual_agent (객체)
가상 에이전트를 설명합니다. 이 객체는 최상위 agent_info 식별자의 두 변형 중 하나입니다 (스키마 루트 참고). 필드의 전체 목록은 에이전트 및 가상 에이전트 정보를 참고하세요.
참조 대상: 가상 에이전트가 마지막으로 통화를 처리한 경우 agent_info 필드, 각 transfers[].from_virtual_agent 및 transfers[].to_virtual_agent, 각 escalations[].from_virtual_agent, 각 virtual_agent_handle_durations[].virtual_agent, 각 virtual_agent_deflected_escalations[].virtual_agent
deflection (문자열, 열거형)
통화 또는 통화 세그먼트의 전환 상태입니다. 값은 <trigger>_<destination> 명명 패턴을 따릅니다. 여기서 접두사는 전환을 트리거한 조건을 식별하고 (예: 과부하, 근무 외 시간, 임시 리디렉션) 접미사는 대상 또는 처리 (예: 음성메일, 대기열, 전화, 메시지)를 식별합니다.
일반적인 대상 유형 접미사:
_phone: 통화를 외부 전화번호로 연결합니다._voicemail: 통화를 음성사서함으로 연결합니다._message: 정보 메시지를 재생합니다._message_only- 메시지를 재생하고 추가 라우팅 없이 통화를 종료합니다._callback- 예약된 콜백을 제공합니다._wait- 발신자를 대기 상태로 유지합니다._queue- 통화를 다른 대기열에 배치합니다._sip- SIP 대상으로 통화를 라우팅합니다._extension- 전화를 확장 프로그램으로 라우팅합니다._phone_with_extension: 확장 프로그램이 있는 전화 대상에 통화를 라우팅합니다.
트리거 패밀리별로 그룹화된 허용 값:
편향 없음:
no_deflection,deflecting용량 초과: 대기열이 용량 기준점을 초과한 경우입니다.
over_cap_phone,over_cap_voicemail,over_cap_callback,over_cap_wait,over_cap_queue,over_cap_message,over_cap_sip,over_cap_extension,over_cap_phone_with_extension영업시간 외 — 통화가 메뉴에 구성된 영업시간 외에 도착한 경우:
after_hours_voicemail,after_hours_phone,after_hours_message_only,after_hours_queue,after_hours_message,after_hours_sip,after_hours_extension,after_hours_phone_with_extension임시 리디렉션 - 메뉴에서 임시 리디렉션을 구성하는 경우:
temp_redirection_phone,temp_redirection_message,temp_redirection_voicemail,temp_redirection_queue,temp_redirection_sip,temp_redirection_extension,temp_redirection_phone_with_extensionIVR 사전 세션:
ivr_presession_deflection가상 에이전트 시작 — 가상 에이전트가 통화를 리디렉션하거나 핸드오프한 경우:
va_redirection_phone,va_redirection_sip,va_third_party_phone,va_third_party_sip업무 시간 외 내부 통화:
internal_call_after_hours_message,internal_call_after_hours_queue,internal_call_after_hours_phone,internal_call_after_hours_extension,internal_call_after_hours_sip,internal_call_after_hours_voicemail.내부 통화 초과 용량:
internal_call_over_capacity_message,internal_call_over_capacity_queue,internal_call_over_capacity_phone,internal_call_over_capacity_extension,internal_call_over_capacity_sip,internal_call_over_capacity_voicemail,internal_call_over_capacity_wait.내부 통화 자동 리디렉션:
internal_call_automatic_redirection_message,internal_call_automatic_redirection_queue,internal_call_automatic_redirection_phone,internal_call_automatic_redirection_extension,internal_call_automatic_redirection_sip,internal_call_automatic_redirection_voicemail.근무 시간 외 통화 트랜스퍼:
call_transfer_after_hours_message,call_transfer_after_hours_queue,call_transfer_after_hours_phone,call_transfer_after_hours_extension,call_transfer_after_hours_sip,call_transfer_after_hours_voicemail통화 트랜스퍼 과부하:
call_transfer_over_capacity_message,call_transfer_over_capacity_queue,call_transfer_over_capacity_phone,call_transfer_over_capacity_extension,call_transfer_over_capacity_sip,call_transfer_over_capacity_voicemail,call_transfer_over_capacity_wait통화 전달 자동 리디렉션:
call_transfer_automatic_redirection_message,call_transfer_automatic_redirection_queue,call_transfer_automatic_redirection_phone,call_transfer_automatic_redirection_extension,call_transfer_automatic_redirection_sip,call_transfer_automatic_redirection_voicemail긴급 종료 - 관리자가 긴급 종료를 트리거한 경우:
emergency_shutdown,emergency_shutdown_message,emergency_shutdown_after_hours,emergency_shutdown_over_capacity동적 통화 라우팅 (DCR):
dcr_transferred,dcr_missed,dcr_redirected,dcr_finished
참조 대상: 최상위 deflection 필드, 각 deflection_details[].deflection, 각 transfers[].deflection
버전 관리 및 지원 중단
호출 세션 메타데이터 스키마는 하위 호환되는 변경을 지원합니다. UJET은 언제든지 새 필드와 배열을 추가할 수 있습니다. 통합은 계속 작동하도록 인식되지 않는 키를 무시해야 합니다. 이 섹션의 필드는 지원 중단되었거나, 기존 필드이거나, 부분적으로 대체되었습니다. 하위 호환성을 위해 페이로드에 남아 있지만 새 통합은 각 필드에 관한 안내를 따라야 합니다.
지원 중단된 필드
voip_provider(문자열) - 지원 중단되었습니다. 항상 리터럴 문자열 'deprecated'를 반환합니다. UJET은 더 이상 이 문서를 통해 통합에 제공업체 정보를 표시하지 않습니다. 대체 필드는 없습니다. 통합에서 업스트림 전화 통신 제공자를 식별해야 하는 경우 계정팀에 문의하세요.
기존 중복
session_type(문자열) -call_type의 기존 별칭입니다. 항상call_type과 동일한 값을 반환하고 동일한 기존 enum 어휘를 사용합니다. UJET은session_type를 기반으로 하는 통합과의 하위 호환성을 위해 이 필드를 유지합니다. 새 통합은call_type를 직접 파싱하거나, 더 세부적인 인바운드 구분을 위해session_type_v2를 파싱해야 합니다(아래 어휘 진화 참고).
어휘 진화
call_type과 session_type_v2은 두 가지 다른 어휘를 사용하여 동일한 기본 호출 유형을 설명합니다. UJET은 모든 레코드에서 두 필드를 모두 내보냅니다. 두 필드는 서로 중복되지 않습니다.
call_type는 기존 enum 어휘를 사용합니다.Voice Inbound (App)및Voice Inbound (IVR using App)와 같은 값은 단일 라벨 아래의 모든 인바운드 모바일 및 인앱 SDK 출처를 포함합니다.call_type는 지원 중단되지 않습니다. UJET은 이 필드를 계속 내보내지만 어휘에 새로운 세부 값이 추가되지는 않습니다.session_type_v2은 현재 enum 어휘를 사용합니다. v2 전용 값이 있는 통화 유형에 대해 더 세분화된 인바운드 구분(예:Voice Inbound (Mobile)및Voice Inbound (IVR using Mobile))이 도입됩니다. v2 전용 값이 없는 호출 유형의 경우session_type_v2는call_type와 동일한 문자열을 반환합니다.
새 통합은 session_type_v2를 파싱해야 합니다. 각 필드의 값은 핵심 정보에 나열되어 있습니다.
대기 시간 필드 명명법
통화 세션 메타데이터 문서는 다음 두 필드 이름으로 두 범위의 대기열 대기 시간을 보고합니다.
통화 합계 - 최상위
wait_duration필드에는 전체 통화에서 소비자가 대기열에서 보낸 총 시간이 포함됩니다.세그먼트별 - 최상위
queue_durations배열(대기열 시간)의 각 항목에는 해당 개별 대기열 세그먼트의 대기열 시간을 보유하는 자체queue_duration필드가 있습니다.
두 이름 모두 서로 다른 범위에서 동일한 종류의 측정(대기열에서 보낸 시간)을 나타냅니다. 전체 통화 wait_duration는 소비자의 전체 큐 시간을 반영하고, 세그먼트별 queue_duration 값은 각 큐 세그먼트를 설명합니다. 이 문서에서는 별도의 최상위 queue_duration 필드를 내보내지 않습니다. 세그먼트별 값은 queue_durations 내에서만 사용할 수 있습니다.