CDR 로그 이벤트 참조

로그 웹훅이 전송한 cdr_logged 이벤트의 경우 payload 오브젝트는 전화 통합에 의해 처리된 호출 세부사항 레코드(CDR) 이벤트에 대한 데이터를 포함합니다. CDR 이벤트의 payload 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 1. CDR 웹훅 페이로드 객체의 속성
특성	유형	설명
`primary_phone_number`	문자열	전화를 받은 전화번호입니다.
`global_session_id`	문자열	고유 세션 식별자입니다.
`failure_occurred`	부울	호출 중에 실패가 발생했는지 여부입니다.
`failure_details`	문자열	발생했던 실패에 대한 세부사항입니다.
`transfer_occurred`	부울	호출 전송을 시도했는지 여부입니다.
`active_calls`	숫자	호출이 시작될 때의 활성 호출 수입니다.
`x-global-sip-trunk-call-id`	문자열	초기 SIP `INVITE` 요청에서 추출한 SIP 트렁크 통화 ID 헤더의 값입니다. 다음 SIP 트렁크 통화 ID 헤더가 지원됩니다: \n - `X-Twilio-CallSid` \n - `X-SID` \n - `X-Global-SIP-Trunk-Call-ID`
`call`	오브젝트	호출에 대한 정보입니다. `call`의 내용을 참조하십시오.
`session_initiation_protocol`	오브젝트	SIP 프로토콜 관련 세부 정보. `session_initiation_protocol`의 내용을 참조하십시오.
`max_response_milliseconds`	오브젝트	호출 중에 사용되는 서비스의 최대 대기 시간입니다. `max_response_milliseconds`의 내용을 참조하십시오.
`assistant_interaction_summaries`	배열	통화 중에 이루어진 AI 비서 와의 상호작용에 대한 세부 정보. 참조 `assistant_interaction_summaries`.
`injected_custom_data`	오브젝트	`cdr_custom_data` 컨텍스트 변수에서 추출된 키/값 쌍 세트입니다.
`warnings_and_errors`	배열	통화 중에 기록된 경고 또는 오류입니다. `warnings_and_errors`의 내용을 참조하십시오.
`realtime_transport_network_summary`	오브젝트	`inbound_stream` 오브젝트의 인바운드 스트림에 대한 통계 및 `outbound_stream` 오브젝트의 아웃바운드 스트림에 대한 통계입니다. RTCP가 사용 가능한 경우에만 포함됩니다. `realtime_transport_network_summary`의 내용을 참조하십시오.

`call`

call 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 2. call 객체의 속성
특성	유형	설명
`start_timestamp`	문자열	통화가 시작된 시간, ISO 형식(`yyyy-MM-ddTHH:mm:ss.SSSZ`)입니다.
`stop_timestamp`	문자열	통화가 종료된 시간, ISO 형식(`yyyy-MM-ddTHH:mm:ss.SSSZ`)입니다.
`milliseconds_elapsed`	숫자	통화 시간(밀리초)입니다.
`end_reason`	문자열	통화가 종료된 이유입니다. 가능한 원인은 다음과 같습니다: \n - assistant_transfer \n - assistant_hangup \n - caller_hangup \n - failed
`security.media_encrypted`	부울	매체가 암호화되었는지 여부입니다.
`security.signaling_encrypted`	부울	SIP 시그널이 암호화되었는지 여부입니다.
`security.sip_authenticated`	부울	호출자를 인증하기 위해 SIP 인증이 사용되었는지 여부입니다.

`session_initiation_protocol`

session_initiation_protocol 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 3. session_initiation_protocol 객체의 속성
특성	유형	설명
`invite_arrival_timestamp`	문자열	`INVITE` 요청이 도착한 시간, ISO 형식(`yyyy-MM-ddTHH:mm:ss.SSSZ`)입니다.
`setup_milliseconds`	숫자	통화를 설정하는 데 걸린 시간(밀리초). 초기 SIP `INVITE` 요청이 수신된 시점과 최종 SIP `ACK` 요청이 수신된 시점 사이의 시간입니다.
`headers.call_id`	문자열	통화와 관련된 SIP `Call-ID` 헤더 필드에서 가져온 SIP `INVITE` 헤더 필드입니다.
`headers.from_uri`	문자열	초기 SIP INVITE `From` 헤더에서 SIP URI를 추가합니다.
`headers.to_uri`	문자열	초기 SIP INVITE `To` 헤더에서 SIP URI를 추가합니다.

`assistant_interaction_summaries`

assistant_interaction_summaries 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 4. assistant_interaction_summaries 객체의 속성
특성	유형	설명
`assistant_id`	문자열	AI 어시스턴트의 고유 식별자.
`session_id`	문자열	세션의 고유 식별자입니다.
`turns`	배열	대화 중에 발생한 AI 비서 상호작용을 설명하는 객체 배열. [`assistant_interaction_summaries.turns[]`](#cdr-log-reference-turns)를 참조하십시오.

assistant_interaction_summaries.turns[]

assistant_interaction_summaries.turns 배열의 객체에는 다음 속성이 포함되어 있습니다.

표 5. assistant_interaction_summaries.turns [] 배열에 포함된 객체들의 속성
특성	유형	설명
`assistant.log_id`	문자열	로깅된 이벤트의 고유 식별자로, 메시지 로그와 CDR 이벤트 간의 상관관계를 파악하는 데 사용할 수 있습니다.
`assistant.start_timestamp`	문자열	AI 비서 에게 요청이 전송된 시간(ISO `yyyy-MM-ddTHH:mm:ss.SSSZ`형식).
`assistant.response_milliseconds`	숫자	요청이 전송된 시점부터 어시스턴트로부터 응답을 받은 시점까지의 시간(밀리초)입니다.
`request`	오브젝트	AI 비서 에게 전송된 요청. [`assistant_interaction_summaries.turns[].request`](#cdr-log-reference-request)를 참조하십시오.
`response`	배열	요청과 연관된 `response` 오브젝트의 배열입니다.

assistant_interaction_summaries.turns[].request

assistant_interaction_summaries.turns[].request 개체에는 다음과 같은 속성이 포함되어 있습니다.

[표 6] assistant_interaction_summaries.turns []의 request 객체 속성
특성	유형	설명
`type`	문자열	요청 유형: \n - `start`: AI 어시스턴트에 초기 요청이 전송됨 \n - `speech_to_text`: Speech to Text 서비스로부터 입력을 수신함 \n - `dtmf`: DTMF 수집이 완료됨 \n - `sms`: 발신자로부터 SMS 메시지를 수신함 \n - `post_response_timeout`: 응답 후 타이머가 만료됨 \n - `redirect`: 통화가 재전송됨 \n - `transfer`: 통화가 연결됨 \n - `transfer_failed`: 통화 연결에 실패함 \n - `final_utterance_timeout`: 최종 발화 타이머가 만료됨 \n - `no_input_turn`: `no input turn` 가 활성화됨 \n - `sms_failure`: 발신자에게 SMS 메시지를 보낼 수 없음 \n - `speech_to_text_result_filtered`: 신뢰도 수준이 낮아 발화가 필터링됨 \n - `mrcp_recognition_unsuccessful`: 최종 발화 없이 MRCP 인식이 완료됨 \n - `network_warning`: 네트워크 오류가 감지됨 \n - `media_capability_change`: 통화 중 미디어 기능이 변경됨.
`streaming_statistics`	오브젝트	Speech to Text 인증과 관련된 정보 및 통계. [`assistant_interaction_summaries.turns[].request.streaming_statistics`](#cdr-log-reference-request-streaming_statistics)를 참조하십시오.

assistant_interaction_summaries.turns[].request.streaming_statistics

assistant_interaction_summaries.turns[].request.streaming_statistics 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 7. assistant_interaction_summaries.turns [].streaming_statistics 객체의 속성
특성	유형	설명
`transaction_id`	문자열	거래의 고유 식별자입니다.
`start_timestamp`	문자열	트랜잭션이 시작된 시간, ISO 형식(`yyyy-MM-ddTHH:mm:ss.SSSZ`)입니다.
`stop_timestamp`	문자열	거래가 종료된 시간, ISO 형식(`yyyy-MM-ddTHH:mm:ss.SSSZ`)입니다.
`response_milliseconds`	숫자	발화자의 말에서 침묵이 감지된 시점부터 AI 비서가 최종 결과를 반환할 때까지의 지연 시간(밀리초 단위).
`echo_detected`	부울	반향이 발견되었는지 여부입니다.
`confidence`	숫자	최종 발화의 자신감 점수입니다.

assistant_interaction_summaries.turns[].response

assistant_interaction_summaries.turns[].response 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 8. assistant_interaction_summaries.turns []의 response 객체 속성
특성	유형	설명
`type`	문자열	응답 유형: \n - `text_to_speech`: 발신자에게 음성 메시지를 재생하는 명령어 \n - `sms` : 발신자에게 SMS 메시지를 보내는 명령어 \n - `url`: 발신자에게 오디오 파일을 재생하는 명령어 \n - `transfer`: 통화를 연결하는 명령어 \n - `text_to_speech_config`: Text to Speech 설정을 변경하는 명령어 \n - `speech_to_text_config`: Speech to Text 설정을 변경하는 명령어 \n - `pause_speech_to_text`: 음성 인식 중지 명령어 \n - `unpause_speech_to_text`: 음성 인식 시작 명령어 \n - `pause_dtmf`: 수신 DTMF 신호 처리 중지 명령어 \n - `unpause_dtmf`: unpause_dtmf: 수신 DTMF 신호 처리 시작 명령어 \n - `enable_speech_barge_in`: 발신자가 말을 하여 재생을 중단할 수 있도록 음성 바지인(barge-in)을 활성화하는 명령어 \n - `disable_speech_barge_in`: 음성 바지인(speech barge-in)을 비활성화하여 오디오 재생 중 발신자가 말을 해도 재생이 중단되지 않도록 하는 명령어 \n - `enable_dtmf_barge_in`: DTMF 바지인을 활성화하여 발신자가 키를 눌러 전화 통합 기능을 통한 재생을 중단할 수 있도록 하는 명령어 \n - `disable_dtmf_barge_in`: DTMF 바지인을 비활성화하여 발신자가 키를 눌러도 전화 통합 기능을 통한 재생이 중단되지 않도록 하는 명령어 \n - `dtmf`: 발신자에게 DTMF 신호를 전송하는 명령어 \n - `hangup`: 통화를 종료하는 명령어 \n CDR과 AI 어시스턴트 응답 유형 간의 매핑을 참조하십시오.
`barge_in_occurred`	부울	변환 중에 개입(barge-in)이 발생했는지 여부입니다.
`streaming_statistics`	오브젝트	Text to Speech 의 합성 및 재생과 관련된 정보 및 통계. [`assistant_interaction_summaries.turns[].response.streaming_statistics`](#cdr-log-reference-response-streaming_statistics)를 참조하십시오.

CDR과 AI 어시스턴트 응답 유형 간의 매핑

이 type 속성의 값은 AI 어시스턴트의 응답 유형에 매핑됩니다.


CDR 응답 유형	AI 비서 응답 유형
`text_to_speech`	`text`
`url`	`audio`
`dtmf`	`dtmf`, `command_info.type` : `send`
`sms`	`user_defined`, `vgwAction.command` : `vgwActSendSMS`
`transfer`	`connect_to_agent`
`text_to_speech_config`	`text_to_speech`, `command_info.type` : `configure`
`speech_to_text_config`	`speech_to_text`, `command_info.type` : `configure`
`unpause_speech_to_text`	`start_activities`, `type`:`speech_to_text_recognition`
`pause_speech_to_text`	`stop_activities`, `type`:`speech_to_text_recognition`
`unpause_dtmf`	`start_activities`, `type`:`dtmf_collection`
`pause_dtmf`	`stop_activities`, `type`:`dtmf_collection`
`enable_speech_barge_in`	`text_to_speech`, `command_info.type` : `enable_barge_in`
`disable_speech_barge_in`	`text_to_speech`, `command_info.type` : `disable_barge_in`
`enable_dtmf_barge_in`	`dtmf`, `command_info.type` : `enable_barge_in`
`disable_dtmf_barge_in`	`dtmf`, `command_info.type` : `disable_barge_in`
`hangup`	`end_session`

assistant_interaction_summaries.turns[].response.streaming_statistics

assistant_interaction_summaries.turns[].response.streaming_statistics 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 9. assistant_interaction_summaries.turns [] 객체의 속성. response.streaming_statistics
특성	유형	설명
`transaction_id`	문자열	거래의 고유 식별자입니다.
`start_timestamp`	문자열	트랜잭션이 시작된 시간, ISO 형식(`yyyy-MM-ddTHH:mm:ss.SSSZ`)입니다.
`stop_timestamp`	문자열	거래가 종료된 시간, ISO 형식(`yyyy-MM-ddTHH:mm:ss.SSSZ`)입니다.
`response_milliseconds`	숫자	텍스트 명령이 AI 어시스턴트로 전송된 시점부터 휴대폰 연동 기능이 합성된 오디오의 첫 번째 패킷을 수신할 때까지의 시간(밀리초 단위).

`warnings_and_errors`

warnings_and_errors 개체에는 호출 중에 기록된 경고 및 오류가 발생 순서대로 나열되어 있습니다. 다음 조건에 대한 경고가 포함되어 있습니다.

발화가 신뢰도 점수 임계값에 의해 필터링될 때의 메시지입니다.
Text to Speech 언더플로우(underflow)는 Text to Speech 의 합성 속도가 휴대폰 통합 스트리밍 속도를 따라가지 못해 오디오가 끊길 수 있는 현상입니다.
RTCP가 사용 가능한 경우 높은 패킷 손실 또는 높은 평균 지터 RTP 네트워크 경고입니다.

다음 예제는 warnings_and_errors 오브젝트의 구조를 보여줍니다.

  "warnings_and_errors": [
    {
      "message": "CWSMR0032W: A Watson Speech to Text final utterance has a confidence score of 0.1, which does not meet the confidence score threshold of 0.2. The utterance will be ignored.",
      "id": "CWSMR0032W"
    },
    {
      "message": "CWSMR0031W: The synthesis stream from the Watson Text-to-Speech service can't keep up with the playback rate to the caller, so audio might skip. transaction ID=a1b2c3d4e5",
      "id": "CWSMR0031W"
    }
  ]

각 경고의 객체에는 다음과 같은 속성이 포함되어 있습니다.

표 10. warnings_and_errors 객체의 속성
특성	유형	설명
`message`	문자열	경고 메시지 텍스트입니다.
`id`	문자열	고유 메시지 식별자입니다.

`max_response_milliseconds`

max_response_milliseconds 개체에는 다음과 같은 속성이 포함되어 있습니다.

표 11. max_response_milliseconds 객체의 속성
특성	유형	설명
`assistant`	숫자	통화와 관련된 모든 AI 어시스턴트 요청을 바탕으로 계산된 최대 왕복 지연 시간(밀리초 단위).
`text_to_speech`	숫자	텍스트 음성이 Text to Speech 서비스로 전송된 시점부터 전화 통합 기능이 합성된 오디오의 첫 번째 패킷을 수신할 때까지의 최대 시간(밀리초 단위). 이 값은 해당 호출과 관련된 모든 Text to Speech 요청을 바탕으로 계산됩니다.
`speech_to_text`	숫자	발신자의 음성에서 침묵이 감지된 시점부터 Speech to Text 서비스의 최종 결과를 수신하기까지의 최대 지연 시간(밀리초 단위). 이 값은 해당 통화와 관련된 모든 Speech to Text 인식 결과를 바탕으로 계산됩니다.

`realtime_transport_network_summary`

RTCP가 사용 가능한 경우 realtime_transport_network_summary 오브젝트는 inbound_stream 오브젝트의 인바운드 스트림에 대한 통계 및 outbound_stream 오브젝트의 아웃바운드 스트림에 대한 통계를 제공합니다.

다음 예는 realtime_transport_network_summary 객체의 구조를 보여줍니다.

"realtime_transport_network_summary": {
  "inbound_stream": {
    "maximum_jitter": 5,
    "average_jitter": 1,
    "packets_lost": 0,
    "packets_transmitted": 1000,
    "canonical_name": "user@example.com",
    "tool_name": "User SIP Phone"
   },
  "outbound_stream": {
    "maximum_jitter": 5,
    "average_jitter": 1,
    "packets_lost": 0,
    "packets_transmitted": 2000,
    "canonical_name": "voice.gateway@127.0.0.1",
    "tool_name": "IBM Voice Gateway/1.0.0.5"
   }
}

각 스트림의 객체에는 다음과 같은 속성이 포함되어 있습니다.

표 12. realtime_transport_network_summary 객체의 속성
특성	유형	설명
`maximum_jitter`	숫자	통화 중 최대 지터.
`average_jitter`	숫자	통화 시간 동안 계산된 평균 지터입니다.
`packets_lost`	숫자	호출 중에 손실된 패킷 수 추정입니다.
`packets_transmitted`	숫자	통화 중에 전송된 총 패킷 수 추정치입니다.
`canonical_name`	문자열	스트림 발신자의 고유 식별자(일반적으로 `@` 형식)입니다.
`tool_name`	문자열	스트림이 시작된 애플리케이션 또는 도구의 이름입니다. 전화 통합의 경우 기본값은 `IBM Voice Gateway/` 입니다.