Connectors

Slack connector

Where decisions go to be found again.

In short

  • Reads public and private channels of one Slack workspace with a user OAuth token and publishes conversation windows and threads.
  • Modes: sync (workspace and channel membership become readers) and fixed.

Setup

  1. Create an internal Slack app for the workspace and install it for a dedicated service-account user. Use that user's OAuth token (xoxp-…); bot tokens are refused because thread replies need user scopes.
  2. Request exactly these user scopes: channels:read, groups:read, channels:history, groups:history, users:read, users:read.email. No search, files, im, mpim, user-group, admin or write scopes.
  3. The service user must be a member of every private channel to sync.
  4. Put the token in an environment variable and note the workspace ID (T…, the team_id returned by auth.test); both are verified every run.

Configuration

See shared configuration for installation, permission intervals, encryption keys and identity links.

[[sources]]
id = "slack"
type = "slack"
permissions = "sync"                     # or "fixed" with readers = [...]

[sources.settings]
token = { env = "FYRR_SLACK_TOKEN" }
workspace_id = "T0123456789"
window_gap_seconds = 300                 # messages closer than this form one window

[sources.scope]
include = ["platform-*", "C0123456789"]  # channel IDs or name globs, at most 64
exclude = ["platform-private-*"]         # exclude wins
channel_types = ["public_channel", "private_channel"]
bots = false                             # include bot messages
include_shared = false                   # Slack Connect / shared channels; fixed only
KeyMeaning
settings.token, workspace_idThe user token and the workspace it must belong to.
settings.window_gap_seconds1–3600; the gap that splits channel messages into windows.
scope.include, excludeChannel IDs or simple name globs; names are resolved to IDs every run. At most 64 selected channels per source; use several sources for more.
scope.channel_typespublic_channel and/or private_channel. Direct messages are refused in both modes.
scope.botsInclude bot messages (also inside threads).
scope.include_sharedOpt into shared channels; allowed only under fixed.

Documents

Permissions

Permission snapshots are reused within a run; see source revocation timing.

Under sync:

Slack caseReaders on the channel container slack:<workspace>:channel:<id>
Public channelthe synthetic workspace group grp:slack.com:<workspace>:workspace (every active full member) plus guests who are proven channel members
Private channelthe active current members' usr:slack.com:<workspace>:<user id> tokens
Single- or multi-channel guestonly the channels they are members of
Deactivated userno grant; reported inactive
Slack Connect or Enterprise Grid shared channelrefused under sync; opt in under fixed
Direct or group messagerefused in both modes
Botno grant
Unknown identity, incomplete membership pageno grant; the permission pass fails (failure handling)

Membership comes from one complete paged snapshot per channel plus the complete user list; the user list over 16,384 full members fails closed. See corporate identity links for member e-mail handling. Display names are never identities.

Under fixed the configured readers apply; no membership snapshot is read. users.info still resolves author names, so users:read is required in both modes. Shared channels are the operator's responsibility.

Limits

Edit this page on GitHub ↗