Set Up the openstatus Slack Agent

What you'll learn

In this tutorial, you'll learn how to install the openstatus Slack agent so you can manage incidents directly from your Slack workspace — no need to switch to the dashboard.

Prerequisites

• An openstatus account (openstatus.dev)
• A Slack workspace where you have permission to install apps

What you'll get

By the end of this tutorial, you'll have:

• The openstatus Slack agent installed in your workspace
• The ability to create, update, and resolve incidents from Slack

Install the Slack Agent

1. Go to Settings

Navigate to Settings > Integrations in your openstatus dashboard.

2. Install the Slack Integration

Click the Install Slack button. You'll be redirected to Slack's authorization page where you can select the workspace and channel you want to connect.

Grant the requested permissions and click Allow to complete the installation.

3. Verify the Installation

After completing the OAuth flow, go to the Slack channel you selected and type:

@openstatus what's the status of my monitors?

The bot should respond with a summary of your monitors. If you see a response, the installation is working.

4. Start Managing Incidents from Slack

Here are some examples of what you can do:

Create an incident

Notify your subscribers about a new issue.

@openstatus create an incident for the payment API – high latency detected.

Update an incident

Keep your status page updated while you investigate.

@openstatus keep the status page updated that we are still monitoring the issue.

Resolve an incident

Close an active incident and let your subscribers know.

@openstatus resolve the ongoing incident on my API status page.

Schedule maintenance

Plan downtime so subscribers are informed in advance.

@openstatus schedule a maintenance window for my database next Friday from 2–3 PM.

What you've accomplished

Congratulations! You've successfully:

• ✅ Installed the openstatus Slack agent in your workspace
• ✅ Connected your openstatus account to Slack
• ✅ Learned how to manage incidents directly from Slack

Troubleshooting

The bot doesn't respond when mentioned

1. Check the channel: Make sure you're mentioning @openstatus in the channel you selected during installation.
2. Check permissions: Go to Settings > Integrations and verify the Slack integration shows as connected.
3. Reinstall: If the integration appears disconnected, click Install Slack again to re-authorize.

"Not authorized" or permission errors

Your Slack workspace admin may need to approve the app. Ask your workspace admin to go to Slack Admin > Manage Apps and approve the openstatus integration.

Bot responds but can't find monitors

Make sure you have at least one monitor and one status page created in your openstatus workspace before using incident commands.

AI responses may be inaccurate

The openstatus Slack agent uses AI to interpret your messages and take actions on your behalf. Responses and actions may occasionally be incorrect, incomplete, or unexpected. Always review the bot's output — especially before publishing incident updates, resolving incidents, or scheduling maintenance — and confirm the change in your openstatus dashboard.

What's next?

• Create a Status Page — share your service status publicly with users
• Create a Monitor — set up uptime monitoring for your endpoints