> ## Documentation Index
> Fetch the complete documentation index at: https://help.gowindmill.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Business Analytics

> Pull workspace-wide Slack activity stats into Windmill to understand collaboration patterns, channel engagement, and team communication health across the org.

Slack Business Analytics gives Windmill a daily, per-person view of how your team is collaborating in Slack — even in channels Windy hasn't been added to. This is the most complete picture of Slack activity Windmill can see, and it's the foundation for collaboration insights, calibration signals, and engagement trends across the whole company.

## Why connect Slack Business Analytics

The standard [Slack integration](/integrations/slack) only sees channels where Windy has been added. Slack Business Analytics closes that gap by pulling workspace-wide activity counts directly from Slack's admin API.

* **See activity across every channel** — including private channels and DMs Windy will never join
* **Ground reviews and calibrations in real data** — surface quiet contributors and spot collaboration patterns
* **Track engagement trends over time** — daily counts per person, not one-time snapshots
* **No message content is accessed** — only aggregate counts

<Note>
  Slack Business Analytics only pulls **aggregate activity counts**. Windmill never sees message content, channel names, or who you're talking to through this integration.
</Note>

## Install Slack Business Analytics

<Callout icon="shield-check" iconType="regular">
  **Required to install:**

  * A Slack **Business+** or **Enterprise Grid** plan (Slack's Admin Analytics API isn't available on lower tiers)
  * A **Slack Workspace Owner or Admin** account (needed to grant the `admin.analytics:read` scope)
  * Windmill admin access to connect integrations
</Callout>

<Steps>
  <Step title="Open the Slack Business Analytics integration page">
    Go directly to the [Slack Business Analytics integration page](https://app.gowindmill.com/COMPANY/config/integrations/sources/slack-analytics/account) in Windmill.
  </Step>

  <Step title="Click Connect">
    Click **Connect** to start the authorization flow.
  </Step>

  <Step title="Authorize in Slack">
    You'll be redirected to Slack to approve the connection. Sign in as a Workspace Owner or Admin and click **Allow**.
  </Step>

  <Step title="Confirm the connection">
    Once approved, you'll return to Windmill. Stats begin syncing within 24 hours (Slack publishes analytics on a \~24-hour delay).
  </Step>
</Steps>

## What stats get pulled in

Windmill pulls **per-person, daily activity counts** from Slack's Admin Analytics API. Each metric is attributed to an individual Slack member and refreshed daily.

| Stat                      | What it counts                                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Messages sent**         | Total messages a person posted that day across every channel and DM (public, private, group DM, 1:1 DM) |
| **Channel messages sent** | Messages posted in channels only — excludes DMs and group DMs                                           |
| **Files added**           | Files a person uploaded or shared that day                                                              |
| **Reactions added**       | Emoji reactions a person added to other people's messages that day                                      |
| **Slack calls**           | 1:1 and group Slack calls a person participated in that day                                             |
| **Slack huddles**         | Huddles a person joined that day                                                                        |
| **Total calls**           | Slack calls + huddles combined                                                                          |
| **Total activity**        | Sum of messages, files, reactions, calls, and huddles — a single engagement score                       |

<Info>
  Slack publishes analytics with a \~24-hour lag, so "today's" stats appear tomorrow. This is a Slack API limitation, not a Windmill one.
</Info>

## FAQs

<AccordionGroup>
  <Accordion title="What's the difference between Slack and Slack Business Analytics?">
    These are two separate integrations that do different things. Most companies connect both.

    **Slack** (the standard integration)

    * Works on any Slack plan
    * Installs Windy, Windmill's AI assistant, into your workspace
    * Only sees messages in channels where Windy has been explicitly added
    * Powers shoutouts, private notes, 1:1 agenda shortcuts, and Windy conversations
    * Uses message content (in opted-in channels) for performance context

    **Slack Business Analytics** (this integration)

    * Requires Slack Business+ or Enterprise Grid
    * Pulls workspace-wide daily activity counts from Slack's admin API
    * Never reads message content or channel names — only aggregate numbers
    * Covers every channel and DM, including ones Windy isn't in
    * Powers engagement stats, trends, and collaboration signals

    Think of Slack as "deep context in the channels you choose" and Slack Business Analytics as "broad numbers across the whole workspace."
  </Accordion>

  <Accordion title="Does this give Windmill access to my team's messages?">
    No. Slack Business Analytics only returns aggregate counts (e.g., "Alex sent 42 messages on Monday"). Windmill never sees message content, channel names, DM participants, or file contents through this integration.
  </Accordion>

  <Accordion title="Why do I need to be a Slack Workspace Admin to install?">
    Slack's `admin.analytics:read` scope — which powers this integration — can only be granted by a Workspace Owner or Admin. This is enforced by Slack, not Windmill.
  </Accordion>

  <Accordion title="Why don't I see today's stats?">
    Slack publishes analytics with a \~24-hour delay, so the most recent day of data will always be missing until Slack releases it. Backfills catch up automatically once data becomes available.
  </Accordion>

  <Accordion title="Do I still need the regular Slack integration?">
    Yes. Slack Business Analytics doesn't replace the standard Slack integration — it adds to it. Windy (the AI assistant, shoutouts, 1:1 shortcuts) only works through the [standard Slack integration](/integrations/slack).
  </Accordion>

  <Accordion title="How do I disconnect Slack Business Analytics?">
    Go to the [Slack Business Analytics integration page](https://app.gowindmill.com/COMPANY/config/integrations/sources/slack-analytics/account) and click **Disconnect**. Historical stats already pulled into Windmill are retained; no new data will be pulled going forward.
  </Accordion>
</AccordionGroup>