All docs

Integrations

Integration: Slack

Send Rank Sonar alerts to a Slack channel via OAuth.

Available on Pro and above. Connect a Slack workspace to receive alert dispatches as posts in any channel.

What gets posted

Each alert that has Slack in its dispatch channels arrives as a Slack message with:

  • Alert type and severity (icon-coded)
  • Affected app and storefront
  • The change (e.g., "rank dropped from #5 to #18 for 'meal planner' (US)")
  • A link back to the Rank Sonar app for context

For high-volume alert rules, messages are auto-bundled if more than 10 events fire within an hour.

Step-by-step

1. Install the Rank Sonar Slack app

  1. In Rank Sonar, go to Integrations → Slack
  2. Click Connect Slack workspace
  3. You'll be redirected to Slack's OAuth flow
  4. Choose the workspace and the channel for posts
  5. Approve the permissions (we request incoming-webhook scope only — no message reading, no DM access, no member listing)
  6. You'll be redirected back to Rank Sonar with the integration active

2. Route alerts to Slack

  1. Visit Alerts → Rules
  2. Edit any alert rule (or create a new one)
  3. Add Slack to the rule's channels
  4. Save

The next event matching the rule will post to your selected channel.

3. Multi-channel posting (Studio+)

Studio and Agency tiers can install the Slack app multiple times to post different alert types to different channels. Common pattern:

  • #ranksonar-critical → critical-severity events only
  • #ranksonar-changes → metadata and screenshot changes
  • #ranksonar-digest → weekly digest only

Configure per-channel routing in Alerts → Preferences.

What permissions we request

We request only the minimum necessary scope:

  • incoming-webhook — permission to post messages to a single channel you select

We do NOT request:

  • Reading message history
  • Sending DMs to users
  • Listing workspace members
  • Modifying channels or permissions

You can verify by inspecting the OAuth permissions screen during install.

Disconnecting

Integrations → Slack → Disconnect removes the webhook URL from your workspace. You may also want to remove the app from your Slack workspace at Apps → Manage → Installed apps.

Customizing the post format

The default post format is opinionated. To customize, use the Webhooks integration instead — register your own endpoint and format the message however you like before posting to Slack.

See also