Skip to main content
웹훅은 이벤트 발생 즉시 외부 시스템과 데이터를 주고받는 방식입니다. vox.ai 웹훅은 두 종류입니다. 인바운드 웹훅은 인바운드 웹훅 가이드에서 다룹니다. 이 그룹의 문서는 통화 데이터 웹훅을 다루며, 워크스페이스 단위와 에이전트 단위로 설정할 수 있습니다.

웹훅 유형 비교

에이전트 웹훅 URL이 설정된 경우 해당 URL이 우선 적용됩니다. 미설정 시 워크스페이스 웹훅 URL로 자동 fallback됩니다.
워크스페이스 웹훅은 오너와 관리자가 변경할 수 있습니다. 저장된 워크스페이스 웹훅 테스트는 멤버도 실행할 수 있습니다. 에이전트 웹훅은 워크스페이스 멤버 누구나 설정할 수 있습니다.

웹훅 버전

통화 데이터 웹훅은 v2를 기본 형식으로 사용합니다. 새 연동은 v2로 구현하세요. v1은 기존 수신 서버를 유지해야 하는 경우를 위한 형식입니다.
자세한 페이로드 차이는 에이전트 단위 웹훅을 참고하세요.

세부 문서

워크스페이스 단위 웹훅

워크스페이스 기본 웹훅 설정, 보안, HMAC 검증 방식을 확인하세요.

에이전트 단위 웹훅

에이전트별 통화 이벤트와 페이로드 예시를 확인하세요.

웹훅 스키마

이벤트별 필드 타입과 수신 서버 구현 체크리스트를 확인하세요.
빠른 예시는 에이전트 단위 웹훅 문서를, 필드 레퍼런스는 웹훅 스키마 문서를 참고하세요. 웹훅 URL/서명 키/보안 설정은 워크스페이스 단위 웹훅 문서에서 확인하세요.

웹훅, webhook, 웹훅 설정, 인바운드 웹훅, 통화 데이터 웹훅, 워크스페이스 웹훅, 에이전트 웹훅, 우선순위, fallback, webhook v2, webhook v1, call_analyzed