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 requires the following OAuth scopes:

  • app_mentions:read — Receive @sophic mentions
  • channels:history — Read thread messages for capture
  • chat:write — Post capture confirmations
  • reactions:write — Add status reactions to messages

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)
  2. Resolves the workspace from the Slack team ID
  3. Fetches thread messages via the Slack API
  4. Runs the messages through the ingestion pipeline to create or update documents
  5. Posts a confirmation with the document count

Next steps​