> 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/manual/configure/notification-channels.md).

# Notification Channels

**Notification Channels** deliver alerts through **7 integrated channels** — [Telegram](#telegram), [E-mail](#e-mail), [Lark](#lark), [Webhook](#webhook), [Slack](#slack), [Discord](#discord), and [PagerDuty](#pagerduty).

Each channel can independently subscribe to two types of notifications:

* **Risk Engine** — Alerts triggered by the Risk Engine rules you have mapped.
* **Monitor Events** — Risk changes detected on addresses you monitor. For configuration details, see [Monitor](https://docs.compliance.phalcon.blocksec.com/manual/monitoring/monitor.md#setting-up-notifications).

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%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>

The **Telegram notification channel** provides three alert delivery modes: **user chat**, **group chat**, and **channel**.

* **User chat mode**: Alerts are sent directly to the bot.
* **Group/channel mode**: The bot pushes alert messages to a preconfigured Telegram group or channel.

The configuration steps for each mode are detailed below.

### **Telegram User Chat Mode**

* **Step 1**: Search for **@PhalconComplianceBot** (<https://t.me/PhalconComplianceBot>) in Telegram and open a chat with the bot.
* **Step 2**: Send the `/getchatid` command in the chat with the bot to obtain your "User ID."
* **Step 3**: Create a Telegram notification channel in Phalcon and select the "User" chat type.
* **Step 4**: Paste your "User ID" into the designated field to complete channel creation.

When a Risk Engine associated with this channel is triggered, the bot automatically sends a structured alert message to this chat, as shown in the example below.

### **Telegram Group Chat Mode**

* **Step 1**: Add @PhalconComplianceBot to the Telegram group where you want to receive alerts.
* **Step 2**: Send the `/getchatid` command in the group chat to obtain the "Group Chat ID."
* **Step 3**: Create a Telegram notification channel in Phalcon and select the "Group" chat type.
* **Step 4**: Paste the "Group ID" into the designated field to complete channel creation.

### **Telegram Channel Mode**

* **Step 1**: Add @PhalconComplianceBot as an administrator of the Telegram channel.
* **Step 2**: Send the `/getchannelid` command in the channel chat to obtain the "Channel ID."
* **Step 3**: Create a Telegram notification channel in Phalcon and select the "Channel" chat type.
* **Step 4**: Paste the "Channel ID" into the designated field to complete channel creation.

## E-mail

* **Step 1**: Create an E-mail notification channel and enter the E-mail address where you want to receive alerts.
* **Step 2**: Enter the verification code to complete creation.

When a Risk Engine associated with this E-mail notification channel is triggered, the preconfigured E-mail address receives a structured alert message, as shown in the example below.

<br>

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

* **Step 1**: Add the bot to your Lark group.
* **Step 2**: Select "Custom Bot" as the type and configure the bot.
* **Step 3**: Create a Lark notification in Phalcon.
* **Step 4**: Enter the Webhook URL and signature key.

> For more information about creating a Lark bot, see: <https://open.larksuite.com/document/client-docs/bot-v3/bot-overview>

When a Risk Engine associated with this Lark notification channel is triggered, an alert message appears in your Lark group, as shown in the example below.

<br>

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

The **Webhook channel** allows you to receive Phalcon alert messages directly on your own server or application. Think of it as creating a secure cross-chain bridge between Phalcon and your system — whenever your monitoring is triggered, Phalcon automatically sends these alerts to your server through this cross-chain bridge.

* **Step 1**: Create a Webhook channel in Phalcon.
* **Step 2**: Enter your Webhook server URL.

> If your server uses basic authentication, provide the required credentials.

For detailed Webhook message formats and technical specifications, see the following document:

[Webhook Format](https://docs.compliance.phalcon.blocksec.com/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

* **Step 1**: Create a Slack notification channel in Phalcon.
* **Step 2**: Click the `Connect Slack` button to go to the authentication page.
* **Step 3**: Configure the channel where you want to receive alerts and grant authorization.

When a Risk Engine associated with this Slack channel is triggered, you receive an alert message in Slack, as shown in the example below.

## Discord

* **Step 1**: In the Discord channel where you want to receive alerts, click `Edit Channel`.
* **Step 2**: Create a Webhook on the `Integrations` page.
* **Step 3**: Create a Discord channel in Phalcon.
* **Step 4**: Paste your Webhook URL and complete channel creation.

> For more information about creating a Discord Webhook, see: <https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks>

When a Risk Engine associated with this Discord channel is triggered, the channel receives an alert message, as shown in the example below.

## PagerDuty

There are two ways to configure a PagerDuty notification channel: **Token** or **E-mail authentication**.

**Token Authentication**

* **Step 1**: Add an `Events API V2` integration to your PagerDuty account.
* **Step 2**: Create a PagerDuty channel in Phalcon and select "Token" mode.
* **Step 3**: Paste your `Integration Key` to complete the configuration.

<br>

**E-mail Authentication**

* **Step 1**: Add an `Email` integration to your PagerDuty account.
* **Step 2**: Create a PagerDuty channel in Phalcon and select "Email" mode.
* **Step 3**: Enter the `Integration Email` address and complete the E-mail verification process.
