Skip to content
Leverage AI Developer Support

Slack Connector

Use this page when you need the Slack-side setup details for the Slack connector. For shared connector behavior, start with Connectors Overview and Provider Auth And Setup.

Runtime Shape

Section titled “Runtime Shape”
  • Implemented modes: fixed live
  • Auth binding: Better Auth generic OAuth provider id slack
  • Callback URI examples:
    • http://localhost:3001/api/auth/oauth2/callback/slack
    • https://auth.example.com/api/auth/oauth2/callback/slack
  • Setup console URL:
  • Required connector scopes:
    • users:read
    • users:read.email
    • search:read.public
    • search:read.private
    • search:read.im
    • search:read.mpim
    • search:read.files

Provider-Specific Gotchas

Section titled “Provider-Specific Gotchas”
  • Slack connector auth depends on user scopes. Do not assume a bot-token-only install is enough for this repo.
  • Slack connector auth now includes both RTS search scopes and the matching *:history user scopes so the runtime can make one bounded conversations.replies or conversations.history follow-up call when the top search hit needs more context.
  • Slack is live-only in this repo. There is no Slack indexed sync path, no Slack Meltano tap, and no persisted Slack RTS copy.
  • Connect-time linking probes assistant.search.context before the connector is saved. If the Slack app or workspace is not eligible for RTS, the connect flow fails with connector-slack-live-search-not-eligible.
  • Slack RTS responses can include contextual surrounding messages, and the runtime may add one bounded thread/channel follow-up call for the top grounded message only. Treat all Slack retrieval data as transient runtime grounding only; do not persist it.
  • Enterprise Grid org-ready support is intentionally out of scope for V1. Cross-workspace Slack search would require shared connector-model changes first.
  • Slack does not currently get an explicit provider-side select_account prompt from this repo’s auth config, so the shared connector configure flow must remain the place where already linked Slack accounts are chosen before a connector is saved.

Canonical Sources

Section titled “Canonical Sources”
  • packages/domain/src/connectors/connectorRegistry.ts
  • packages/domain/src/connectors/slackScopes.ts
  • apps/auth/src/genericOAuthProviders.ts
  • apps/api/src/connectors/oauthTokenClient.ts
  • docs/features/connectors/spec.md

Official Docs

Section titled “Official Docs”