Skip to main content

Slack

Oppex can post a service's incident updates to one or more Slack channels, so the whole team can follow an incident without opening Oppex. Setting this up takes two steps: an administrator connects your Slack workspace to Oppex once, and then you choose channels and events for each service.

Slack posts go to channels, not to individual people, and they are sent in addition to the contact methods on the escalation policy.

Step 1: Connect your Slack workspace​

Permissions

Only an Account Owner or Account Admin can see the Integrations page and connect Slack.

  1. Open Settings and, under Organization, click Integrations.
  2. In Slack Workspaces, click Connect Slack Workspace.
  3. Slack opens in your browser. Choose your Slack workspace if asked, review the permissions, and click Allow.
  4. Slack returns you to the Integrations page, where the workspace is now listed.

The Integrations page under Settings → Organization, with the Connect Slack Workspace button and no Slack workspaces connected yet

No confirmation message appears

When the connection works, the Slack workspace appears in the list, with the date it was connected and who connected it. If it fails, your browser shows a page that starts with "OAuth failed:", followed by the reason.

You do not need to map channels on the Integrations page to receive notifications. The Channels list and Configure Channel there are for creating Oppex incidents from messages that other bots post in Slack.

Step 2: Choose a channel for your service​

  1. Open Services and click the service, for example Telemetry Gateway. The Edit Service dialog opens.
  2. Under Notifications, select the Slack tab.
  3. In Add Slack Channel, search for the channel, select it, and click Add. The channel is saved as soon as you add it.
  4. Under Notification Events, select the events to post: Triggered, Assigned, Acknowledged, Service Change, Severity Change or Resolved.
  5. Click Save Events.

The Notifications section of the Edit Service dialog with the Slack tab selected, before a Slack workspace is connected

The figure shows the Slack tab before a Slack workspace is connected. Until you complete step 1, the tab shows "Connect Slack in Settings → Integrations to enable channel notifications." in place of the channel picker.

A new channel posts only the Assigned event

Oppex selects Assigned for each channel you add. Select any other events you want, then click Save Events. If you clear every event, Oppex shows "Slack is configured but no events are selected. No notifications will be sent."

Private channels

The channel list shows public channels, and private channels only after you add the Oppex app to them in Slack.

When you add a channel while creating a new service, you can pick one channel, and Oppex saves it when you click Create Service. Add more channels by editing the service afterwards.

What a post looks like​

Each post shows the event, the incident title, the service, the severity and the time in UTC. Later updates for the same incident are posted in the same thread.

# race-control
OX
Oppex APP · 07:45
👤 Incident Assigned: Box Box: Telemetry Gateway latency above 2s
Service: Telemetry Gateway     Severity: SEV1
Assigned to: Alex Morgan
Time: 27 Sep 2026, 07:45 UTC
View Incident

The View Incident button opens the incident in Oppex. Posts for acknowledged, resolved, transferred and severity-change events also name the person who acted, when Oppex knows who it was.

More than one Slack workspace

If your organization connects more than one Slack workspace, Oppex sends service posts through the workspace it connected first. Posts to a channel in a different Slack workspace may not arrive.

For what each event means once an incident is running, see Slack notifications.

FAQ

Will Oppex send me a direct message in Slack?

No. Oppex posts only to the channels you add to a service. Personal alerts come by phone call, SMS, WhatsApp, email and the mobile app.

Can I acknowledge or resolve an incident from Slack?

No. The post has a View Incident button that opens the incident in Oppex, where you can act on it.

Do I need to map the channel on the Integrations page?

No. Channel mapping on the Integrations page is only for creating incidents from Slack messages. Adding the channel to the service is enough for notifications.

Why doesn't my private channel appear in the list?

Add the Oppex app to the private channel in Slack first. It then appears in the service's channel list.

In this article

FAQ

Will Oppex send me a direct message in Slack?

No. Oppex posts only to the channels you add to a service. Personal alerts come by phone call, SMS, WhatsApp, email and the mobile app.

Can I acknowledge or resolve an incident from Slack?

No. The post has a View Incident button that opens the incident in Oppex, where you can act on it.

Do I need to map the channel on the Integrations page?

No. Channel mapping on the Integrations page is only for creating incidents from Slack messages. Adding the channel to the service is enough for notifications.

Why doesn't my private channel appear in the list?

Add the Oppex app to the private channel in Slack first. It then appears in the service's channel list.