> For the complete documentation index, see [llms.txt](https://docs.metacopier.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metacopier.io/features/basic-features/notifications.md).

# Notifications

On the **Notifications** page of a project you create **notification rules**. A rule decides **which events** are sent to **which channels**. The channels themselves (Telegram, Slack, Microsoft Teams, Discord, Webhook) are connected on the [Channels](https://docs.metacopier.io/features/basic-features/notification-channels.md) page.

You can create several rules, for example "Errors of all accounts to Slack" and "Trades of my prop accounts to my Telegram". A project can have up to **50 rules**.

## Creating a rule

Click **Add rule** and fill in the following settings.

### What should be sent?

* **Name:** For example "Errors to Slack".
* **Minimum level:** Messages below this level are ignored.
  * **Errors only** (ERROR)
  * **Warnings and errors** (WARN)
  * **Everything** (INFO), for example also trade open and close events
* **Categories:** Select one or more categories (see below).
* **Only specific events (optional):** Inside a category you can narrow the rule down to single events, for example only **Position closed**. Leave everything unchecked to receive all events of the selected categories.
* **Only specific tools (optional):** Restrict the rule to events of certain tools, for example one specific [News filter](https://docs.metacopier.io/features/pro-features/news-filter.md) or a risk limit. Leave empty for all tools.

{% hint style="info" %}
Events of the **News** category are always sent, regardless of the minimum level. You subscribe to them by selecting the category.
{% endhint %}

### Categories

<table><thead><tr><th width="210">Category</th><th>Contains</th></tr></thead><tbody><tr><td><strong>Trading</strong></td><td>Positions opened, closed or modified (SL/TP), trade history updated, trade approvals, unmanaged positions</td></tr><tr><td><strong>Skipped copies</strong></td><td>Trades that were intentionally not copied (filters, limits)</td></tr><tr><td><strong>Execution errors</strong></td><td>Rejected orders, insufficient margin, failed copies, duplicate positions</td></tr><tr><td><strong>Account &#x26; connection</strong></td><td>Account started or stopped, connected or disconnected, login failed, access token expiring, account restricted, fallback mode</td></tr><tr><td><strong>Risk</strong></td><td>Risk limits, profit targets, loss-protected exits, guardrails, copier stopped by risk management, limit resets, balance adjustments</td></tr><tr><td><strong>News</strong></td><td>Economic calendar reminders, News filter and News protection warnings and actions, daily agenda, high-impact market news</td></tr><tr><td><strong>Signals</strong></td><td>Signals received, executed or rejected, AI signal limit reached, signal subscription ended</td></tr><tr><td><strong>System</strong></td><td>Configuration errors and changes, maintenance windows, proxy issues, Expert Advisor messages, rate-limited log messages, disabled notification channels</td></tr><tr><td><strong>Other</strong></td><td>Messages without a specific category</td></tr></tbody></table>

### Accounts

* **All accounts:** Events of every account of the project, now and in the future.
* **Only these accounts:** Events of other accounts are ignored.
* **All accounts except:** Events of the selected accounts are ignored.

With **Only these accounts** or **All accounts except** you can additionally enable **Also send project events (not tied to an account)**, for example economic calendar reminders or a disabled channel. With **All accounts**, project events are always included.

* **Account alias:** Messages show the alias you gave the account instead of its login number.

### Send to

Select one or more channels that receive the matching messages. For Telegram you can choose **all recipients** or individual recipients. At least one target is required.

### Delivery options

* **Digest:** Collect messages for a while (10 to 3600 seconds, default 60) and send them as one summary. With **Send errors immediately**, errors bypass the digest.
* **Quiet hours:** Hold messages back during a time window, for example at night. You choose the start and end time, the time zone and the days (no day selected = every day).
  * **Still send errors during quiet hours:** Errors are delivered anyway.
  * **When quiet hours end:** **Send a summary** of what was held back, or **Discard held messages**.
* **Cooldown:** Send the same event for the same account at most once within this time (1 to 1440 minutes, default 15). Useful for events that repeat often, such as connection losses.

## Try it

Before saving you can check a rule:

* **Preview:** Shows how many events of the past (default 24 hours, at most 7 days) would have matched the rule and about how many messages each channel would have received. This is an estimate, because not every past event can be reconstructed from the logs.
* **Send test:** Sends a sample message to all targets of the rule.

## Rules overview

The list shows per rule the level, the categories, the accounts, the targets and the delivery options. You can enable or disable, edit, duplicate or delete a rule. The [delivery history](https://docs.metacopier.io/features/basic-features/notification-channels.md#health-and-delivery-history) of a rule shows what was sent in the last 7 days.

## Tools with their own targets

Some tools send messages on their own, for example the [News filter](https://docs.metacopier.io/features/pro-features/news-filter.md), [News protection](https://docs.metacopier.io/features/pro-features/news-protection.md) and the [Economic calendar](https://docs.metacopier.io/features/economic-calendar.md) reminders. They have a **Notification targets** setting:

* **Via notification rules (default):** The messages are delivered by every notification rule that covers the category (for example **News**). If no enabled rule covers it, the messages are not sent anywhere. The tool shows a hint with a link to create a rule.
* **Send directly to selected channels:** The messages go only to the selected channels, notification rules are not applied.

## Migration of existing Telegram notifications

Telegram notifications created before the introduction of channels and rules were migrated automatically:

* All Telegram usernames of a project became **recipients** of the project's Telegram channel.
* Every former Telegram notification became a **notification rule** with the same log level, account filter and alias setting, sending to that recipient. These rules are marked **Migrated from Telegram**.

You do not have to do anything. You can now edit these rules, for example to add categories or additional channels. The **Telegram** menu item of a project now only contains the [Telegram signal provider](https://docs.metacopier.io/tutorials/telegram-signal-integration.md). See also [Telegram](https://docs.metacopier.io/features/basic-features/telegram.md).
