Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clarityq.ai/llms.txt

Use this file to discover all available pages before exploring further.

Connecting Slack lets ClarityQ post task results, scheduled reports, and answers into your team’s Slack workspace, and lets your team ask questions of ClarityQ without leaving Slack. The connection is at the workspace level — one ClarityQ organization links to one Slack workspace, and every product in that organization can use it.

​
Prerequisites

  • A Slack workspace where you have permission to install apps.
  • Admin rights in your ClarityQ organization.

​
Installing the App

1

Open Organization Settings → Integrations

Navigate to Organization Settings → Integrations in ClarityQ.
2

Click Add ClarityQ to Slack

The Add ClarityQ to Slack button kicks off the OAuth flow and redirects you to Slack.
3

Approve the requested scopes

Review the permissions ClarityQ requests — posting messages, reading channel and member lists, uploading files, responding to mentions, and handling slash commands — and click Allow.
4

Return to ClarityQ

Slack redirects you back to ClarityQ once the install is complete. The Integrations page now shows Connected to your workspace name.

​
Choosing Channels

ClarityQ can post to:
  • Public channels in your Slack workspace, automatically.
  • Private channels, but only after you invite the ClarityQ bot to that channel with /invite @ClarityQ.
The channel picker appears when you create or edit a task. It lists every channel the bot can see — public, plus any private channels it’s been invited to.

​
Disconnecting and Reconnecting

Two actions are available on the Integrations page once Slack is connected:
  • Disconnect removes ClarityQ’s access to your Slack workspace. After confirmation, the bot stops posting and pending task deliveries fail. Existing tasks keep their channel selections but won’t deliver until Slack is reconnected.
  • Reconnect re-runs the OAuth flow with the latest permission set. Use this when:
    • Slack reports a permissions error
    • ClarityQ tells you the integration needs to be reauthorized (for example, when ClarityQ adds new scopes in a release)
    • You want to enable new capabilities — for example, if you originally connected Slack only for task deliveries and now want to ask ClarityQ questions directly in Slack, reconnecting grants the additional permissions needed
Slack connections are per organization, not per user. Once an admin connects Slack, every product in your organization can deliver to that Slack workspace. If a user’s Slack email matches their ClarityQ login email, they’re recognized automatically. Otherwise, they’ll need to run /clarityq connect once — see Using ClarityQ in Slack.