> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 알림

## 개요

알림은 워크스페이스의 에이전트에서 문제가 발생했을 때 알려줍니다. ElevenLabs는 대화 활동을 지속적으로 모니터링하며, 오류율이 구성된 임곗값을 초과하거나 최근 기준치보다 크게 상승하면 알림을 발생시킵니다. 알림은 별도 설정 없이 바로 작동합니다. 모니터는 기본 임곗값으로 자동 실행되며, 필요에 따라 임곗값을 조정하거나 알림 수신을 추가할 수 있습니다.

알림은 ElevenLabs 대시보드에서 확인하고 관리하며, 워크스페이스 및 에이전트 수준에서 설정할 수 있습니다. 에이전트 수준 설정은 [에이전트 업데이트](/docs/ko/api-reference/agents/update) API, SDK 또는 [Agents CLI](/docs/ko/eleven-agents/operate/cli) 구성 파일을 사용해 에이전트를 생성하거나 업데이트할 때 `platform_settings.alerting` 필드를 통해 프로그래밍 방식으로도 설정할 수 있습니다. 워크스페이스 수준 설정과 알림 기록은 대시보드에서만 사용할 수 있습니다.

다음 모니터는 모든 에이전트에 대해 평가됩니다.

| 알림 유형    | 트리거                              |
| -------- | -------------------------------- |
| 대화 실패    | 오류가 대화의 일정 비율을 초과                |
| 도구 실패    | 오류가 도구 호출의 일정 비율을 초과하며, 도구별로 추적됨 |
| 웹훅 오류    | 오류가 웹훅 호출의 일정 비율을 초과             |
| 가드레일 트리거 | 가드레일 트리거가 대화의 일정 비율을 초과          |
| 통화 시작 오류 | 오류가 통화 시작의 일정 비율을 초과             |
| 평가 성공 점수 | 평균 평가 성공 점수가 임곗값 아래로 하락          |

각 알림에는 다음 상태 중 하나가 적용됩니다.

* **활성**: 현재 조건이 발생 중입니다.
* **해결됨**: 조건 발생이 중단되었으며 일정 기간 비활성 상태 후 알림이 자동으로 해결되었습니다.
* **해제됨**: 사용자가 알림을 수동으로 해제했습니다.

## 알림 보기

[**개발자** > **알림**](https://elevenlabs.io/app/developers/alerts)으로 이동하면 워크스페이스 에이전트의 최근 모니터링 알림을 확인할 수 있습니다. 이 페이지에는 알림 활동 타임라인과 각 알림의 타임스탬프, 지속 시간, 상태, 유형 및 에이전트를 나열하는 표가 표시됩니다. 상태, 에이전트 또는 도구로 필터링하고 기간을 조정할 수 있으며, 최대 90일까지 선택할 수 있습니다.

![대시보드의 알림 페이지](/docs/_fern-img/d2dbe97d07149ab05ea88cff5300146de39682532a84d1a37326b01dbc04ba9f.webp)

알림을 클릭해 영향을 받은 대화를 열거나, 행 메뉴에서 **대화 검사**를 사용해 대화 기록에서 확인하세요. 활성 알림은 같은 메뉴에서 해제할 수 있습니다.

활성 알림은 각 에이전트 페이지의 개요 대시보드인 [**Spotlight**](/docs/ko/eleven-agents/dashboard/spotlight)에도 우선순위가 높은 카드로 표시됩니다. 또한 워크스페이스에 활성 알림이 있으면 Agents 대시보드의 배너가 알림 페이지로 연결됩니다.

## 임곗값 구성

알림 임곗값은 워크스페이스 수준에서 구성하고 에이전트별로 재정의할 수 있습니다. 설정하지 않은 값은 워크스페이스 구성을 따르며, 워크스페이스 값도 설정하지 않은 경우 시스템 기본값을 사용합니다.

> **Note**
>
> 워크스페이스 수준 알림 설정은 워크스페이스 관리자만 변경할 수 있습니다.

[**개발자** > **알림**](https://elevenlabs.io/app/developers/alerts) 페이지에서 **알림 설정**을 클릭하고 **임곗값 구성**을 선택하세요. 단일 에이전트의 임곗값을 재정의하려면 에이전트 **고급** 설정 탭의 **알림 설정** 섹션을 열고 **임곗값 구성**을 클릭하세요.

각 모니터는 활성화하거나 비활성화할 수 있으며, **임곗값** 설정이 있습니다. 이는 알림을 트리거하는 오류율로, 0%에서 100% 사이의 백분율입니다. 또한 **비활성 상태 후 자동 해결(분)** 을 설정하여 알림이 자동으로 해결되기 전까지 비활성 상태로 유지될 수 있는 시간을 제어할 수 있습니다.

![에이전트 고급 탭의 알림 설정](/docs/_fern-img/d951fa5b6cd3c39590227a893874426be4b0629cd84a6d9919b584a977d2cfdc.webp)

## 알림 수신

알림은 [워크스페이스 웹훅](/docs/ko/eleven-api/resources/webhooks), Slack 및 PagerDuty를 통해 외부 시스템에 알릴 수 있습니다. 알림이 발생하거나 해결 또는 해제되면 ElevenLabs는 구성된 각 노티파이어에 알립니다. 노티파이어는 워크스페이스 수준과 에이전트별로 연결할 수 있으며, 에이전트 수준 노티파이어는 워크스페이스 노티파이어를 대체하지 않고 추가됩니다. 각 수준에서 최대 10개의 노티파이어를 구성할 수 있습니다.

노티파이어를 설정하려면 [**개발자** > **알림**](https://elevenlabs.io/app/developers/alerts) 페이지에서 **알림 설정** > **알림 수신 구성**을 클릭하세요. 단일 에이전트의 경우 에이전트 **고급** 설정 탭의 **알림 설정** 섹션에서 **알림 수신 구성**을 클릭하세요. 각 노티파이어에는 알림이 발생하기 전에 전달을 확인할 수 있는 **테스트 전송** 작업이 있습니다.

### 웹훅

기존 워크스페이스 웹훅을 선택하거나 HTTPS 콜백 URL로 새 웹훅을 만드세요. ElevenLabs는 모든 알림 수명 주기 이벤트에 대해 POST 요청을 전송합니다. 엔드포인트는 요청 서명을 확인하고 즉시 HTTP 200을 반환해야 합니다. 반복적으로 실패하는 웹훅은 다른 [워크스페이스 웹훅](/docs/ko/eleven-api/resources/webhooks)과 동일한 규칙에 따라 자동으로 비활성화됩니다.

#### 알림 페이로드

알림 알림은 `convai_alerting_notification` 이벤트 유형을 사용합니다. `event.name` 필드는 발생한 일을 나타냅니다. 알림이 활성화되면 `triggered`, 비활성 상태 후 해결되면 `auto_resolved`, 사용자가 해제하면 `resolved`가 됩니다(이 경우 `was_resolved_by_user`는 `true`입니다). `text` 필드에는 Slack 마크업으로 형식화된 사람이 읽을 수 있는 요약이 포함되므로, 알림을 Slack 수신 웹훅으로 직접 전달할 수 있습니다.

```json
{
  "type": "convai_alerting_notification",
  "event_timestamp": 1739537297,
  "text": ":rotating_light: *New agent alert - High tool failure rate*\n*Agent:* <https://elevenlabs.io/app/agents/agents/agent_7101k5zvyjhmfg983brhmhkd98n6|Support agent>\n*Status:* Triggered\n*Started at:* 14 February at 12:48 UTC",
  "event": {
    "name": "triggered",
    "was_resolved_by_user": false
  },
  "alert": {
    "id": "alert_2601k5zvyjhmfg983brhmhkd98n6",
    "tool_name": "get_order_status",
    "monitor": "elevated_tool_failure_rate",
    "metric_name": "tool_failure_rate",
    "status": "active",
    "first_triggered_at_unix_secs": 1739537297,
    "last_triggered_at_unix_secs": 1739537897
  }
}
```

`monitor` 필드는 `elevated_conversation_failure_rate`, `elevated_tool_failure_rate`, `webhook_error_spike`, `guardrail_trigger_spike`, `call_initiation_error_spike` 또는 `low_evaluation_success_score` 중 하나입니다. `tool_name` 필드는 도구 실패 알림에만 설정됩니다.

### Slack

Slack 노티파이어는 알림을 Slack 채널에 직접 게시합니다. [Slack 통합](/docs/ko/eleven-agents/customization/integrations/slack)을 워크스페이스에 연결한 다음, 해당 연결을 노티파이어로 추가하고 게시할 채널의 ID를 입력하세요. Slack에서 채널 ID를 찾으려면 채널을 열고 헤더에서 채널 이름을 클릭한 다음, **정보** 탭 하단으로 스크롤하여 채널 ID를 복사하세요(예: `C0123456789`). 연결된 Slack 앱을 채널에 추가하세요. 앱에는 `chat:write` 범위가 필요하며, 참여하지 않은 공개 채널에 게시하려면 `chat:write.public`이 필요합니다. 알림이 발생할 때와 해결될 때 각각 메시지가 게시됩니다.

### PagerDuty

PagerDuty 노티파이어는 [Events API](https://developer.pagerduty.com/docs/events-api-v2-overview)를 통해 알림을 PagerDuty 인시던트로 전달합니다. [통합 페이지](https://elevenlabs.io/app/agents/integrations)에서 알림을 수신할 PagerDuty 서비스의 Events API v2 통합 키를 사용해 PagerDuty 통합을 연결한 다음, 해당 연결을 노티파이어로 추가하세요. 알림이 활성화되면 인시던트가 트리거되고 알림이 해결되면 자동으로 해결됩니다. 동일한 알림이 반복적으로 트리거되면 하나의 인시던트로 중복 제거됩니다. 미국과 EU PagerDuty 서비스 리전을 모두 지원합니다.

## 관련 리소스

#### [웹훅](/docs/ko/eleven-api/resources/webhooks)

워크스페이스 웹훅, 재시도 및 자동 비활성화 동작을 구성하세요.

#### [실시간 모니터링](/docs/ko/eleven-agents/guides/realtime-monitoring)

활성 통화 중 실시간 대화를 관찰하고 제어 명령을 전송하세요.

#### [통화 후 웹훅](/docs/ko/eleven-agents/workflows/post-call-webhooks)

통화가 완료된 후 대화 데이터와 분석 결과를 받으세요.

#### [분석](/docs/ko/eleven-agents/dashboard)

대시보드에서 에이전트 성과 지표를 추적하세요.