Skip to content
Keel Docs

Chat notifications

Keel can post to a Slack or Microsoft Teams channel when something happens in your workspace. The default is a monitored check changing status, for example a GitHub check failing because someone switched off branch protection. You set this up on the Notifications tab under Integrations.

Only an owner or admin can add or remove a channel.

Adding a channel

Section titled “Adding a channel”
  1. Create an incoming webhook in the chat app (see below) and copy its URL.
  2. On the Notifications tab, open Add a channel.
  3. Under App, choose Slack or Microsoft Teams.
  4. Paste the URL into Incoming webhook URL.
  5. Give the channel a Name you will recognize later, such as #security-alerts.
  6. Under Send, pick what to post (see below), then click Add channel.

Keel stores the webhook URL encrypted and never shows it again. The channel list shows its name, the app, the webhook’s host and the event it receives. To change a channel, remove it and add it again.

Which URL to use

Section titled “Which URL to use”
  • Slack: an incoming webhook URL on hooks.slack.com.
  • Microsoft Teams: a Workflows URL from the “post to a channel when a webhook request is received” template. Older incoming-webhook URLs on webhook.office.com are still accepted while Microsoft keeps them working.

Keel refuses any other URL, so a channel can only ever post to Slack or Microsoft.

What gets posted

Section titled “What gets posted”

The Send menu offers:

  • Monitored check changes status: posts when an evidence connection check changes status, for example from passing to failing. The message names the source, the check, and its old and new status.
  • Every event: everything Keel emits.
  • One named event, such as task.created, risk.updated or policy.approved. These are the same events the webhook API offers.

Each message carries an Open in Keel link to the relevant page. In Teams it arrives as an Adaptive Card.

Next steps

Section titled “Next steps”