Connection model
- One installation per workspace. A Profound admin connects the workspace through Slack’s standard OAuth installation flow. Profound acts in Slack as the Profound app, never as the person who installed it.
- Bot permissions only. Profound requests bot scopes. It doesn’t request user scopes, so it can’t read or post as any person in your workspace.
- Each person uses their own Profound access. Profound matches the person messaging it to their Profound account, either because their Slack email matches their Profound account or because they verified their Slack identity with Sign in with Slack. Answers only use data that account can access in Profound.
- Threads run as the person who started them. Anyone who can see a thread with Profound can reply, and Profound answers every reply with the access of the person who started the thread.
- Profound only acts on messages meant for it. In channels where Profound is a member, Slack sends Profound new messages. Profound responds to messages that mention it and to replies in threads it’s part of. It passes other channel messages on only when the connection includes the Automation triggers purpose, to start the automations you set up.
Purposes and features
When you connect Slack, you select one or more purposes in the Choose Slack permissions dialog. Each purpose turns on a set of features, and each feature needs specific Slack permissions.
If Slack doesn’t grant a permission a purpose’s main features need, the connection shows Connected—setup incomplete and those features stay off until you finish setup.
Slack permissions
Profound doesn’t request
im:read, any group direct message scope (mpim:*), or any user scope.
Slack adds new permissions to a workspace’s existing Profound installation instead of replacing them. If your workspace connected Profound before, Slack may still hold permissions granted then. Learn more in Slack’s OAuth installation documentation.
What Profound stores
Profound stores:- the workspace’s bot token, encrypted as described in Token storage
- the connection’s workspace ID, name, and icon, the purposes and features you selected, and the permissions Slack granted
- for each conversation thread, its workspace, channel, and thread IDs, the Profound organization and categories it uses, and the Profound user who started it. These records don’t contain message text
- account links between Slack members and Profound accounts, and each person’s default organization and category
- the messages you send Profound, the files you share with it, and its replies, as Profound conversation history in your organization
- records of the messages Profound posted, used to avoid posting a reply twice. Profound deletes these after 30 days
Token storage
Profound envelope-encrypts the bot token with an AWS Key Management Service (KMS) key reserved for customer data and stores the ciphertext in Amazon DynamoDB. The encryption context binds each record to one Profound organization and provider, so a record can’t be decrypted under another organization’s identity. Profound’s main database holds only a reference to the encrypted record, never the token.Revoking access
Admins revoke the connection in Profound under Settings > Integrations > Slack, from the … action menu on the connected account, by selecting Revoke. When you revoke:- Profound deletes the encrypted token and marks the connection as revoked. The deletion isn’t reversible.
- If no other Profound connection uses the same workspace, Profound calls Slack’s
auth.revoketo revoke the token. - Profound stops responding in the workspace, and Agents and automations that use the connection stop working until you connect again.
Slack workspace admins can also remove the Profound app in Slack. Slack then stops accepting Profound’s token. Revoke the connection in Profound too, so Profound deletes the stored token.
Controls for Slack admins
- Approve or block Profound. Use app approval to decide whether members can install Profound in your workspace.
- Choose where Profound can read. Profound only reads channels it’s a member of. Remove it from a channel in Slack or in Profound’s Slack settings at any time.
- Remove the app. Removing Profound from your workspace ends its access immediately.