PerfCopilot
Get started
HomeDocs
Documentation

Everything you need to write a fair review.

From your first connection to a sealed, delivered review. Set up PerfCopilot, connect your tools, and generate your first cited draft.

Connect Slack

Pulls messages sent, channels active in, help replies given, and thread depth — workspace-wide.

Prerequisites

  • Slack Workspace Owner role (only owners can install workspace apps)
  • A PerfCopilot admin account (the Connect button is only visible to admins)
  • The PerfCopilot bot must be invited to any private channels you want analyzed

1. Generate credentials in Slack

Slack uses OAuth, so there are no API tokens to copy. You'll complete the install from inside PerfCopilot.

  1. Sign in to https://app.perfcopilot.com as an admin.
  2. Open Integrations, find the Slack card, and click Connect.

📖 Official guide: Creating a Slack app (Quickstart) — Slack's own documentation for creating this credential.

  1. Slack's consent screen opens in a popup. Pick the workspace you want to connect.
  2. Approve the requested scopes: users:read, channels:read, channels:history, groups:read, groups:history, im:read. You'll be redirected back to PerfCopilot.

Copy these values; you'll paste them in the next step:

  • No fields — OAuth handles credentials.

2. Paste into PerfCopilot

  1. Open Integrations on your PerfCopilot admin.

  2. Find the Slack card and click Connect (or Manage if already configured).

  3. Paste each value into the matching field:

    | Field in PerfCopilot | Value from step 1 | |---|---| | (none) | No fields — OAuth handles credentials. |

  4. Click Save.

The Slack credential drawer in PerfCopilot — paste your values, then click Save.
The Slack credential drawer in PerfCopilot — paste your values, then click Save.

3. Verify

Click Test in the drawer. Expected:

✅ Authenticated as your-workspace.slack.com

If you see a red error, jump to Common errors.

Common errors

| Message | What it usually means | Fix | |---|---|---| | Workspace already linked to another org | This Slack workspace is already connected to a different PerfCopilot organization. | Contact support at hello@perfcopilot.com to migrate the workspace. | | HTTP 401: invalid_auth | The OAuth token was revoked from the Slack side. | Re-run the Connect flow to mint a fresh token. | | Bot can't see #general (or any specific channel) | The PerfCopilot bot was never invited to that private channel. | In Slack, run /invite @PerfCopilot from the channel you want analyzed. |

What signals we pull

  • slack — message counts per employee per channel, channel activity, help replies (replies in threads that started with a question), and thread depth.

Need a feature you don't see? Tell us →.

PreviousSalesforceNext Toggl