11 Slack Connector
Slack in the current customer flow is a personal live connection. Each member connects their own Slack account, and the assistant answers from that member’s own Slack view at request time. Nous does not index Slack content.
11.1 What is indexed or searched live
Slack messages are searched live. Nothing is copied into the workspace search index, Knowledge Search, or document sets. The assistant can search the public channels, private channels, and direct messages that the member can already see in Slack. Each member who needs Slack answers connects their own account from the connector catalog in Settings. A member without a connection gets no Slack results.
11.2 Administrator role and authentication
Sophea manages the Slack OAuth app. The member authorizes the personal connection with their own Slack user token. A Slack workspace owner or administrator may need to approve the app when the workspace requires admin approval for installed apps. The member can only ever read what their own Slack identity can already open in Slack.
The personal connection requests the following Slack user scopes. You do not create a Slack app for the standard customer path.
| Scope | Why Nous requests it |
|---|---|
channels:read, groups:read, im:read, mpim:read |
Resolve the channels and conversations the member belongs to for live search. |
search:read |
Search messages live with the member’s own token. |
channels:history, groups:history, im:history, mpim:history |
Read the message history the member can already open in Slack. |
users:read, users.profile:read |
Resolve member names and profiles for readable results. |
11.3 Provider setup and permissions
Ask a Slack workspace owner or administrator to approve the Sophea app when the workspace requires admin approval for new apps. There is no source scope to pick: a personal connection always follows the connecting member’s own Slack visibility. Channels and direct messages the member cannot see in Slack never appear in answers.
11.4 Setup form fields
The current personal setup has no editable form fields. It shows Connect, Reconnect, and Disconnect actions. The member selects the account in the Slack consent flow. There is no workspace access or refresh setting for this personal connection.
11.5 Workspace and Team access
Workspace and Team access do not apply. The connection belongs to one member. Other members must connect their own Slack accounts. Workspace admins cannot make a personal Slack connection public or add it to a document set.
11.6 Test the connection
- Ask a question whose answer exists in a Slack channel the connected member can read.
- Confirm that the answer cites live Slack messages with openable links.
- Confirm that the messages do not appear in Knowledge Search or a document set.
- Disconnect the member account and confirm that live search no longer returns Slack content.
11.7 Common errors
| Error | Action |
|---|---|
| Slack asks for admin approval | Ask a workspace owner or administrator to approve the app. |
| Channel answers are empty | Confirm that the member can open that channel in Slack, then reconnect. |
| Messages are missing | Slack live search only covers what the member’s own account can read; confirm the member’s access in Slack. |
| Consent changed or expired | Use Reconnect to refresh the grant. |
11.8 Reconnect, rotate, and remove
Use Reconnect after a consent change or an expired grant. To change accounts, disconnect the old account first. Sophea manages the OAuth app. Disconnect revokes the supported grant and removes the local personal connection.