웹훅
통화 데이터 웹훅 개요
웹훅
통화 데이터 웹훅 개요
통화 시작/종료 후 정보를 수신하여 애플리케이션에 통합할 수 있습니다.
1. 지원되는 이벤트 유형
다음과 같은 webhoook 이벤트를 지원합니다:
| 이벤트 유형 | 설명 | 페이로드 |
|---|---|---|
| call_started | 통화가 시작되었을 때 트리거됩니다. 통화 시작 시간과 기본 정보를 포함합니다. | 통화 정보 |
| call_ended | 통화가 종료되었을 때 트리거됩니다. 통화 시간과 통화 내용 등의 정보를 포함합니다. | 통화 정보 |
2. 웹훅 활용 사례
시스템 통합
- 통화 완료 시 CRM 레코드 업데이트
- 통화 분석 결과 기반 워크플로우 자동화 실행
- 데이터베이스에 통화 기록 저장
통화 모니터링
- 통화 시간과 완료 상태 추적
- 상담원 실시간 성과 모니터링
[민감 데이터 저장 금지]를 활성화한 경우, 주요 통화 정보가 저장되지 않습니다. 중요 데이터의 지속적인 활용을 위해 웹훅을 통한 데이터 수집 및 저장을 적극 권장합니다.
3. 웹훅 페이로드 예시
{
"event": "call_started",
"call": {
"agent_id": "7ea3516d-08f6-4129-ab40-a731e379b320",
"call_id": "3079f46c-d141-4cd9-805f-69f212136b66",
"call_type": "web",
"call_from": null,
"call_to": null,
"dynamic_variables": {
"last_call_at": "2024-12-18T15:45:12Z"
},
"metadata": {
"db_user_uid": "1a7d624b-76fe-4326-90dc-487935e55212"
},
"start_timestamp": 1741842354957,
"opt_out_sensitive_data_storage": false
}
}
{
"event": "call_started",
"call": {
"agent_id": "7ea3516d-08f6-4129-ab40-a731e379b320",
"call_id": "3079f46c-d141-4cd9-805f-69f212136b66",
"call_type": "web",
"call_from": null,
"call_to": null,
"dynamic_variables": {
"last_call_at": "2024-12-18T15:45:12Z"
},
"metadata": {
"db_user_uid": "1a7d624b-76fe-4326-90dc-487935e55212"
},
"start_timestamp": 1741842354957,
"opt_out_sensitive_data_storage": false
}
}
{
"event": "call_ended",
"call": {
"agent_id": "7ea3516d-08f6-4129-ab40-a731e379b320",
"call_id": "3079f46c-d141-4cd9-805f-69f212136b66",
"call_type": "web",
"call_from": null,
"call_to": null,
"dynamic_variables": {
"last_call_at": "2024-12-18T15:45:12Z"
},
"metadata": {
"db_user_uid": "1a7d624b-76fe-4326-90dc-487935e55212"
},
"disconnection_reason": "user_hangup",
"start_timestamp": 1741652312146,
"end_timestamp": 1741652351189,
"duration_ms": 39043,
"transcript": [
{
"role": "agent",
"content": "안녕하세요. 상담사 신유진입니다. 먼저 본인 확인을 위해 예약자분 성함을 말씀해주시겠어요?"
},
{ "role": "user", "content": "한승준입니다." },
{
"role": "agent",
"content": "네, 잠시만 기다려주세요. 예약자 정보를 확인하고 있습니다."
},
{
"role": "agent",
"content": "예약자 정보 확인이 완료되었습니다. 감사합니다. 혹시 어떠한 사유로 연락을 주셨을까요?"
}
],
"transcript_with_tool_calls": [
{
"role": "agent",
"content": "안녕하세요. 상담사 신유진입니다. 먼저 본인 확인을 위해 예약자분 성함을 말씀해주시겠어요?"
},
{ "role": "user", "content": "한승준입니다." },
{
"role": "agent",
"content": "네, 잠시만 기다려주세요. 예약자 정보를 확인하고 있습니다."
},
{
"role": "tool_call_invocation",
"tool_call_id": "ee87e2213039",
"name": "verify_identity",
"arguments": {
"call_from": "01012345678",
"user_provided_name": "한승준"
}
},
{
"role": "tool_call_result",
"tool_call_id": "ee87e2213039",
"content": "{\"result\":{\"user_id\":\"USR12345\",\"name\":\"한승준\",\"verification_status\":\"verified\",\"customer_type\":\"premium member\",\"last_visit\":\"2024-12-25\"}}"
},
{
"role": "agent",
"content": "예약자 정보 확인이 완료되었습니다. 감사합니다. 혹시 어떠한 사유로 연락을 주셨을까요?"
}
],
"recording_url": "https://storage.googleapis.com/agentify/egress/AFnsj7RP/audio_recording.ogg",
"call_cost": { "total_credits_used": 45, "duration_seconds": 39 },
"call_analysis": {
"summary": "본 통화는 상담원 신유진이 한승준 고객의 예약자 정보 확인을 진행한 통화 요약입니다. 고객은 본인 확인에 성공적으로 응답했습니다.",
"user_sentiment": "neutral",
"custom_analysis_data": [
{
"type": "string",
"name": "문의사항",
"value": "본인인증 후 추가 문의사항 없이 고객이 통화를 종료하였습니다."
},
{ "type": "boolean", "name": "문제 해결 여부", "value": false }
]
},
"opt_out_sensitive_data_storage": false
}
}