> 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/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 Engines** — Alerts triggered by your mapped Risk Engines.
* **Monitor Events** — Risk changes detected on your monitored addresses. See [Monitor](/manual/monitor.md#setting-up-notifications) for configuration details.

<figure><img src="/files/Tj5ma1wvVQXGo6JhGA2m" alt="Notification channel detail page with Monitor Events enabled"><figcaption></figcaption></figure>

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

The **Telegram Notification Channel** offers three alert delivery modes: **User Chat**, **Group Chat**, and **Channel**.

* **User Chat Mode**: Alerts will be sent directly to the bot.
* **Group/Channel Mode**: The bot pushes alert messages to a pre-configured Telegram group or channel.

The configuration steps for each mode are detailed below.

### **Telegram User Chat Mode**

* **Step 1**: Search for **@BlockSecPhalcon\_bot** (<https://t.me/BlockSecPhalcon_bot>) in Telegram and open a chat with this bot.
* **Step 2**: Send the `/getchatid` command in the chat with the bot to receive 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 specified field to complete the channel creation.

When a risk engine associated with this channel is triggered, the bot will automatically send a structured alert message to this chat (as shown in the example below).

### **Telegram Group Chat Mode**

* **Step 1**: Add @BlockSecPhalcon\_bot to the Telegram group where you want to receive alerts.
* **Step 2**: Send the `/getchatid` command in the group chat to get 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 specified field to complete the channel creation.

### **Telegram Channel Mode**

* **Step 1**: Add @BlockSecPhalcon\_bot as an administrator to your Telegram channel.
* **Step 2**: Send the `/getchannelid` command in the channel chat to get 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 specified field to complete the channel creation.

## E-mail

* **Step 1**: Create an e-mail type notification channel and enter the email address where you wish to receive alerts.
* **Step 2**: Fill in the verification code to complete the creation.

When a risk engine associated with this e-mail notification channel is triggered, the pre-configured email address will receive 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 set up the bot.
* **Step 3**: Create a Lark notification in Phalcon.
* **Step 4**: Enter the Webhook URL and Secret Signature.

> For more information on creating a Lark bot, please refer to: <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 will appear 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's alert messages directly in your own servers or applications. It can be thought of as creating a secure bridge between Phalcon and your system—whenever your monitors are triggered, Phalcon automatically sends these alerts to your server via this bridge.

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

> If your server uses Basic Authentication, please provide the necessary credentials.

For detailed Webhook message formats and technical specifications, please refer to the following document:

[Webhook Format](/manual/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 allow authorization.

When a risk engine associated with this Slack channel is triggered, you will receive an alert message in your 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 the channel creation.

> For more information on creating a Discord Webhook, please refer to: <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 will receive an alert message as shown in the example below.

## PagerDuty

There are two ways to set up the notification channel for PagerDuty: **Token** or **E-mail Authentication**.

**Token Authentication**

* **Step 1**: Add an `Events API V2` integration in 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 in 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 email verification process.
