Connectors

Slack

Slack is the highest-signal source most teams have: decisions get made in threads and never make it into a document.

Connect

In Connectors, pick Slack → Connect and approve. Flipper asks for exactly three read-only scopes: channels:history, channels:read, users:read — enough to read public channels and map user ids to names. It cannot read DMs or private channels, and it never posts.

Real-time instead of every five minutes

Flipper can subscribe to Slack's Events API so a message becomes a fact in under a minute, with polling still there as fallback. On the hosted instance this is already on.

bash

# self-hosting: point Slack's Request URL at your API
https://api.yourdomain.com/webhooks/slack

# required env before Slack will verify the URL
SLACK_SIGNING_SECRET=...
SLACK_WEBHOOKS_ENABLED=1

Self-hosting your own Slack app

The hosted instance ships a Slack app; a self-hosted Flipper needs its own. Create one, add the three scopes above, set the redirect URL to <your-api>/api/connectors/slack/callback, and set SLACK_CLIENT_ID, SLACK_CLIENT_SECRET and SLACK_REDIRECT_URI — Slack compares the redirect character for character.