> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/configure/notification-channels.md).

# 알림 채널

**알림 채널**은 **7개의 통합 채널**을 통해 알림을 전달합니다 — [Telegram](#telegram), [이메일](#e-mail), [Lark](#lark), [Webhook](#webhook), [Slack](#slack), [Discord](#discord), [PagerDuty](#pagerduty).

각 채널은 다음 두 가지 유형의 알림을 독립적으로 구독할 수 있습니다.

* **Risk Engine** — 매핑한 Risk Engine 규칙에 의해 트리거되는 알림입니다.
* **Monitor Events** — 모니터링하는 주소에서 감지된 위험 변경 사항입니다. 구성 방법은 [모니터](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/monitoring/monitor.md#setting-up-notifications)를 참조하세요.

<figure><img src="https://738662694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmQV7l2sGQOENPKPFUI8o%2Fuploads%2Fgit-blob-6d7fae62e4694ef5b599e4502323bdb275966102%2Fnotification-channel-monitor-events.png?alt=media" alt="Notification channel detail page with Monitor Events enabled"><figcaption></figcaption></figure>

## Telegram <a href="#telegram" id="telegram"></a>

**Telegram 알림 채널**은 **사용자 채팅**, **그룹 채팅**, **채널**의 세 가지 알림 전달 모드를 제공합니다.

* **사용자 채팅 모드**: 봇에 알림을 직접 전송합니다.
* **그룹/채널 모드**: 봇이 사전 구성된 Telegram 그룹 또는 채널에 알림 메시지를 전송합니다.

각 모드의 구성 단계는 아래에 자세히 설명되어 있습니다.

### **Telegram 사용자 채팅 모드**

* **1단계**: Telegram에서 **@PhalconComplianceBot** (<https://t.me/PhalconComplianceBot>)을 검색하고 봇과의 채팅을 엽니다.
* **2단계**: 봇과의 채팅에서 `/getchatid` 명령어를 전송해 "사용자 ID"를 확인합니다.
* **3단계**: Phalcon에서 Telegram 알림 채널을 만들고 채팅 유형으로 "사용자"를 선택합니다.
* **4단계**: 지정된 필드에 "사용자 ID"를 붙여 넣어 채널 생성을 완료합니다.

이 채널과 연결된 Risk Engine이 트리거되면 봇이 아래 예시와 같이 구조화된 알림 메시지를 이 채팅으로 자동 전송합니다.

### **Telegram 그룹 채팅 모드**

* **1단계**: 알림을 받을 Telegram 그룹에 @PhalconComplianceBot을 추가합니다.
* **2단계**: 그룹 채팅에서 `/getchatid` 명령어를 전송해 "그룹 채팅 ID"를 확인합니다.
* **3단계**: Phalcon에서 Telegram 알림 채널을 만들고 채팅 유형으로 "그룹"을 선택합니다.
* **4단계**: 지정된 필드에 "그룹 ID"를 붙여 넣어 채널 생성을 완료합니다.

### **Telegram 채널 모드**

* **1단계**: Telegram 채널의 관리자로 @PhalconComplianceBot을 추가합니다.
* **2단계**: 채널 채팅에서 `/getchannelid` 명령어를 전송해 "채널 ID"를 확인합니다.
* **3단계**: Phalcon에서 Telegram 알림 채널을 만들고 채팅 유형으로 "채널"을 선택합니다.
* **4단계**: 지정된 필드에 "채널 ID"를 붙여 넣어 채널 생성을 완료합니다.

## 이메일

* **1단계**: 이메일 알림 채널을 만들고 알림을 받을 이메일 주소를 입력합니다.
* **2단계**: 인증 코드를 입력해 생성을 완료합니다.

이 이메일 알림 채널과 연결된 Risk Engine이 트리거되면 사전 구성된 이메일 주소로 아래 예시와 같은 구조화된 알림 메시지가 전송됩니다.

<br>

## Lark <a href="#lark" id="lark"></a>

* **1단계**: Lark 그룹에 봇을 추가합니다.
* **2단계**: 유형으로 "Custom Bot"을 선택하고 봇을 구성합니다.
* **3단계**: Phalcon에서 Lark 알림을 만듭니다.
* **4단계**: Webhook URL과 서명 키를 입력합니다.

> Lark 봇 생성에 관한 자세한 내용은 다음을 참조하세요: <https://open.larksuite.com/document/client-docs/bot-v3/bot-overview>

이 Lark 알림 채널과 연결된 Risk Engine이 트리거되면 아래 예시와 같이 Lark 그룹에 알림 메시지가 표시됩니다.

<br>

## Webhook <a href="#webhook" id="webhook"></a>

**Webhook 채널**을 사용하면 Phalcon 알림 메시지를 자체 서버 또는 애플리케이션에서 직접 받을 수 있습니다. Phalcon과 시스템 사이에 안전한 크로스체인 bridge를 만드는 것으로 생각하면 됩니다. 모니터링이 트리거될 때마다 Phalcon은 이 크로스체인 bridge를 통해 서버로 알림을 자동 전송합니다.

* **1단계**: Phalcon에서 Webhook 채널을 만듭니다.
* **2단계**: Webhook 서버 URL을 입력합니다.

> 서버에서 기본 인증을 사용하는 경우 필요한 자격 증명을 입력하세요.

Webhook 메시지 형식 및 기술 사양에 대한 자세한 내용은 다음 문서를 참조하세요.

[Webhook 형식](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/configure/notification-channels/webhook-format.md)[<br>](https://docs.google.com/document/d/1vewc32T-jTVEaqz-W4fHtZFAf88uF4vzdJM8pWkYTVA/edit?tab=t.0#heading=h.ntu9zql97jl5)

## Slack

* **1단계**: Phalcon에서 Slack 알림 채널을 만듭니다.
* **2단계**: `Connect Slack` 버튼을 클릭해 인증 페이지로 이동합니다.
* **3단계**: 알림을 받을 채널을 구성하고 권한을 부여합니다.

이 Slack 채널과 연결된 Risk Engine이 트리거되면 아래 예시와 같이 Slack에서 알림 메시지를 받습니다.

## Discord

* **1단계**: 알림을 받을 Discord 채널에서 `Edit Channel`을 클릭합니다.
* **2단계**: `Integrations` 페이지에서 Webhook을 만듭니다.
* **3단계**: Phalcon에서 Discord 채널을 만듭니다.
* **4단계**: Webhook URL을 붙여 넣어 채널 생성을 완료합니다.

> Discord Webhook 생성에 관한 자세한 내용은 다음을 참조하세요: <https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks>

이 Discord 채널과 연결된 Risk Engine이 트리거되면 아래 예시와 같이 채널에서 알림 메시지를 받습니다.

## PagerDuty

PagerDuty 알림 채널을 구성하는 방법은 두 가지입니다: **토큰** 또는 **이메일 인증**.

**토큰 인증**

* **1단계**: PagerDuty 계정에 `Events API V2` 통합을 추가합니다.
* **2단계**: Phalcon에서 PagerDuty 채널을 만들고 "토큰" 모드를 선택합니다.
* **3단계**: `Integration Key`를 붙여 넣어 구성을 완료합니다.

<br>

**이메일 인증**

* **1단계**: PagerDuty 계정에 `Email` 통합을 추가합니다.
* **2단계**: Phalcon에서 PagerDuty 채널을 만들고 "이메일" 모드를 선택합니다.
* **3단계**: `Integration Email` 주소를 입력하고 이메일 인증 절차를 완료합니다.
