> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 알림 채널

> 알림과 이벤트가 가는 곳 — Slack, 이메일, 웹훅, PagerDuty.

알림이 Nora 이벤트 (승인, 알림, 배포, 인시던트) 를 팀이 이미 관찰하는 시스템으로 라우팅. 여기서 목적지 설정; [알림](/ko/settings/notifications/alerts) 에서 룰 배선.

## 지원 채널

| 채널            | 최적 용도                             |
| ------------- | --------------------------------- |
| **이메일**       | 개인 알림, 저볼륨 알림.                    |
| **Slack**     | 팀 대상, 고가시성, 인터랙티브 (승인의 Slack 버튼). |
| **Discord**   | Discord 기반 팀에 Slack 과 같음.         |
| **PagerDuty** | 인시던트의 온콜 에스컬레이션.                  |
| **웹훅**        | 다른 것 — 커스텀 라우팅, 내부 앱, SIEM.       |

## 채널 추가

**Settings → Notifications → Channels → New**:

1. 채널 타입 선택.
2. 인증 (Slack/Discord/PagerDuty 는 OAuth; 웹훅은 API 키 / URL).
3. 타겟 설정 — Slack 채널, 이메일 주소, 웹훅 URL.
4. 의미 있는 이름 지정 ("#nora-alerts", "eng-oncall@").
5. 테스트 — Nora 가 프로브 메시지 전송.

저장되면 채널이 어느 알림 룰에든 배선할 수 있는 재사용 타겟.

## Slack 셋업

1. **Settings → Notifications → Channels → New → Slack**.
2. Nora Slack 앱 승인.
3. 채널 선택.
4. 저장.

양방향: 승인 라우팅에 배선된 Slack 채널 ([알림](/ko/settings/notifications/alerts) 참고) 이 인터랙티브 Approve / Reject 버튼 얻음. 버튼 클릭이 액션 사용자 Slack ID 로 승인 엔드포인트 히트; Nora 가 결정 기록.

Slack 앱 권한 없는 워크스페이스는 **incoming webhook** 채널 사용 — 단방향이지만 관리자 승인 불필요.

## Discord 셋업

Slack 과 비슷. Discord 웹훅 사용 (OAuth 플로우 없음).

## PagerDuty 셋업

1. PagerDuty 에서 서비스와 통합 (Events API v2) 생성.
2. 통합 키 복사.
3. **Nora → Settings → Notifications → Channels → New → PagerDuty** → 키 붙여넣기.

Nora 가 구조화 이벤트 전송; PagerDuty 가 온콜로 라우팅.

권장: 실제 인시던트 (롤백 트리거, 지속 에러율) 에만 PagerDuty 사용. 나머지는 Slack.

## 웹훅 셋업

일반 HTTP POST. 설정:

* **URL** — 여러분 엔드포인트.
* **Auth** — none / bearer / 커스텀 헤더 / HMAC.
* **페이로드 포맷** — JSON (Nora 모양), 커스텀 템플릿, 또는 CI 기대 모양.

페이로드 포함:

```json theme={null}
{
  "event": "flows.publish",
  "workspace_id": "acme",
  "actor": {"kind": "user", "id": "u_alice"},
  "target": {"flow": "support-agent", "version": 42},
  "details": {"summary": "..."},
  "timestamp": "2026-07-31T09:12:34Z"
}
```

`X-Nora-Signature` 헤더에 HMAC-SHA256 으로 서명.

## 이메일 셋업

개별 이메일 주소 또는 그룹 이메일 추가:

* 개별 — 개인 알림용 (내 Flow 에 대해 알고 싶음).
* 그룹 — 팀 알림용 (`eng-oncall@company.com`).

고볼륨 알림에는 이메일보다 Slack 선호 — 신호 대 잡음이 훨씬 나음.

## 채널 테스트

모든 채널이 **Send test** 버튼 가짐. Nora 가 "hello, this is Nora testing this channel" 페이로드 발화해 엔드투엔드 배선 확인 가능.

## 자격증명 로테이션

**Settings → Notifications → Channels → 채널 클릭 → Rotate credentials**:

* Slack / Discord — OAuth 부여 재인증.
* PagerDuty — 새 통합 키 붙여넣기.
* 웹훅 — 새 서명 시크릿 붙여넣기. 이전 것이 60분 수용.

## 채널 삭제

여전히 활성 알림 룰이 타겟팅하면 실패. 먼저 룰 업데이트.

삭제 감사됨.

## 흔한 채널 패턴

* **`#nora-approvals`** — 모든 승인 요청이 Slack 버튼과 함께 여기 착지.
* **`#nora-alerts`** — 롤백, 고심각도 시그널, 비용 초과.
* **`#nora-deploys`** — 모든 배포 (정보용; 낮은 긴급).
* **PagerDuty `nora-oncall`** — 자동 롤백과 canary 실패만. 사람 깨움.
* **`eng-oncall@`** — 야간 인시던트의 일일 다이제스트.

## Flow 별 채널

Flow 많은 워크스페이스는 하나의 거대한 `#nora-*` 채널 피하고 Flow 별 채널 배선:

* `#support-agent-alerts` — support Flow 특화 알림.
* `#billing-agent-approvals` — billing Flow 만의 승인.

알림 룰에서 설정 ([알림](/ko/settings/notifications/alerts) 참고).

## 관련

* [알림](/ko/settings/notifications/alerts) — 알림 발화하는 룰.
* [승인·배포](/ko/reliable/optimization/approve) — 채널로 라우팅된 승인.
* [감사](/ko/settings/security/audit) — 감사 포워딩이 같은 채널 인프라 사용.