이 문서에서는 모든 음성 통화가 끝날 때 CCAI Platform에서 내보내는 JSON 문서인 통화 세션 메타데이터 레코드의 스키마를 제공합니다. CCAI Platform은 세션 종료 명령어의 본문으로 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키는 통화에 상담사나 가상 에이전트가 없는 경우와 둘 다 있는 경우의 두 가지 경우에 생략됩니다. 가상 에이전트가 상담사로 에스컬레이션되는 동안 유지되는 경우 통화에 두 가지가 모두 포함되므로 완전히 처리된 통화가 키 없이 도착할 수 있습니다.
레코드에 포함된 변이를 감지하려면 먼저 agent_info 키가 있는지 확인한 다음 변이별 필드(일반적으로 상담사 변이의 경우 agent_info.email, 가상 에이전트 변이의 경우 agent_info.va_alias)를 확인합니다. agent_info만으로 처리자를 추론하지 마세요. 둘 다 있는 통화의 경우 participants[]에서 상담사를 읽고 virtual_agent_handle_durations[]에서 가상 에이전트를 읽거나 transfers[] 및 escalations[]의 from_virtual_agent 및 to_virtual_agent 필드를 읽습니다. 각 변형의 전체 형태는 에이전트 및 virtual_agent를 참조하세요.
호출 형태 판별자 — call_type, session_type, session_type_v2 (문자열)
동일한 기본 호출 유형의 세 가지 병렬 뷰 레코드가 나타내는 호출 유형에 대해서는 의견이 일치하지만 호출 유형의 이름을 지정하는 데 사용하는 어휘만 다릅니다.
call_type는 기존 enum 어휘 (예:Voice Inbound (App),Voice Outbound또는Voice Internal)를 사용합니다.session_type는 항상call_type와 동일한 문자열을 반환합니다. CCAI Platform은 이 필드를 키로 사용하는 통합과의 하위 호환성을 위해 이 필드를 제공합니다.call_type의 지원 중단된 별칭으로 취급합니다. 버전 관리 및 지원 중단을 참조하세요.session_type_v2은 현재 enum 어휘를 사용합니다. 이 어휘는 더 세분화된 인바운드 구분으로call_type어휘를 확장합니다. 예를 들어 더 광범위한Voice Inbound (App)및Voice Inbound (IVR via App)대신Voice Inbound (Mobile)및Voice Inbound (IVR via Mobile)를 사용합니다. v2 관련 값이 없는 호출 유형의 경우session_type_v2는call_type와 동일한 문자열을 반환합니다. 새 통합은session_type_v2를 파싱해야 합니다.
각 필드의 값은 핵심 정보를 참고하세요.
핵심 정보
이러한 속성은 통화의 핵심 정보를 캡처합니다.
id(정수): 각 통화 세션의 고유 식별자입니다. 이는 한 통화와 다른 통화를 구분하는 기본 키입니다.call_uuid(문자열 또는 null): 동적 통화 라우팅 (DCR) 상호작용에서 발신 인스턴스와 수신 인스턴스 간의 통화를 연결하는 고유 식별자입니다. DCR 호출의 두 구간은 동일한call_uuid값을 공유하므로 고객이 환경 간에 데이터를 연결할 수 있습니다. DCR 상호작용이 아닌 통화와 CCAI Platform에서 필드를 추가하기 전에 발생한 통화의 경우 이 필드는 null이거나 비어 있습니다.lang(문자열): 통화의 ISO 639 언어 코드입니다 (예: 영어의 경우 'en', 스페인어의 경우 'es'). 이 코드는 언어별 분석 및 보고를 수행하는 데 도움이 됩니다.call_type(문자열): 기존 유형 어휘를 사용하는 통화 유형입니다. 값에는 '음성 인바운드 (앱)', '음성 인바운드 (웹)', '음성 인바운드(IVR)', '음성 인바운드 (앱을 통한 IVR)', '음성 인바운드 (API)', '음성 인바운드 (직접)', '음성 인바운드 (확장 프로그램)', '음성 예약 (앱)', '음성 예약 (웹)', '음성 예약 (API)', '음성 콜백', '음성 콜백 (웹)', '음성 아웃바운드', '음성 아웃바운드 (API)', '음성 아웃바운드(직접)', '음성 아웃바운드 (UCaaS)', '음성 내부', '음성 캠페인(Acqueon)', '음성 캠페인 (<브랜드 이름>)', '상담사 예약 통화'가 포함됩니다.session_type(문자열): CCAI Platform에서 이전 버전과의 호환성을 위해 유지하는call_type의 중복 (동일한 값)입니다. 버전 관리 및 지원 중단: 기존 중복을 참조하세요.session_type_v2(문자열): 현재 유형 어휘를 사용하는 호출 유형입니다. 더 세분화된 인바운드 구분으로call_type값을 미세 조정합니다 (예: '음성 인바운드 (앱)' 및 '음성 인바운드 (앱을 통한 IVR)' 대신 '음성 인바운드 (모바일)' 및 '음성 인바운드 (모바일을 통한 IVR)'). 값에는 '음성 인바운드 (모바일)', '음성 인바운드(웹)', '음성 인바운드 (IVR)', '음성 인바운드 (모바일 통한 IVR)', '음성 인바운드 (API)', '음성 인바운드 (직접)', '음성 인바운드 (확장 프로그램)', '음성 예약 (모바일)', '음성 예약 (웹)', '음성 예약(API)', '음성 콜백', '음성 콜백 (웹)', '음성 아웃바운드', '음성 아웃바운드 (API)', '음성 아웃바운드 (직접)', '음성 아웃바운드 (UCaaS)', '음성 내부', '음성 캠페인 (Acqueon)', '음성 캠페인 (<브랜드 이름>)', '상담사 예약 통화'가 포함됩니다.status(문자열): 통화 수명 주기를 통한 진행 상황을 추적하는 통화 상태입니다. 수명 주기 단계별로 그룹화된 가능한 값은 다음과 같습니다.사전 연결:
"scheduled","selecting","queued","assigned","connecting","switching","requeued","requeued_detection_missed"연결됨:
"connected".가상 에이전트:
"va_assigned","va_connected"캠페인:
"preview_pending","preview_ready","preview_waiting","predictive_waiting","progressive_waiting","campaign_dialing","campaign_connecting","campaign_connected".작업 전용:
"action_only","action_only_finished".음성사서함:
"voicemail","voicemail_received","voicemail_read","voicemail_forwarded".터미널:
"finished","failed","recovered","deflected"
created_at(문자열, 날짜-시간): CCAI Platform에서 통화 기록을 만든 정확한 타임스탬프입니다.queued_at(문자열, 날짜-시간 또는 null): 통화가 대기열에 들어간 타임스탬프 또는 통화가 대기열에 들어가지 않은 경우 null입니다.assigned_at(문자열, 날짜-시간 또는 null): CCAI Platform에서 통화를 상담사에게 할당한 타임스탬프 또는 CCAI Platform에서 통화를 할당하지 않은 경우 null입니다.connected_at(문자열, 날짜-시간 또는 null): 통화가 연결된 타임스탬프입니다.ends_at(문자열, 날짜-시간 또는 null): 통화가 종료된 타임스탬프입니다.scheduled_at(문자열, 날짜-시간 또는 null): CCAI Platform에서 통화를 예약한 타임스탬프 또는 통화가 즉시 이루어진 경우 null입니다.updated_at(문자열, 날짜-시간): CCAI Platform에서 통화 데이터를 마지막으로 업데이트한 타임스탬프입니다.wait_duration(정수 또는 null): 소비자가 전체 통화에서 대기열에서 보낸 총 시간(초) 또는 CCAI Platform에서 대기열 시간을 기록하지 않은 경우 null입니다. 개별 세그먼트로 분류된 대기열 시간은queue_durations배열 (대기열 시간)을 참조하세요. 버전 관리 및 지원 중단: 대기 시간 필드 명명법을 참조하세요.call_duration(정수 또는 null): 통화의 총 시간(초)입니다.hold_duration(정수 또는 null): 소비자가 대기한 총 시간(초) 또는 대기 시간이 없는 경우 null입니다.rating(정수 또는 null): 소비자가 제출한 고객 만족도 (CSAT) 평점입니다. 소비자가 평점을 제출하지 않은 경우 null입니다.has_feedback(불리언): 소비자가 통화 후 의견을 제공했는지 여부를 나타내는 플래그입니다.voip_provider(문자열): 통화의 VoIP 제공업체입니다. (참고: 이 필드는 지원 중단되었으며 항상 '지원 중단됨'을 반환합니다.)out_ticket_id(문자열 또는 null): CCAI Platform이 외부 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"(통화가 음성메시지로 연결되지 않은 경우) 가능한 값은"not_voicemail","temporary_redirection","after_hour_deflection","over_capacity_deflection","no_input","no_agent"입니다.disconnected_by(문자열 또는 null): 통화를 종료한 당사자를 나타냅니다. 가능한 값:disconnected_by_unknown,disconnected_by_agent,disconnected_by_end_user,disconnected_by_virtual_agent,disconnected_by_systemfail_reason(문자열 또는 null): 호출이 실패한 이유 또는 실패하지 않은 호출의 경우"nothing"입니다. 가능한 값은 실패의 원인이 되는 당사자 또는 하위 시스템별로 그룹화됩니다.실패 없음:
nothing일반:
unknown,expired,transfer_expired,canceled_outside_fulfillment_hours최종 사용자:
eu_canceled,eu_rejected,eu_abandoned,eu_in_menu_abandoned,eu_repeated_voicemail,eu_repeated_callback,eu_dcr_abandoned_on_receiving,eu_busy,eu_wrong_number,eu_no_answer,eu_noti_failed,eu_phone_denied에이전트:
ag_canceled,ag_ignored,ag_declined,ag_mic_no_device,ag_mic_denied,ag_invalid_outbound_num,ag_called_blocked_num연결:
conn_declineVoIP:
voip_twilio_error,voip_tokbox_error,voip_invalid_token,voip_conn_general,voip_conn_timeout,voip_conn_signal,voip_conn_codec,voip_nexmo_error,voip_telnyx_error오디오:
audio_not_received_by_carrier,audio_device_unable_to_start중단 또는 해결할 수 없는 상태:
stuck_due_to_api_error,group_deleted_no_substitute,menu_deleted,direct_pstn_call_to_fallback_number캠페인:
campaign_paused,campaign_queue_reassigned,campaign_no_incoming_contacts,campaign_call_canceled강제 종료:
force_ended,force_failed_call_stuck
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(문자열): 슬래시로 구분된 메뉴 이름 문자열입니다 (예: '지원/결제').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(객체, 데이터 매개변수를 사용 설정하고 메타데이터에 포함하는 경우에만 표시됨): 호출의 데이터 파라미터 값의 스냅샷입니다. 키 및 값 유형은 데이터 매개변수 구성에 따라 달라집니다.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): CCAI Platform에서 통화를 편향시킨 메뉴 경로입니다.to_sip_uri(문자열, CCAI Platform이 통화를 SIP 대상으로 편향한 경우에만 표시): CCAI Platform이 통화를 편향한 SIP URI입니다(해당하는 경우).to_sip_headers(객체, CCAI Platform이 통화를 SIP 대상으로 편향한 경우에만 표시됨): CCAI Platform이 통화를 편향한 SIP 헤더입니다(해당하는 경우).
전송
transfers(배열): 통화 중 전송 이벤트당 항목 1개입니다. 상담사, 가상 에이전트, 메뉴 간의 웜 트랜스퍼와 콜드 트랜스퍼를 모두 기록합니다.id(정수): 전송의 고유 식별자입니다.status(문자열): 전송의 현재 상태입니다 (예: 전송 중, 연결됨, 실패).fail_reason(문자열): 전송이 실패한 이유 또는 실패하지 않은 경우 '없음'입니다.created_at(문자열, 날짜-시간): 전송이 시작된 시간입니다.assigned_at(문자열, 날짜-시간 또는 null): CCAI Platform에서 수신 당사자에게 전송을 할당한 시간입니다.connected_at(문자열, 날짜-시간 또는 null): 전송이 연결된 시간입니다.updated_at(문자열, 날짜-시간): CCAI Platform에서 전송 레코드를 마지막으로 업데이트한 시간입니다.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(객체, 통화가 상담사의 사용 불가 상태를 중단한 경우에만 표시됨): 해당하는 경우 상담사의 사용 불가 상태를 중단하는 통화 할당에 대한 세부정보입니다.
대기열 기간
queue_durations(배열): 객체 배열로, 각 객체는 소비자가 대기열에 있던 통화 세그먼트를 나타냅니다. 이를 통해 대기 시간과 서비스 수준을 분석할 수 있습니다.id(정수): 큐 기간의 고유 식별자입니다.agent_id(정수): 에이전트의 ID입니다.ended_at(문자열, 날짜-시간): 종료 타임스탬프입니다.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(문자열): 에스컬레이션의 현재 상태입니다. 가능한 값:escalating,"escalated","canceled","deflecting","deflected"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(문자열): 회피된 에스컬레이션에 대해 기록된 회피 유형입니다. 이는 정의: 전환에 설명된 통화 수준 전환 필드보다 작은 어휘입니다. 가상 에이전트 에스컬레이션에서 기록할 수 있는 결과만 포함합니다. 가능한 값은 다음과 같습니다.용량 초과:
over_cap,over_cap_phone,over_cap_voicemail,over_cap_callback,over_cap_message,over_cap_queue,over_cap_sip,over_cap_extension,over_cap_phone_with_extension업무 시간 외:
after_hours,after_hours_phone,after_hours_voicemail,after_hours_message,after_hours_message_only,after_hours_queue,after_hours_sip,after_hours_extension,after_hours_phone_with_extension임시 리디렉션:
temp_redirection,temp_redirection_phone,temp_redirection_voicemail,temp_redirection_message,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
접미사가 없는
over_cap,after_hours,temp_redirection값은 편향 결과에 도달하기 전에 통화가 종료될 때 기록됩니다.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(문자열, 날짜-시간): 종료 타임스탬프입니다.
소비자 이벤트 기간
consumer_event_durations(배열): 소비자 통화 이벤트 (예: CSAT 또는 결제)의 세부정보입니다.id(정수): 고유 식별자입니다.duration(정수): 이벤트 기간입니다.type(문자열): 이벤트 유형입니다.event(문자열): 이벤트 결과입니다.menu_path_id(정수): 메뉴 경로 ID입니다.menu_path(문자열): 메뉴 경로입니다.lang(문자열): 언어입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.ended_at(문자열, 날짜-시간): 종료 타임스탬프입니다.
소비자 메뉴 내 지속 시간
consumer_in_menu_durations(배열): 메뉴 내 소비자 상호작용 시간입니다.id(정수): 고유 식별자입니다.duration(정수): 메뉴 내 지속 시간입니다.event(문자열): 메뉴 상호작용 결과입니다.menu_path_id(정수): 메뉴 경로 ID입니다.menu_path(문자열): 메뉴 경로입니다.lang(문자열): 언어입니다.started_at(문자열, 날짜-시간): 시작 타임스탬프입니다.ended_at(문자열, 날짜-시간): 종료 타임스탬프입니다.
참여자
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(객체, Agent Assist를 구성할 때 에이전트 참여자에게만 표시됨): 이 참여자의 활성 Agent Assist 설정입니다.virtual_agent(객체, 가상 에이전트 참여자에게만 표시): 이 참여자 역할을 하는 가상 에이전트의 세부정보입니다. 최상위 수준agent_info및virtual_agent_params와 다릅니다.caller_id(문자열, 계정에서 SIP 헤더 발신번호 표시를 사용 설정한 경우에만 표시되며 소비자 참여자에게만 표시됨): CCAI Platform이 이 소비자 참여자의 인바운드 SIP 헤더에서 추출하는 발신번호 표시입니다.sip_headers(객체 또는 null): 이 참석자와 연결된 SIP 헤더입니다. 항상 페이로드에 존재합니다. CCAI Platform에서 헤더를 캡처하지 않으면 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): CCAI Platform에서 상담사에게 통화를 제공한 방법입니다.offer_events(배열): CCAI Platform에서 상담사에게 통화를 제공한 이벤트입니다.casting_time(문자열, 날짜-시간): CCAI Platform에서 통화를 제공한 시간입니다.group(문자열): CCAI Platform에서 통화를 제공한 그룹입니다.
기타 세부정보
answer_type(문자열 또는 null): 통화가 해결된 방식 ('manual' 또는 'auto')입니다.outbound_number(문자열 또는 null): 사용된 아웃바운드 전화번호입니다.wait_time_sms(배열, 이 통화에서 대기 시간 SMS 상호작용이 발생한 경우에만 표시): CCAI Platform에서 예상 대기 시간에 대해 소비자에게 전송한 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(불리언): CCAI Platform에서 미리 설정된 메시지를 전송했는지 여부입니다.custom_sent(불리언): 에이전트가 커스텀 (자유 텍스트) 메시지를 보냈는지 여부입니다.received(불리언): CCAI Platform이 소비자로부터 SMS를 수신했는지 여부입니다.
dispositions(배열, 계정에서 마무리 코드 또는 메모를 사용 설정한 경우에만 표시됨): 상담사가 기록한 마무리 코드 및 메모입니다. 각 항목에는 마무리 구성에 따라 동적으로 렌더링된 필드가 포함됩니다.user_id(정수): 에이전트 식별자입니다.transfer_id(정수 또는 null): 전송 후 기록된 경우 전송 이벤트 식별자입니다.participant_id(정수): 참여자 식별자입니다.note(문자열): 자유 형식의 상담사 메모입니다.original_note(문자열): 수정 전 원본 버전의 메모입니다.code(문자열): 처리 코드 이름입니다.ujet_code_id(정수 또는 빈 문자열): 처리 코드의 CCAI Platform ID - 코드의 안정적인 키 (코드 표시 이름은 변경될 수 있음) 사용할 수 없는 경우 빈 문자열입니다.list(문자열): 코드가 속한 목록의 이름입니다.list_path(문자열): 슬래시로 구분된 코드 목록의 경로입니다.ujet_list_id(정수 또는 빈 문자열): 처리 코드에 속하는 목록의 CCAI Platform 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(배열, 계정의 가상 에이전트에 대해 대기열 내 대기 시간 추적을 사용 설정하고 하나 이상의 보존된 가상 에이전트 에스컬레이션이 발생한 경우에만 표시됨): 에스컬레이션 후 CCAI Platform에서 가상 에이전트를 보존하는 동안 소비자가 대기열에서 대기한 시간 간격입니다. 각 항목에는 다음이 포함됩니다.start(문자열, 날짜-시간): 대기열 대기가 시작된 시간입니다.end(문자열, 날짜-시간 또는 null): 대기열 대기가 종료된 시간입니다. 완료되지 않은 경우 null입니다.duration(정수 또는 null): 대기 시간(초)입니다.end가 null이면 null입니다.
auto_session_summaries(배열, 계정에서 대화 요약을 사용 설정하고 CCAI Platform에서 요약을 생성한 경우에만 표시됨): CCAI Platform에서 CRM 레코드에 저장하는 AI 생성 세션 요약입니다. 각 항목에는 다음이 포함됩니다.user_id(정수): 요약이 연결된 에이전트 참여자의 식별자입니다.participant_id(정수): 참여자 식별자입니다.session_summary(문자열): 요약 텍스트입니다.session_summary_sections(배열 또는 객체): 구조화된 섹션의 요약입니다(사용 가능한 경우).
sip_headers(객체, 계정에서 SIP 헤더 캡처를 사용 설정하고 세션 메타데이터에 포함하도록 구성한 경우에만 표시됨): CCAI Platform에서 통화에 대해 캡처한 인바운드 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 (문자열, enum)
통화 또는 통화 세그먼트의 전환 상태입니다. 값은 <trigger>_<destination> 이름 지정 패턴을 따릅니다. 여기서 프리픽스는 편향을 트리거한 조건 (예: 용량 초과, 업무 시간 외, 임시 리디렉션)을 식별하고 서픽스는 대상 또는 처리 (예: 음성사서함, 대기열, 전화, 메시지)를 식별합니다.
일반적인 도착 페이지 접미사:
_phone: 통화를 외부 전화번호로 라우팅합니다._voicemail: 통화를 음성사서함으로 연결합니다._message— 정보 메시지를 재생합니다._message_only— 메시지를 재생하고 추가 라우팅 없이 통화를 종료합니다._callback— 예약된 콜백을 제공합니다._wait— 발신자를 대기 상태로 유지합니다._queue— 통화를 다른 대기열로 보냅니다.thought
_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_ewt_only,over_cap_sip,over_cap_extension,over_cap_phone_with_extension.포기된 전환 — 대기 중인 전환이 해결되기 전에 트랜스퍼 또는 통화가 종료된 경우:
deflection_abandoned영업시간 외 — 메뉴에 구성된 영업시간 외에 전화가 걸려온 경우:
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_details[].deflection입니다. 다른 두 필드는 각각 이 필드의 하위 집합을 사용합니다.
최상위
deflection필드는over_cap_ewt_only및temp_redirection_url를 제외한 모든 값을 사용합니다.각
transfers[].deflection는 더 작은 전송 범위 하위 집합인no_deflection,deflecting,deflection_abandoned, 10개의over_cap_*값, 8개의after_hours_*값,temp_redirection_url이외의 7개의temp_redirection_*값,ivr_presession_deflection,va_redirection_phone,va_redirection_sip를 사용합니다.internal_call_*,call_transfer_*,emergency_shutdown_*,dcr_*,va_third_party_*계열은 전송에 표시되지 않습니다.
버전 관리 및 지원 중단
통화 세션 메타데이터 스키마는 하위 호환되는 발전을 지원합니다. CCAI Platform은 언제든지 새 필드와 배열을 추가할 수 있습니다. 통합은 기능을 계속 사용할 수 있도록 인식되지 않는 키를 무시해야 합니다. 이 섹션의 필드는 지원 중단되었거나, 기존 필드이거나, 소프트 대체되었습니다. 이전 버전과의 호환성을 위해 페이로드에 남아 있지만 새로운 통합은 각 필드의 안내를 따라야 합니다.
지원 중단된 필드
voip_provider(문자열) — 지원 중단되었습니다. 항상 리터럴 문자열 'deprecated'를 반환합니다. CCAI Platform은 더 이상 이 문서를 통해 통합에 제공업체 정보를 표시하지 않습니다. 대체 필드가 없습니다. 통합에서 업스트림 전화 통신 제공업체를 식별해야 하는 경우 계정팀에 문의하세요.
기존 중복
session_type(문자열) —call_type의 기존 별칭입니다. 항상call_type와 동일한 값을 반환하고 동일한 기존 enum 어휘를 사용합니다. CCAI Platform은session_type에서 키를 지정하는 통합과의 하위 호환성을 위해 이 필드를 유지합니다. 새 통합은call_type를 직접 파싱하거나 더 세분화된 인바운드 구분을 위해session_type_v2를 파싱해야 합니다(아래 어휘 발전 참고).
어휘 진화
call_type 및 session_type_v2는 두 가지 다른 어휘를 사용하여 동일한 기본 호출 유형을 설명합니다. CCAI Platform은 모든 레코드에서 두 필드를 모두 내보냅니다. 서로 중복되지 않습니다.
call_type에서 기존 enum 어휘를 사용합니다.Voice Inbound (App)및Voice Inbound (IVR via App)와 같은 값은 단일 라벨 아래에 있는 모든 인바운드 모바일 및 인앱 SDK 출처를 포함합니다.call_type는 지원 중단되지 않습니다. CCAI Platform은 이 필드를 계속 내보내지만 어휘에 새로운 세분화된 값이 추가되지 않습니다.session_type_v2은 현재 enum 어휘를 사용합니다. v2 관련 값이 있는 호출 유형에 대해 더 세분화된 인바운드 구분(예:Voice Inbound (Mobile)및Voice Inbound (IVR via Mobile))을 도입합니다. v2 관련 값이 없는 호출 유형의 경우session_type_v2는call_type과 동일한 문자열을 반환합니다.
새 통합은 session_type_v2를 파싱해야 합니다. 각 필드의 값은 핵심 정보에 나열되어 있습니다.
대기 시간 필드 명명법
통화 세션 메타데이터 문서는 두 가지 범위에서 두 가지 필드 이름으로 대기열 대기 시간을 보고합니다.
통화 합계 — 최상위
wait_duration필드에는 소비자가 전체 통화에서 대기열에서 보낸 총 시간이 포함됩니다.세그먼트별 — 최상위
queue_durations배열(대기열 기간)의 각 항목에는 자체queue_duration필드가 있으며, 이 필드에는 해당 개별 대기열 세그먼트의 대기열 시간이 포함됩니다.
두 이름 모두 서로 다른 범위에서 동일한 종류의 측정, 즉 큐에서 소요된 시간을 나타냅니다. 통화 총계 wait_duration는 소비자의 전체 대기열 시간을 반영하는 반면 세그먼트별 queue_duration 값은 각 대기열 세그먼트를 설명합니다. 이 문서는 별도의 최상위 queue_duration 필드를 내보내지 않습니다. 세그먼트별 값은 queue_durations 내에서만 사용할 수 있습니다.