Octri

Slack

Post project events and monitoring alerts to a Slack channel, through an incoming webhook.

You need an incoming webhook URL for the channel, from a Slack app in your workspace. It looks like https://hooks.slack.com/services/.... One URL can serve project events and alerts both.

Project events

Send spec uploads, docs publishes, SDK builds and the project's other events to Slack.

  1. Open the webhooks

    Open Integrations in the project sidebar, choose Slack under Notifications and paging, then Add a webhook (Manage webhooks once the project has one).

  2. Add a Slack webhook

    Press New webhook, choose Slack, and paste the incoming webhook URL.

  3. Pick the events

    Forward only what you need, or use Select all. Then press Send test to check a message arrives.

Each message is one line with the project's name in bold and what happened. For every event and the delivery log, see webhooks.

Monitoring alerts

Send error spikes, new issues and regressions from your API's monitoring to Slack.

  1. Open the alert rules

    Open Monitoring, then the Alerts tab, and create a rule or edit one. The Slack card on the Integrations page links there too, and lists the rules already using it.

  2. Choose Slack as the channel

    Pick Slack and paste the incoming webhook URL, which must be on hooks.slack.com. The message names the rule and its kind, and for a threshold, the value against its limit. Alert channel addresses must be public https:// URLs: Octri refuses a private or internal address.

Each rule has one channel. To reach several places, make a rule for each. See alerts for the rule kinds, windows and cooldowns.