OverviewPlatformsAPI Reference

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.

# 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 that any rule can use.

Errors

CodeStatusWhen
slack_not_configured503Slack isn't available
slack_not_connected404No Slack workspace is connected, or its access was removed. POST /v1/channels returns 409 instead.
upstream_unavailable502Slack didn't respond while listing channels
Was this page helpful?

On this page