Slack

Connecting Slack lets Convictional search your team's Slack conversations while it researches a question, surfacing relevant discussions alongside your other sources. Convictional searches Slack live, on demand, using your own Slack access, so results are always scoped to the channels you can already see.

Features

• Research: When Convictional researches a question, it can search your Slack workspace in real time and use relevant messages to inform its answers.

How it works

There are two parts to setting up Slack:

1. Workspace install — a one-time step performed by a Slack workspace admin.
2. Connecting your account — each person connects their own Slack account.

Convictional searches Slack using each user's individual access. There is no shared bot, no channel selection, and no scheduled indexing — searches run live at the moment you research a question.

Getting Started

1. Install the Convictional app in your workspace (one-time)

Before anyone can connect, the Convictional app must be installed in your Slack workspace. This is a one-time step performed by a Slack workspace admin.

When you open the Slack integration in Convictional and the app has not been installed yet, you will see an Install Convictional on Slack link. Click it (or share it with a workspace admin) to install the app. If the app is already installed, skip ahead to connecting your account.

2. Connect your account

1. Go to your Profile Settings.
2. Find the Slack section and click Connect Slack.
3. You will be taken to Slack to authorize Convictional. Review the requested permissions and approve.
4. You will be redirected back to Convictional automatically. There are no tokens to copy or paste.

Each person on your team connects their own Slack account this way. Convictional searches Slack using your individual access, so it can only see the channels — public or private — that you are already a member of.

Permissions requested

When you connect, Convictional requests read-only access so it can search messages and attribute them to the right people:

• search:read
• channels:read, channels:history
• groups:read, groups:history (private channels you belong to)
• users:read, users:read.email
• team:read

Convictional does not request permission to post messages or otherwise write to your workspace.

Disconnecting

To disconnect, return to the Slack section of your Profile Settings and click Disconnect.

Visibility Note

Slack messages that Convictional surfaces during research can be included in research that is shared with your organization. As a result, content from your Slack conversations may become visible to other members of your organization through shared research.

Need Help?

If you encounter any issues during setup, reach out to our support team and we'll be happy to help.