Skip to main content

Slack Integration

Connect Sophic to your Slack workspace to capture operational knowledge from thread conversations.

Install the bot​

  1. Open Settings > Integrations in your Sophic dashboard
  2. Click Connect Slack
  3. Authorize the Sophic bot in your Slack workspace

The bot requests the following OAuth scopes:

  • app_mentions:read — Receive @sophic mentions
  • channels:history / groups:history — Read thread messages (public and private channels) for capture
  • channels:read / groups:read — Resolve channel metadata
  • chat:write — Post capture confirmations
  • users:read — Resolve message authors

Commands​

Sophic responds to mentions in threads. There are no slash commands — you interact with the bot by mentioning @sophic followed by a command:

CommandDescription
@sophic startBegin an incremental capture session for the current thread. New messages posted after this point will be captured when you stop.
@sophic stopStop the active capture session and ingest all messages posted since @sophic start.
@sophic captureImmediately capture the entire thread in one shot. No need to start/stop.

Incremental capture (start / stop)​

Use this to capture a conversation as it happens:

  1. Mention @sophic start in the thread to begin a session.
  2. Continue your discussion naturally.
  3. Mention @sophic stop when finished to trigger the ingestion.

Sophic saves the messages posted between your start and stop commands, providing a precise record of the specific knowledge shared.

One-shot capture (capture)​

Use this to save a thread that is already complete:

  1. Mention @sophic capture anywhere in the thread.
  2. Sophic immediately ingests all messages in the thread.
  3. To update the captured document after more messages are added, simply mention @sophic capture again.

How it works​

When Sophic receives a mention, it:

  1. Verifies the request signature (HMAC-SHA256, using SLACK_SIGNING_SECRET and the x-slack-signature / x-slack-request-timestamp headers)
  2. Resolves the workspace from the Slack team ID
  3. Fetches thread messages via the Slack API
  4. Sends the thread to Sophic's ingestion pipeline, where a librarian sweep consolidates it into the knowledge base
  5. Posts a confirmation back into the thread

Next steps​