CDR 로그 이벤트 참조

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

CDR 웹훅 페이로드 오브젝트의 특성
특성 유형 설명
primary_phone_number 문자열 전화를 받은 전화번호입니다.
global_session_id 문자열 고유 세션 ID입니다.
failure_occurred boolean 호출 중에 실패가 발생했는지 여부입니다.
failure_details 문자열 발생했던 실패에 대한 세부사항입니다.
transfer_occurred boolean 호출 전송을 시도했는지 여부입니다.
active_calls 숫자 호출이 시작될 때의 활성 호출 수입니다.
x-global-sip-trunk-call-id 문자열

초기 SIP INVITE 요청에서 추출한 SIP 트렁크 통화 ID 헤더의 값입니다. 다음 SIP 트렁크 호출 ID 헤더가 지원됩니다.

  • X-Twilio-CallSid
  • X-SID
  • X-Global-SIP-Trunk-Call-ID
call 오브젝트 호출에 대한 정보입니다. call의 내용을 참조하십시오.
session_initiation_protocol 오브젝트 SIP 프로토콜 관련 세부사항입니다. session_initiation_protocol의 내용을 참조하십시오.
max_response_milliseconds 오브젝트 호출 중에 사용되는 서비스의 최대 대기 시간입니다. max_response_milliseconds의 내용을 참조하십시오.
assistant_interaction_summaries 배열 호출 중 발생한 watsonx Assistant 트랜잭션에 대한 세부사항입니다. 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 객체에는 다음과 같은 속성이 포함되어 있습니다.

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

session_initiation_protocol

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

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

assistant_interaction_summaries

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

assistant_interaction_summaries 오브젝트의 특성
특성 유형 설명
assistant_id 문자열 어시스턴트의 고유 식별자입니다.
session_id 문자열 세션의 고유 식별자입니다.
turns 배열 대화 중 발생한 watsonx Assistant 트랜잭션의 배열입니다. assistant_interaction_summaries.turns[]의 내용을 참조하십시오.

assistant_interaction_summaries.turns[]

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

assistant_interaction_summaries.turn[] 배열에 있는 오브젝트의 특성 caption-side
특성 유형 설명
assistant.log_id 문자열 메시지 로그와 CDR 이벤트 간에 상관시키는 데 사용할 수 있는 로그된 이벤트의 고유 ID입니다.
assistant.start_timestamp 문자열 요청이 어시스턴트에게 전송된 시간, ISO 형식 (yyyy-MM-ddTHH:mm:ss.SSSZ).
assistant.response_milliseconds 숫자 요청이 전송된 시점부터 어시스턴트로부터 응답을 받은 시점까지의 시간(밀리초)입니다.
request 오브젝트 어시스턴트에 전송된 요청입니다. assistant_interaction_summaries.turns[].request의 내용을 참조하십시오.
response 배열 요청과 연관된 response 오브젝트의 배열입니다.

assistant_interaction_summaries.turns[].request

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

assistant_interaction_summaries.turn[].request 오브젝트의 특성 caption-side
특성 유형 설명
type 문자열

요청 유형:

  • start: 초기 요청이 어시스턴트에 전송됨
  • speech_to_text: 입력이 Speech to Text 서비스
    에서 수신됨 - dtmf: DTMF 콜렉션 완료
  • sms: 호출자로부터 SMS 메시지가 수신됨
  • post_response_timeout: 사후 응답 타이머가 만료됨
  • redirect: 호출이 경로 재지정됨
  • transfer: 호출이 전송됨
  • transfer_failed: 호출 전송 실패
  • final_utterance_timeout: 최종 발화 타이머 만기
  • no_input_turn: no input turn 사용 가능
  • sms_failure: SMS 메시지를 호출자에게 전송할 수 없음
  • speech_to_text_result_filtered: 낮은 신뢰 레벨로 인해 발화가 필터링됨
  • mrcp_recognition_unsuccessful: MRCP 인식이 최종 발화 없이 완료됨
  • network_warning: 네트워크 오류가 발견되었습니다.
  • media_capability_change: 호출 중 매체 기능이 변경됩니다.
streaming_statistics 오브젝트 Speech to Text 인식과 관련된 정보 및 통계. assistant_interaction_summaries.turns[].request.streaming_statistics의 내용을 참조하십시오.
assistant_interaction_summaries.turns[].request.streaming_statistics

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

assistant_interaction_summaries.turn[].streaming_statistics 오브젝트의 특성 caption-side
특성 유형 설명
transaction_id 문자열 거래의 고유 식별자입니다.
start_timestamp 문자열 트랜잭션이 시작된 시간, ISO 형식(yyyy-MM-ddTHH:mm:ss.SSSZ).
stop_timestamp 문자열 거래가 종료된 시간, ISO 형식(yyyy-MM-ddTHH:mm:ss.SSSZ).
response_milliseconds 숫자 호출자의 음성에서 정적이 발견되고 어시스턴트에서 최종 결과가 수신되는 시점 사이의 대기 시간(밀리초)입니다.
echo_detected 부울 반향이 발견되었는지 여부입니다.
confidence 숫자 최종 발화의 자신감 점수입니다.

assistant_interaction_summaries.turns[].response

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

특성 유형 설명
type 문자열

응답 유형

  • text_to_speech 발신자에게 발화를 재생하는 명령
  • sms: 발신자에게 SMS 메시지를 보내는 명령
  • url: 발신자에게 오디오 파일을 재생하는 명령
  • transfer: 통화를 전송하는 명령
  • text_to_speech_config: Text to Speech 설정을 변경하는 명령
  • speech_to_text_config: Speech to Text 설정을 변경하는 명령
  • pause_speech_to_text: 음성 인식을 중지하는 명령
  • unpause_speech_to_text: 음성 인식을 시작하는 명령
  • pause_dtmf: 인바운드 DTMF 신호의 처리를 중지하는 명령
  • unpause_dtmf: unpause_dtmf : 인바운드 DTMF 신호의 처리를 시작하는 명령
  • enable_speech_barge_in: 발신자가 말을 하여 재생을 중단할 수 있도록 음성 바지인을 활성화하는 명령
  • disable_speech_barge_in: 오디오 재생 중에 발신자가 말할 때 재생이 중단되지 않도록 음성 바지인을 비활성화하는 명령
  • enable_dtmf_barge_in: 발신자가 키를 눌러 전화기 통합에서 재생을 중단할 수 있도록 DTMF 바지인을 활성화하는 명령
  • disable_dtmf_barge_in: 발신자가 키를 누를 때 전화 연동에서 재생이 중단되지 않도록 DTMF 바지인을 비활성화하는 명령
  • dtmf: 발신자에게 DTMF 신호를 보내는 명령
  • hangup: 통화 연결을 끊는 명령
    CDR과 watsonx Assistant 응답 유형 간의 매핑 참조.
barge_in_occurred 부울 변환 중에 개입(barge-in)이 발생했는지 여부입니다.
streaming_statistics 오브젝트 Text to Speech 합성 및 재생과 관련된 정보 및 통계. assistant_interaction_summaries.turns[].response.streaming_statistics의 내용을 참조하십시오.
{: caption="assistant_interaction_summaries.turn[].response object "caption-side = "top"}의 특성
CDR과 watsonx Assistant 응답 유형 간의 맵핑

type 속성 값은 watsonx Assistant 응답 유형에 매핑됩니다.

CDR 응답 유형 watsonx Assistant 응답 유형
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 객체에는 다음과 같은 속성이 포함되어 있습니다.

assistant_interaction_summaries.turn[].response.streaming_statistics 오브젝트의 특성 caption-side
특성 유형 설명
transaction_id 문자열 거래의 고유 식별자입니다.
start_timestamp 문자열 트랜잭션이 시작된 시간, ISO 형식(yyyy-MM-ddTHH:mm:ss.SSSZ).
stop_timestamp 문자열 거래가 종료된 시간, ISO 형식(yyyy-MM-ddTHH:mm:ss.SSSZ).
response_milliseconds 숫자 텍스트 발화가 어시스턴트에게 전송된 시점부터 전화 통합이 합성된 오디오의 첫 번째 패킷을 수신하는 시점까지의 시간(밀리초)입니다.

warnings_and_errors

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

  • 발화가 신뢰도 점수 임계값에 의해 필터링될 때의 메시지입니다.
  • Text to Speech 언더플로우: 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"
    }
  ]

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

warnings_and_errors 오브젝트의 등록 정보
특성 유형 설명
message 문자열 경고 메시지 텍스트입니다.
id 문자열 고유 메시지 ID입니다.

max_response_milliseconds

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

max_response_milliseconds 오브젝트의 특성
특성 유형 설명
assistant 숫자 통화와 관련된 모든 watsonx Assistant 요청에서 계산된 최대 왕복 지연 시간(밀리초)입니다.
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"
   }
}

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

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