Getting Started Schedules Alerting Notifications Jobs

Notification Channels

Notification channels define where alert messages are delivered. Go to Settings to manage your channels.

Supported Channels

Type Description
Slack Post to a Slack channel via webhook
Discord Post to a Discord channel via webhook
Email Send via SMTP
Telegram Send via Telegram bot
Teams Post to Microsoft Teams
Generic POST to any HTTP webhook endpoint

Channels use Shoutrrr URL format to encode the connection details.

Channel URL Formats

Slack

slack://TOKEN@CHANNEL

Create an incoming webhook in your Slack workspace and use the token from the webhook URL.

Discord

discord://TOKEN@WEBHOOKID

Create a webhook in your Discord server settings. The URL will contain the WEBHOOKID and TOKEN.

Email (SMTP)

smtp://USER:PASSWORD@HOST:PORT/?from=FROM&to=TO

Example:

smtp://alerts@example.com:password@smtp.example.com:587/?from=alerts@example.com&to=you@example.com

Telegram

telegram://BOT_TOKEN@telegram?chats=CHAT_ID

Create a bot via @BotFather and get the chat ID from your bot's API.

Microsoft Teams

teams://GROUP@TENANT/ALTID/GROUPOWNER?host=ORG.webhook.office.com

Create an incoming webhook connector in your Teams channel.

Generic Webhook

generic+https://webhook.example.com/path

Sends a JSON POST to the given URL.

Adding a Channel

  1. Go to Settings
  2. Click Add Notification Channel
  3. Enter a name and select the channel type
  4. Paste the Shoutrrr URL with your credentials
  5. Click Test to send a test notification and verify it works
  6. Save the channel

Testing a Channel

Use the Test button next to any channel to send a test message. This verifies the URL and credentials without waiting for an alert to fire.

Enabling / Disabling

Each channel has an enable/disable toggle. Disabled channels receive no notifications even when alert rules fire.

How Notifications Are Sent

When an alert rule fires, a notification is sent to all enabled channels. The message includes:

  • The schedule name and alert rule name
  • The metric value that triggered the rule
  • A direct link to acknowledge the alert