Documentation Index
Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
Use this file to discover all available pages before exploring further.
개요
웹훅은 이벤트 발생 즉시 외부 시스템으로 데이터를 전송하는 방식입니다. vox.ai는 워크스페이스 단위 웹훅과 에이전트 단위 웹훅을 제공합니다.웹훅 유형 비교
| 유형 | 설정 위치 | 용도 | 적용 우선순위 |
|---|---|---|---|
| 워크스페이스 | 설정 > 웹훅 | 워크스페이스 기본 웹훅 URL | 에이전트 웹훅이 없을 때 fallback |
| 에이전트 | 에이전트 설정 > 웹훅 설정 섹션 | 에이전트별 개별 웹훅 URL | 설정 시 우선 적용 |
에이전트 웹훅 URL이 설정된 경우 해당 URL이 우선 적용됩니다.
미설정 시 워크스페이스 웹훅 URL로 자동 fallback됩니다.
워크스페이스 웹훅은 오너만 변경할 수 있습니다.
에이전트 웹훅은 워크스페이스 멤버 누구나 설정할 수 있습니다.
웹훅 버전
통화 데이터 웹훅은 v2를 기본 형식으로 사용합니다. 새 연동은 v2로 구현하세요. v1은 기존 수신 서버를 유지해야 하는 경우를 위한 형식입니다.| 버전 | 종료 이벤트 | 분석 결과 이벤트 |
|---|---|---|
| v2 | call_ended에서 기본 통화 정보와 스크립트 전송 | call_analyzed에서 비용과 분석 결과 전송 |
| v1 기존 유지용 | call_ended에서 종료 정보와 분석 결과를 함께 전송 | 별도 이벤트 없음 |
자세한 페이로드 차이는 에이전트 단위 웹훅을 참고하세요.
세부 문서
워크스페이스 단위 웹훅
워크스페이스 기본 웹훅 설정, 보안, HMAC 검증 방식을 확인하세요.
에이전트 단위 웹훅
에이전트별 통화 이벤트와 페이로드 예시를 확인하세요.
웹훅 스키마
이벤트별 필드 타입과 수신 서버 구현 체크리스트를 확인하세요.
연관 검색어
연관 검색어
웹훅, webhook, 웹훅 설정, 워크스페이스 웹훅, 에이전트 웹훅, 우선순위, fallback, webhook v2, webhook v1, call_analyzed