이 페이지에서는 Contact Center AI Platform (CCAI Platform)에서 품질 관리 (QM) 애플리케이션으로 내보낼 수 있는 통화 세션 이벤트 데이터를 설명합니다. CCAI Platform을 QM 애플리케이션과 통합하는 방법에 대한 자세한 내용은 QM, SIPREC, WFM 통합을 참고하세요.
채팅 세션 이벤트 데이터는 QM 채팅 세션 이벤트 데이터를 참고하세요.
통화 세션 이벤트 및 트리거
특정 통화 세션 이벤트는 통화 세션 데이터를 QM 애플리케이션으로 내보내는 것을 트리거합니다. 이 섹션에는 통화 이벤트 유형과 각 유형을 트리거하는 작업이 나열되어 있습니다. 각 세션 이벤트 유형의 세션 이벤트 페이로드 예시도 포함되어 있습니다.
상담사가 로그인함
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 Contact Center AI Platform 포털을 사용하여 상담사 어댑터에 로그인합니다.
상담사가 CRM을 사용하여 상담사 어댑터에 로그인합니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "AgentState",
"item" : {
"ParticipantID" : "1234",
"Email" : "some.email@domain.com",
"State" : "login"
}
}
상담사가 로그아웃함
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 Contact Center AI Platform 포털을 사용하여 상담사 어댑터에서 로그아웃합니다.
상담사가 CRM을 사용하여 상담사 어댑터에서 로그아웃합니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "AgentState",
"item" : {
"ParticipantID" : "1234",
"Email" : "some.email@domain.com",
"State" : "logout"
}
}
인바운드 전화가 프로젝션됨
이 이벤트는 최종 사용자가 고객센터에 전화를 걸고 전화가 상담사에게 전달될 때 트리거됩니다.
이 이벤트는 델타캐스트를 위해 통화가 프로젝션되는 경우에만 적용됩니다. 멀티캐스트 프로젝션은 이벤트를 트리거하지 않습니다. 캐스케이드 그룹의 호출에 대한 첫 번째 deltacast 프로젝션만 이벤트를 트리거합니다.
이 이벤트에는 통화 트랜스퍼, 리디렉션, 디플렉션을 통해 수신된 통화 프로젝션이 포함됩니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "ringing",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "ringing"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
인바운드 전화에 응답함
이 이벤트는 상담사가 예상 통화에 응답할 때 트리거됩니다.
이 이벤트는 델타캐스트 또는 멀티캐스트 프로젝션 모두에서 상담사가 통화에 응답할 때 적용됩니다. 이 이벤트는 통화 리디렉션 및 전환을 통해 수신되고 응답된 통화에 적용됩니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
아웃바운드 전화가 울림
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 새 아웃바운드 전화를 걸고 최종 사용자에게 전화벨이 울립니다.
상담사가 참여자 추가 통화를 다이얼하고 통화가 서드 파티에 울립니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "e9dd62bb",
"State" : "dialing",
"Direction" : "outgoing",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
},
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
아웃바운드 전화에 응답함
이 이벤트는 다음 작업에 의해 트리거됩니다.
최종 사용자가 아웃바운드 전화를 받습니다.
서드 파티가 참여자 추가 통화에 응답합니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "e9dd62bb",
"State" : "connected",
"Direction" : "outgoing",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
},
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화가 대기 상태로 전환됨
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 최종 사용자를 대기 상태로 전환합니다.
상담사가 서드 파티를 대기 상태로 설정합니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "held",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "held"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화가 대기 상태에서 삭제됨
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 대기 상태에서 최종 사용자를 삭제합니다.
상담사가 대기 상태에서 서드 파티를 삭제합니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
콜드 트랜스퍼가 시작되고 수락됨
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 다른 상담사에게 콜드 트랜스퍼 전화를 걸고 트랜스퍼가 수락됩니다.
상담사가 다른 대기열에 콜드 트랜스퍼 통화를 걸고 해당 대기열의 상담사가 트랜스퍼를 수락합니다.
상담사가 다른 상담사를 통화 컨퍼런스에 콜드 초대하고 다른 상담사가 수락하여 통화 컨퍼런스에 참여합니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "transferred",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
웜 트랜스퍼가 시작되고 수락됨
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 다른 상담사에게 사전 안내 후 전달 통화를 걸고 전달이 수락됩니다.
상담사가 다른 대기열에 사전 안내 후 전달 통화를 걸고 해당 대기열의 상담사가 트랜스퍼를 수락합니다.
상담사가 다른 상담사를 통화 컨퍼런스에 사전 안내 후 초대하고 다른 상담사가 수락하여 통화 컨퍼런스에 참여합니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "conferenced",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "connected"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
상담사가 통화 컨퍼런스를 종료함
이 이벤트는 통화 컨퍼런스에 참여 중인 상담사가 통화 컨퍼런스를 종료하지 않고 나갈 때 트리거됩니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "participantDisconnect",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "disconnected"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "connected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화가 음소거됨
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 통화를 음소거합니다.
상담사가 통화에서 다른 참석자를 음소거합니다.
이 이벤트는 모든 통화에 적용됩니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,\
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "muted"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "muted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화가 음소거 해제됨
이 이벤트는 다음 작업에 의해 트리거됩니다.
상담사가 통화의 음소거를 해제합니다.
상담사가 통화에서 다른 참석자의 음소거를 해제합니다.
이 이벤트는 모든 통화에 적용됩니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "connected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "unmuted"
},
{
"ParticipantID" : "4321",
"Type" : "agent",
"State" : "unmuted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화가 수정됨
이 이벤트는 상담사가 통화를 수정할 때 트리거됩니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "redacted"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "redacted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화가 수정되지 않음
이 이벤트는 상담사가 통화의 수정 사항을 삭제할 때 트리거됩니다.
다음 코드 샘플은 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "connected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "unredacted"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "unredacted"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화가 종료됨
이 이벤트는 다음 작업에 의해 트리거됩니다.
최종 사용자가 통화를 종료합니다.
상담사가 통화를 종료합니다.
이 이벤트는 모든 통화에 적용됩니다.
다음 코드 샘플은 인바운드 통화 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "846802bf90d1",
"State" : "disconnected",
"Direction" : "incoming",
"Initiator" : "+123456789",
"Queue_path_ids": "1/2/3",
"Queue_path_names" : "support/orders/status",
"Language" : "en",
"Queue_uuid" : 3,
"Recording_permitted" : true,
"Participants" :
[
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "disconnected"
},
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "disconnected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
다음 코드 샘플은 아웃바운드 통화 이벤트 페이로드를 보여줍니다.
{
"type" : "CallState",
"item" : {
"CallID" : "e9dd62bb",
"State" : "disconnected",
"Direction" : "outgoing",
"Initiator" : "1234",
"Participants" :
[
{
"ParticipantID" : "1234",
"Type" : "agent",
"State" : "disconnected"
},
{
"ParticipantID" : "+123456789",
"Type" : "external",
"State" : "disconnected"
}
],
"MediaID" : "208188811_124248155@67.231.1.110"
}
}
통화 세션 이벤트 필드
다음 표에서는 Contact Center AI Platform이 QM 애플리케이션으로 내보내는 세션 데이터의 필드를 설명합니다.
일반 필드
| 필드 이름 | 허용되는 값 | 설명 | 효과 |
|---|---|---|---|
type |
|
전체 JSON 페이로드의 이벤트 유형입니다. |
|
|
이벤트 정보가 포함된 객체입니다. |
상담사 상태 필드
| 필드 이름 | 값 | 설명 | 동작 |
|---|---|---|---|
|
상담사 ID |
Contact Center AI Platform 시스템의 상담사 식별자입니다. |
|
|
이메일 주소 |
상담사의 이메일 주소입니다. |
|
|
|
이벤트 발생 시 상담사의 상태입니다. |
|
통화 상태 필드
| 필드 이름 | 값 | 설명 | 동작 |
|---|---|---|---|
|
통화 ID |
Contact Center AI Platform 시스템의 통화 세션 식별자입니다. |
|
|
|
통화 세션의 현재 상태입니다. |
|
|
|
콜 센터 관점에서 본 통화 세션의 방향입니다. |
|
|
|
통화 상태를 초기화하는 당사자의 식별자입니다. |
|
|
대기열 ID의 경로 |
통화의 첫 번째 상담사에게 도달하기 전에 최종 사용자가 탐색한 대기열 경로입니다. 이 값은 탐색된 대기열의 대기열 ID를 사용하여 구성됩니다. |
이는 수신 전화에만 적용됩니다. |
|
큐 이름의 경로 |
통화의 첫 번째 상담사에게 도달하기 전에 최종 사용자가 탐색한 대기열 경로입니다. 이 값은 탐색된 대기열의 대기열 이름을 사용하여 구성됩니다. |
이는 수신 전화에만 적용됩니다. |
|
언어 코드 |
최종 사용자가 선택한 언어의 언어 코드입니다. |
이는 수신 전화에만 적용됩니다. |
|
대기열 ID |
통화가 도달하는 대기열의 UUID입니다. |
이는 수신 전화 및 대기열에서 트랜스퍼된 통화에만 적용됩니다. |
|
부울 |
특정 통화에 통화 녹음이 허용되는지 여부를 나타냅니다. |
|
|
맞춤 헤더 |
이 필드는 SIP 헤더와 같은 맞춤 데이터를 전달하는 데 사용됩니다. |
|
|
이 객체는 통화 참여자의 정보가 포함된 객체입니다. |
||
|
|
통화 참여자의 식별자입니다. |
Contact Center AI Platform 세션 메타데이터의
Contact Center AI Platform 세션 메타데이터의 참가자 객체에 있는
사용 가능한 경우 최종 사용자의 전화번호를 전달합니다. 그렇지 않으면 Contact Center AI Platform 세션 메타데이터의
사용 가능한 경우 서드 파티의 전화번호를 전달합니다. 그렇지 않으면 값 |
|
|
통화 참여자 유형입니다. |
|
|
|
통화 컨퍼런스에서 참여자의 현재 상태입니다. |
|
|
|
이동통신사의 통화 세션 미디어 식별자입니다. |
|