Notifications

This page configures how your organization receives alerts from QMonitor. Use these settings to deliver operational notifications to the right channels and reduce noise by choosing appropriate delivery methods per severity.

From the Notification settings page you can enable one or more channels and test each configuration before saving.

Supported notification channels

QMonitor currently supports the following notification channels:

• Email
• Microsoft Teams
• Telegram
• Slack

Each channel can be enabled independently and tested using the Test button available next to the configuration fields.

Email notifications

1. Enable Email
2. Enter one or more email addresses (use commas to separate multiple recipients)
3. Click Test to verify delivery
4. Save the configuration

Microsoft Teams notifications

QMonitor sends notifications to Microsoft Teams using an Incoming Webhook URL. Messages are delivered to a specific channel as Adaptive Cards and may include text and images (graphs associated with issues).

How to enable

1. In Microsoft Teams, open the target Team and Channel
2. Click More options next to the channel name
3. Select Workflows
4. Create a new Incoming Webhook
5. Copy the generated Webhook URL
6. Paste it into QMonitor → Teams webhook url
7. Click Test to verify delivery
8. Save the configuration

If you do not have access to the Workflows section contact your Teams administrator

Telegram notifications

Telegram notifications are sent by a Telegram bot to a channel.

Step-by-step setup

1. Create the bot

1. Open Telegram and search for @BotFather
2. Send:

   /newbot
   

3. Choose a name and a username

BotFather will return a Bot Token like:

123456:ABC-defGHI...

This value goes into Bot token in QMonitor.

2. Create a Telegram channel

1. Telegram → New Channel
2. Choose a name
3. Set it as Private (recommended)
4. Create the channel

3. Add the bot as administrator

1. Open the channel → Info → Administrators
2. Add your bot (e.g. @thenameyouchooseearlier)
3. (Mandatory) Grant at least “Can post messages” permission

4. Retrieve the Channel Chat ID

1. Send any message in the channel
2. Open in a browser:

   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
   

3. Look for the chat section in the JSON response:

"chat": {
  "id": -1003314549127,
  "title": "ChannelName",
  "type": "channel"
}

The Chat ID is the negative number (e.g. -1003314549127).

Final parameters to enter in QMonitor

• Bot token → Telegram bot token
• Chat ID → Channel chat ID

After saving, use Test to confirm delivery.

Slack notifications

Slack notifications support:

• Text messages via Incoming Webhooks
• Images (optional) via Slack Bot API

1. Create a Slack App

1. Go to https://api.slack.com/apps
2. Click Create New App → From scratch
3. Choose a name (e.g. QMonitor)
4. Select the workspace

2. Enable Incoming Webhooks (required)

1. Features → Incoming Webhooks
2. Activate Incoming Webhooks → ON
3. Add New Webhook to Workspace
4. Select the target channel
5. Copy the Webhook URL

This value goes into Slack Incoming Webhook URL.

3. Enable image upload (optional)

Required only if you want to also see the notification’s associated images (graphs contained in issues).

Add the following bot scopes in OAuth & Permissions:

• chat:write
• files:write
• channels:read
• groups:read (only for private channels)

After adding scopes, reinstall the app.

4. Retrieve Bot Token

Copy the Bot User OAuth Token (xoxb-…).

This value goes into Slack Bot token.

5. Retrieve Channel ID

Open Slack in the browser and navigate to the channel.

URL example:

https://app.slack.com/client/TXXXXXXX/CYYYYYYY

Use CYYYYYYY (public) or GYYYYYYY (private).

This value goes into Slack Channel ID.

6. Invite the bot to the channel

Inside the Slack channel, run:

/invite @QMonitor

Without this step, image uploads will not be visible.

Final parameters to enter in QMonitor

• Webhook URL → required
• Bot token → required only for images
• Channel ID → required only for images

Use Test to confirm correct delivery.