> ## 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.

# 알림

> 지표 이상을 감지하고 자동으로 알림을 받으세요.

지표가 임계값을 초과하면 웹훅, 이메일, Slack으로 즉시 알림을 받으세요. 오류 급증, 통화량 변동 등을 실시간으로 감지할 수 있습니다.

```mermaid theme={null}
flowchart LR
    A[규칙 생성] --> B[조건 감지]
    B --> C[인시던트 생성]
    C --> D[알림 발송]
    D --> E[해소]
```

대시보드 사이드바에서 **알림**을 클릭하면 진입합니다.

## 알림 규칙 생성

<Steps>
  <Step title="새 규칙 추가">
    알림 페이지에서 **규칙 추가** 버튼을 클릭하세요.
  </Step>

  <Step title="지표 선택">
    모니터링할 지표를 선택하세요.

    | 지표           | 설명                      |
    | ------------ | ----------------------- |
    | **통화 수**     | 기간 내 총 통화 건수.           |
    | **동시 통화 수**  | 현재 진행 중인 동시 통화 수.       |
    | **도구 호출 수**  | 에이전트의 도구 호출 횟수.         |
    | **API 호출 수** | API 노드 또는 API 도구 호출 횟수. |
  </Step>

  <Step title="조건 설정">
    알림이 발동되는 조건을 설정하세요.

    | 항목         | 설명                                                                           |
    | ---------- | ---------------------------------------------------------------------------- |
    | **비교 연산자** | `>`, `>=`, `<`, `<=` 중 선택합니다.                                                |
    | **임계값 유형** | 현재는 절대값을 사용합니다. 상대값은 준비 중입니다.                                                |
    | **임계값**    | 알림 기준이 되는 값입니다.                                                              |
    | **시간 윈도우** | 지표를 집계하는 기간입니다. `1분`, `5분`, `15분`, `30분`, `1시간`, `4시간`, `8시간`, `1일` 중 선택하세요. |
    | **평가 빈도**  | 조건을 확인하는 간격입니다. 시간 윈도우와 같은 선택지를 사용합니다.                                       |

    필요하면 지표별 필터를 추가하여 특정 조건의 데이터만 모니터링할 수 있습니다.

    | 지표       | 사용 가능한 필터                            |
    | -------- | ------------------------------------ |
    | 통화 수     | 에이전트, 종료 사유                          |
    | 동시 통화 수  | 필터 없음                                |
    | 도구 호출 수  | 에이전트, 도구, 성공/실패                      |
    | API 호출 수 | 에이전트, 성공/실패, API 필터(메서드, URL, 상태 코드) |
  </Step>

  <Step title="알림 채널 설정">
    알림을 받을 채널을 하나 이상 설정하세요.

    | 채널        | 설명                                                 |
    | --------- | -------------------------------------------------- |
    | **웹훅**    | 워크스페이스 웹훅 설정에 등록된 조직 웹훅 URL로 POST 요청을 전송합니다.       |
    | **이메일**   | 규칙에 추가한 이메일 주소로 알림을 전송합니다.                         |
    | **Slack** | Slack Incoming Webhook URL을 입력하면 해당 채널에 알림이 전달됩니다. |
  </Step>

  <Step title="활성 스케줄 설정 (선택)">
    특정 시간대에만 알림을 받으려면 활성 스케줄을 설정하세요. 요일과 시작/종료 시간을 지정할 수 있습니다.

    예를 들어 영업 시간(평일 09:00\~18:00)에만 알림을 받고, 그 외 시간에는 알림을 끌 수 있습니다.
  </Step>

  <Step title="저장">
    **저장** 버튼을 클릭하면 규칙이 활성화됩니다.
  </Step>
</Steps>

## 인시던트 확인

알림 조건이 충족되면 인시던트가 생성됩니다. 알림 페이지에서 규칙을 선택하면 해당 규칙의 인시던트 기록을 확인할 수 있습니다.

## 규칙 관리

* **일시 중지** — 규칙을 삭제하지 않고 일시적으로 비활성화할 수 있습니다.
* **웹훅 테스트** — 채널 설정에서 테스트 알림을 전송해 연결 상태를 확인하세요.

<Note>
  조직당 최대 **10개**까지 알림 규칙을 생성할 수 있습니다.
</Note>

## 권장 알림 설정

| 시나리오      | 지표                               | 조건  | 시간 윈도우 |
| --------- | -------------------------------- | --- | ------ |
| 시스템 오류 감지 | 통화 수 + `error_voxai` 필터          | > 0 | 5분     |
| 잔액 부족 감지  | 통화 수 + `insufficient_balance` 필터 | > 0 | 5분     |
| API 실패 감지 | API 호출 수 + 실패 필터                 | > 0 | 5분     |

## 관련 문서

* [분석](/docs/operate/monitor/analytics) — 전체 지표 대시보드
* [통화종료사유](/docs/operate/monitor/disconnection-reasons) — 종료 사유별 의미와 대응
* [워크스페이스 웹훅](/docs/operate/monitor/webhooks/organization) — HMAC 서명 검증

***

<Accordion title="연관 검색어">
  알림, alerts, 알림 규칙, 임계값, Slack, 이메일 알림, 인시던트, 오류 감지
</Accordion>