Skip to main content
통화 데이터 웹훅은 통화와 상담사 통화가 진행되는 동안 이벤트를 외부 서버로 보내요. 워크스페이스 URL과 에이전트 URL 어느 쪽으로 받아도 같은 이벤트가 오고, 이벤트마다 전송 결과는 통화 상세의 웹훅 로그에 남아요. 통화 상세의 웹훅 로그에 보이는 call_started, call_ended, call_analyzed 전송 결과

지원하는 이벤트

이벤트 이름은 event 필드로 구분해요. operator_call_started와 operator_call_ended는 본문 키가 operator_call이고, 상담사 구간의 mid_call을 포함한 나머지 통화 이벤트는 call이에요. call_ended에는 call_cost와 call_analysis가 없어요. 비용과 분석 결과는 call_analyzed에서 받으세요. 개인정보 마스킹을 켠 에이전트는 대화 내용, 요약, 도구 호출 인자와 결과를 가린 내용으로만 보내고, 추출 항목과 전화번호 필드는 원문 그대로 보내요. 통화 유형마다 이벤트가 오는 순서와 시점은 이벤트 라이프사이클에 있어요.

처리할 이벤트 고르기

한 통화에서 여러 이벤트가 오므로 하려는 일에 맞는 이벤트만 처리하세요. 재시도와 중복 처리 규칙은 전달 보장과 재시도에 있어요.

수신 서버 만들기

웹훅 요청을 받을 HTTPS 엔드포인트를 준비하세요. 아래 예시는 이벤트 이름으로 처리를 나누고 200을 돌려줘요.
서명 검증은 워크스페이스 단위 웹훅에 있어요.

에이전트별 웹훅 URL 연결하기

에이전트마다 다른 서버로 받으려면 에이전트 설정에 URL을 넣으세요. 에이전트 URL이 없으면 워크스페이스 URL로 가요. 우선순위는 웹훅 유형 비교에 있어요.
1

통화 데이터 웹훅 URL 넣기

에이전트 설정의 웹훅 설정 섹션에서 통화 데이터 웹훅 URL에 수신 서버 주소를 넣으세요.에이전트 설정의 웹훅 설정 섹션과 통화 데이터 웹훅 URL 입력란
2

시험 요청 보내기

URL 옆 테스트를 눌러 수신 서버가 요청을 받는지 보세요.
3

실제 통화로 확인하기

통화를 한 건 걸고 통화 상세의 웹훅 로그에서 이벤트마다 전송 결과를 보세요.
데이터 보존 정책에 따라 통화 콘텐츠가 삭제되면 대시보드에서 다시 볼 수 없어요. 웹훅으로 받은 데이터를 계속 쓰려면 수신 서버에 저장하세요.

관련 문서