---
title: "Slack integration"
description: "Get relevant mentions in a Slack channel, with buttons to open, close or mute them."
canonical: https://docs.rumoro.dev/alerts/slack
markdown: https://docs.rumoro.dev/alerts/slack.mdx
---

# Slack integration

Get relevant mentions in a Slack channel, with buttons to open, close or mute them.

Rumoro's Slack app posts new relevant mentions to a channel you choose. You connect it with a normal Slack install, so there are no tokens to copy. Disconnecting removes the app's access.

## Connect from the dashboard

Go to **Settings › Integrations › Slack notifications**.

1. Click **Connect Slack** and approve the install.
2. **Choose a channel** and a minimum relevance. The options are all relevant, 50 and up (the default), 70 and up, or 85 and up. You can also limit platforms and mute authors.
3. **Turn notifications on.**

This creates an instant rule called "Slack notifications" under **Alerts**. Any other rule can send to Slack too. The list shows public channels, which work without an invite. For a private channel, invite **@Rumoro** to it first.

## What you see in Slack

Each mention is one message with

- a header that says what kind of mention it is, such as `🔵 New mention of driftwood`, `💰 Buying signal for driftwood`, `🐞 Bug report about driftwood` or `🔴 Negative mention of driftwood`
- the platform, keyword, sentiment and intents
- the author and the post, quoted up to 600 characters
- the classifier's note on why it matters
- buttons that stay the same after a click
  - **Open on …** opens the post on its platform.
  - **Open in Rumoro** opens the feed, filtered to that person or keyword.
  - **Interacted** marks the post done, replies in the thread with who clicked, and adds a line such as "Interacted by sam via Slack, 2026-10-04" to the note.
  - **Mute …** mutes the author on the rule that sent the message, after you confirm. It only appears when the author has a name and a profile link.

A message stands for the post, however many keywords or rules matched it, so **Interacted** marks every match done. Each click adds its own line, so the team can see that someone already replied.

A digest is one message. It shows the counts against the previous period, the platforms and keywords, up to 5 mentions under "Needs you today" and 5 under "Also worth a look", and a link to the feed.

## Delivery

Only scored mentions at or above the rule's minimum are sent. A mention marked done or ignored first is skipped. Slack rate limits and Slack server errors are retried, up to 5 attempts. Other Slack errors, such as a removed install or a deleted or archived channel, fail right away and show up in the delivery history.

## Connect through the API

The Slack connection endpoints aren't in the API reference. They answer as described under [Outside the reference](/conventions#outside-the-reference).

```bash
# 1. Start the install, then open the returned URL in a browser.
curl -X POST https://api.rumoro.dev/v1/slack/install \
  -H "Authorization: Bearer $RUMORO_API_KEY"
# { "url": "https://slack.com/oauth/v2/authorize?..." }

# 2. After approval, check the connection.
curl https://api.rumoro.dev/v1/slack/status -H "Authorization: Bearer $RUMORO_API_KEY"
# { "configured": true, "connected": true, "teamName": "Driftwood", "notifications": null }

# 3. List the channels and turn notifications on for one.
curl https://api.rumoro.dev/v1/slack/channels -H "Authorization: Bearer $RUMORO_API_KEY"
curl -X PUT https://api.rumoro.dev/v1/slack/notifications \
  -H "Authorization: Bearer $RUMORO_API_KEY" -H "Content-Type: application/json" \
  -d '{ "channelId": "C07NQ4R2TLM", "channelName": "social-mentions", "minRelevance": 60 }'
```

The `PUT` also takes `sources` and `excludeAuthors`. `DELETE /v1/slack/notifications` turns notifications off and leaves Slack connected. `DELETE /v1/slack` disconnects and removes the app's access. Once connected, a Slack channel is a normal [channel](/api/alerts/create-channel) that any rule can use.

## Errors

| Code | Status | When |
| --- | --- | --- |
| `slack_not_configured` | 503 | Slack isn't available |
| `slack_not_connected` | 404 | No Slack workspace is connected, or its access was removed. `POST /v1/channels` returns 409 instead. |
| `upstream_unavailable` | 502 | Slack didn't respond while listing channels |