Skip to content

Slack Integration Guide

Overview

Integrating Slack with UptimeObserver allows you to receive real-time alerts and status updates directly within Slack channels. This ensures you can quickly respond to downtime, latency issues, and other incidents affecting your website or services.

Note

Slack integration requires a paid plan.

Prerequisites

Before setting up this integration, you'll need:

  1. A Slack workspace where you can install apps
  2. Permission to add apps to your Slack workspace

Step-by-Step Connection

  1. Go to UptimeObserver and log in to your account.
  2. Navigate to the Integrations section from your dashboard.
  3. Choose Slack from the list of available integrations.
  4. Click on "Add Slack Configuration"
  5. You will be redirected to Slack. Select your Workspace, choose the channel where you'd like to receive notifications, and then click "Allow." Slack Authorization
  6. Once you authorize UptimeObserver to post to your channel, you will be redirected to the Slack integration screen Slack Integration Screen
  7. The Status of your integration should be in status Created. To make sure it is working as expect, you need to run a test by clicking on the test button.
  8. If everything is ok, Status will turn into Active.

Enabling Alerts on Monitors

Follow Add an alert to a monitor. Select Alert Type → Slack and choose the Slack Channel authorized during integration setup. Add separate Monitor Down and Monitor Up rules; they may target the same channel or different channels.

Troubleshooting

If you are having trouble receiving alerts or setting up the integration, check the common solutions below.

1. The "Test" button failed

If you click the test button and the status does not turn Active, check the following:

  • Permissions: Ensure your Slack user has the "Add Apps" permission for that workspace. If you aren't an admin, you may need to request approval from your Slack administrator.
  • Restricted Apps: Some Slack workspaces restrict third-party apps. Check with your IT team to ensure UptimeObserver is on the approved apps list.

2. My Slack channel isn't appearing in the dropdown

If you have authorized UptimeObserver but can't see a specific channel when configuring a monitor:

  • Private Channels: UptimeObserver may not be able to "see" private channels automatically. You often need to manually invite the bot to the channel. Type /invite @UptimeObserver Bot inside the Slack channel and then refresh the UptimeObserver settings page.
  • Re-authorization: If you recently created a new channel, you may need to click "Add Slack Configuration" again to refresh the list of available channels.

3. I'm not receiving notifications during downtime

If the integration is "Active" but you aren't getting alerts:

  • Monitor Assignment: Open Monitor Details → Alerts and verify the Slack rule is active on the correct monitor. See the shared alert guide.
  • Event Triggers: Check if you selected the correct event. For example, if you only selected "Monitor Up," you will not receive a notification when the site goes down.
  • Plan Limits: Check Slack availability and your current subscription. Send support the exact error if a previously working connection stops; do not assume a billing problem pauses the monitor itself.

4. How to Reset the Integration

If all else fails, a "fresh start" often helps:

  1. Go to the Integrations page in UptimeObserver and delete the Slack configuration.
  2. Go to your Slack Workspace -> Settings & Administration -> Manage Apps.
  3. Find UptimeObserver and remove it.
  4. Follow the Step-by-Step Connection Guide to reconnect.

How to Uninstall

In UptimeObserver:

  1. Go to UptimeObserver and log in to your account.
  2. Navigate to the Integrations section from your dashboard.
  3. Select Slack from the list.
  4. Click the delete button next to the Slack configuration you want to remove.

In Slack:

  1. Open your Slack workspace.
  2. Go to Settings & Administration → Manage Apps (or visit https://slack.com/apps/manage).
  3. Search for UptimeObserver in your installed apps.
  4. Click on the app and select Remove App.

Note

Removing the integration from UptimeObserver will stop all Slack notifications immediately. Removing the app from Slack as well ensures a clean uninstall.