> ## 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  | 설정 시 우선 적용             |

<Info>
  에이전트 웹훅 URL이 설정된 경우 해당 URL이 우선 적용됩니다.
  미설정 시 워크스페이스 웹훅 URL로 자동 fallback됩니다.
</Info>

<Info>
  워크스페이스 웹훅은 [오너와 관리자](/docs/workspace/roles)가 변경할 수 있습니다.
  저장된 워크스페이스 웹훅 테스트는 멤버도 실행할 수 있습니다.
  에이전트 웹훅은 워크스페이스 멤버 누구나 설정할 수 있습니다.
</Info>

## 웹훅 버전

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

| 버전        | 종료 이벤트                             | 분석 결과 이벤트                      |
| --------- | ---------------------------------- | ------------------------------ |
| v2        | `call_ended`에서 기본 통화 정보와 스크립트 전송   | `call_analyzed`에서 비용과 분석 결과 전송 |
| v1 기존 유지용 | `call_ended`에서 종료 정보와 분석 결과를 함께 전송 | 별도 이벤트 없음                      |

<Note>
  자세한 페이로드 차이는 [에이전트 단위 웹훅](/docs/operate/monitor/webhooks/agent#v2-웹훅-페이로드-예시)을 참고하세요.
</Note>

## 세부 문서

<CardGroup cols={3}>
  <Card title="워크스페이스 단위 웹훅" icon="server" href="/docs/operate/monitor/webhooks/organization">
    워크스페이스 기본 웹훅 설정, 보안, HMAC 검증 방식을 확인하세요.
  </Card>

  <Card title="에이전트 단위 웹훅" icon="monitor-waveform" href="/docs/operate/monitor/webhooks/agent">
    에이전트별 통화 이벤트와 페이로드 예시를 확인하세요.
  </Card>

  <Card title="웹훅 스키마" icon="code" href="/docs/operate/monitor/webhooks/schema">
    이벤트별 필드 타입과 수신 서버 구현 체크리스트를 확인하세요.
  </Card>
</CardGroup>

<Tip>
  빠른 예시는 **에이전트 단위 웹훅** 문서를, 필드 레퍼런스는 **웹훅 스키마** 문서를 참고하세요.
  웹훅 URL/서명 키/보안 설정은 **워크스페이스 단위 웹훅** 문서에서 확인하세요.
</Tip>

***

<Accordion title="연관 검색어">
  웹훅, webhook, 웹훅 설정, 워크스페이스 웹훅, 에이전트 웹훅, 우선순위, fallback, webhook v2, webhook v1, call\_analyzed
</Accordion>