Skip to main content

​
Notification Integrations Setup Guide

Matia allows you to send real-time notifications to external systems so your team can stay in the loop when important events occur. You can configure multiple notification channels and control where notifications are delivered across Matia. Currently supported notification integrations:
  • Slack
  • Webhook
  • Microsoft Teams (via Webhook)
  • PagerDuty

​
Supported Notification Channels

Once configured, these channels can be selected as recipients throughout Matia (alerts, monitors, failures, system events, and more). Each channel is set up as a named connection that acts as a reusable destination.

​
Slack Notifications

Slack is connected using a secure one-click OAuth flow.

​
How to Connect Slack

  1. Navigate to Settings → Notifications → Add Notificaiton Integration
  2. Click Connect with Slack
  3. Authorize Matia in your Slack workspace
  4. Select the channel you’d like Matia to post into
Once connected, the Slack channel will be available as a notification recipient throughout Matia.

​
Webhook Notifications

Webhooks allow you to send notifications to any external system that supports incoming HTTP requests. You can configure multiple webhook channels.

​
How to Add a Webhook Channel

  1. Navigate to Settings → Notifications → Add Notificaiton Integration
  2. Click Add Webhook
  3. Fill in the following fields:
    • Connection Name
      This is the name that will appear as the recipient channel throughout Matia (for example: Data Team Webhook or Prod Alerts)
    • Webhook URL
      The destination endpoint where Matia will send notification events
  4. Click Connect
Once saved, the webhook will be available as a destination throughout Matia.

​
Microsoft Teams Notifications (via Webhook)

Matia supports Microsoft Teams notifications via incoming webhooks using the Microsoft Workflows app. You can send Matia alerts (for issues, schema changes, monitor breaches, and more) directly into a Teams channel. The high-level flow:
  1. Create a webhook for a Teams channel using Workflows
  2. Add that webhook to Matia
  3. Route notifications to that channel

​
Prerequisites

Before you start, make sure the Workflows app is available in your Microsoft 365 tenant, as this provides the webhook template used by Microsoft Teams.

​
Part 1 – Create a Webhook in Microsoft Teams

  1. Open Microsoft Teams (desktop or web).
  2. In the left sidebar, select the Team and Channel where you want Matia alerts to appear.
  3. Next to the channel name, click the ⋯ (More options) menu.
  4. From the menu, choose Workflows (or Apps → Workflows, depending on your UI).
  5. In the Workflows window, search for “webhook”.
  6. Select the template:
    Post to a channel when a webhook request is received
  7. Click Next.
  8. Confirm that the Team and Channel values match the destination for Matia alerts.
  9. Click Add workflow.
  10. When Microsoft Teams displays the generated Webhook URL, click Copy, then click Done.
You now have a webhook URL that Matia can use to post alerts to this channel.

​
Part 2 – Add Microsoft Teams as a Destination in Matia

  1. Log in to Matia.
  2. Navigate to Settings → Notifications → Add Notificaiton Integration
  3. Click Add Notification Integration.
  4. Choose Add Webhook.
  5. Fill in the details:
    • Connection Name
      Choose a name that clearly identifies the Teams channel.
    • Webhook URL
      Paste the Teams webhook URL you copied earlier.
  6. Click Connect.
Matia can now send notifications to your Microsoft Teams channel.

​
Part 3 – Route Matia Alerts to Microsoft Teams

Once configured, your new Teams webhook channel will appear in:
  • Monitor configurations
  • Integration alert settings
  • Notification rules created from the Notifications page
Select this channel wherever you configure alert routing, and Matia will post matching events directly into your Teams channel.

​
PagerDuty Notifications

PagerDuty notifications allow Matia to trigger incidents directly in your PagerDuty account. Matia uses PagerDuty Events API V2.

​
How to Connect PagerDuty

  1. Navigate to Settings → Notifications → Add Notificaiton Integration
  2. Click Add PagerDuty
  3. Enter the following:
    • Connection Name
      This is the name that will appear as the recipient channel throughout Matia
    • Integration Key
      This key comes from your PagerDuty service (see instructions below)
  4. Click Validate
After validation, Matia sends a test event to PagerDuty to confirm the connection.

​
How to Obtain a PagerDuty Integration Key

To generate the Integration Key required by Matia:
  1. In PagerDuty, navigate to the Services tab and create a new Service for Matia.
  2. Provide a descriptive name for the service (for example: Matia Notifications).
  3. Choose the Escalation Policy you’d like to use for Matia notifications and follow the rest of PagerDuty’s setup steps.
  4. When you reach the Integrations step, select Events API V2 and click Create Service.
  5. On the new Service page, under the Integrations section, you’ll see an Integration Key listed on the left side. Copy this key — you’ll need it to complete the setup in Matia.
PagerDuty Integration Key