> ## 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

> Connect Slack to Windmill so Windy can DM your team, run 1:1 prep, deliver pulse surveys, collect feedback, and post shoutouts directly inside Slack.

## Benefits of connecting Slack to Windmill

Slack is where most day-to-day work happens — decisions, questions, collaboration, problem-solving.\
Connecting Slack to Windmill allows that context to be remembered and used to support performance conversations without requiring anyone to write summaries or “manage up.”

* Captures work as it happens — not at review time
* Ensures employees get credit for contributions that are usually invisible
* Helps managers remember accomplishments and follow-through across the year
* Reduces time spent preparing for reviews, calibrations, and promotions
* Makes feedback and evaluation more fair, grounded, and accurate

Windmill transforms ongoing Slack collaboration into structured insight for 1:1s, coaching, and performance reviews. In addition, Slack is where your team interacts with Windy, Windmill's AI assistant. Connecting Slack is essential to using Windmill.

## Setup

As part of onboarding, you connect the Windmill Slack app. Slack lists the app as **Windmill**. Its bot appears as **Windy** in messages, direct messages, and channel member lists. This connection is the foundation of Windy communication in Slack.

Connecting Slack does not automatically give Windmill access to channel messages. Add the app to a channel when you want Windmill to use that channel as context.

You can chat with Windy in your direct-message conversation with the Windy app. Windy does not answer messages or mentions in public, private, or Slack Connect channels.

## Slack Enterprise Grid

This section applies only when Windmill is installed on a whole Slack Enterprise Grid organization. On Enterprise Grid, your company has one Slack organization that contains one or more workspaces.

### Check your install

1. Go to **Settings**, select **Integrations**, and then select **Slack**.
2. Select **Open settings**.

If the page shows a **Workspaces with access** section, Windmill is installed on your Slack organization. If the section is not there, this section does not apply to you.

### Why Windy does not send messages

When you install Windmill on your whole Slack organization, Slack does not add the app to any workspace. Windy can message people only in workspaces that have the app. Slack still shows in your Windmill integrations, but nobody gets messages until a Slack Org Owner, Org Admin, or Integrations Admin adds the app to a workspace.

### Who can add a workspace

You need the correct access in both Windmill and Slack:

* **In Windmill:** An Admin, HR Admin, or Integration Manager can open the Slack settings. See [Permissions and access](https://help.gowindmill.com/permissions-and-access.md).
* **In Slack:** A Slack Org Owner, Org Admin, or Integrations Admin adds the Windmill app to a workspace.

> [!NOTE]
>
> If you do not have one of these Slack roles, send the link to someone who does. In Windmill, right-click **Add workspace** and copy the link address. Then send the link to that person.

### Add Windmill to a workspace

**1. Open the Slack settings in Windmill**

Go to **Settings**, select **Integrations**, select **Slack**, and then select **Open settings**.

**2. Select Add workspace**

Under **Workspaces with access**, select **Add workspace**. Slack's admin page opens in a new tab.

**3. Add the workspace in Slack**

Choose the workspace that your team uses, and then follow Slack's prompts to add the app.

**4. Refresh the Windmill page**

The workspace now shows under **Workspaces with access**.

**5. Send the message again if it does not arrive**

After you add the workspace, check for the message. If it does not arrive, send the test pulse or message again.

To add another workspace later, select **Add more workspaces** under **Workspaces with access**. Then follow the same steps in Slack.

### Add Windmill from Slack

A Slack Org Owner, Org Admin, or Integrations Admin can also add the app from Slack:

**1. Open Organization Settings**

In Slack, select your workspace name, and then select **Organization Settings**.

**2. Open Installed apps**

In the left sidebar, select **Integrations**, and then select **Installed apps**.

**3. Select Add to more workspaces**

Select the three dots next to **Windmill**, and then select **Add to more workspaces**.

**4. Choose the workspaces**

Choose the workspaces that your team uses, and then select **Next**.

**5. Review the permissions**

Review the permissions, and then select **Next**.

**6. Add the app**

Select **I'm ready to add this app**, and then select **Add App**.

For more information, see Slack's guide to [organization-ready apps](https://docs.slack.dev/enterprise/organization-ready-apps).

## Add channels as context

We recommend automatic access to public channels. This option gives Windmill more context without channel-by-channel setup.

**1. Open Settings**

Go to **Settings** in the Windmill Dashboard.

**2. Open the Slack integration**

Select **Integrations**, and then select **Slack**.

**3. Open the Slack settings**

Select **Open settings** for the Slack integration.

**4. Enable public-channel autojoin**

Select **Autojoin public channels**, and then select **Save settings**.

The app does not rejoin a channel after someone removes it from that channel. Slack Connect channels require the separate **Include Slack Connect channels** setting.

For manual public-channel and private-channel setup, see [Add Slack channels as context](https://help.gowindmill.com/windy/adding-windy-to-channels.md).

## Channel join behavior

When you add the app to a Slack channel, it does not send a notification to channel members.

Slack adds a message to the channel history that says Windy joined the channel. This message does not cause a notification, mention, or alert.

After the app joins a channel, Windmill can sync messages and Slack canvases from that channel and use them as context. The synced data includes messages in threads and outside of threads, Slack canvases, users, and channels. Windmill does not currently store reactions as synced channel data.

![Example of Windy join message in Slack channel](https://mintcdn.com/windmill/xHy0I-AuH_zidpIE/images/windy-join-message.png?fit=max\&auto=format\&n=xHy0I-AuH_zidpIE\&q=85\&s=ed9d3a709719761629edc2dc46dfaa3d)

> [!NOTE]
>
> Channel membership gives Windmill access to context. It does not enable
> Windy conversations in the channel.

## Message access and privacy

Windmill mirrors Slack's permissions. **You can only see messages in Windmill that you can already see in Slack.**

* **Public channels:** If Windy is in a public channel, anyone on your team who can see that channel in Slack can see its messages in Windmill.
* **Private channels:** Even when Windy is added to a private channel, **only the human members of that private channel can see its raw messages in Windmill**. Adding Windy never exposes private channel content to people outside the channel — including managers, admins, or anyone else who isn't a member.
* **DMs and group DMs:** You can chat with Windy in your own Slack DM. Windy is not added to DMs or group DMs between other people, so that DM content is never read or stored.

> [!WARNING]
>
> Adding Windy to a private channel does **not** make that channel's messages visible to people who aren't already members. Private stays private. Windmill enforces the same membership rules Slack does.

For workspace-wide engagement signals that don't involve message content, see [Slack Business Analytics](https://help.gowindmill.com/integrations/slack-analytics.md) — it pulls aggregate activity counts only (never message content, channel names, or DM participants).

## Slack shortcuts

Slack shortcuts let you quickly send information to Windmill without leaving Slack. You can create shoutouts, add private notes, and add items to your 1:1 agendas—all directly from Slack.

### Available shortcuts

| Shortcut | What it does |
| - | - |
| **Create a shoutout** | Publicly recognize a teammate for their work |
| **Create a private note** | Save a personal note about an employee (only visible to you) |
| **Add to 1:1 agenda** | Add a discussion topic to an upcoming 1:1 meeting |

### How to use shortcuts

There are three ways to access Slack shortcuts:

#### From a message (recommended)

This is the fastest way to capture context from a conversation.

**1. Right-click on any Slack message**

Hover over the message and click the three dots (**...**) menu, or right-click the message directly.

**2. Select a shortcut**

Choose **Create a shoutout**, **Create a private note**, or **Add to 1:1 agenda** from the menu.

**3. Review and submit**

A modal opens with the message text pre-filled. Edit the content if needed, select the relevant employees, and submit.

> [!TIP]
>
> When you use a shortcut from a message, Windmill automatically pre-fills the content and suggests relevant employees based on the conversation.

#### From the global search bar

Use the global search bar when you want to create something from scratch.

**1. Open the global search bar**

Press **Cmd+K** (Mac) or **Ctrl+K** (Windows) to open Slack's global search bar.

**2. Search for a shortcut**

Type "shoutout", "private note", or "1:1 agenda" to find the shortcut you need, then select it.

**3. Fill out the form**

Enter your content and select the relevant employees.

#### Using slash commands

Type these commands directly in Slack:

| Command | What it does |
| - | - |
| `/shoutout` | Create a shoutout |
| `/private-note` | Create a private note |
| `/1-1-agenda` | Add an item to a 1:1 agenda |

You can also include your message directly after the command. For example: `/shoutout Shoutout to Mark for leading the product launch!`

### Create a shoutout

Shoutouts let you publicly recognize teammates for their contributions. When you create a shoutout from Slack, it's saved in Windmill and visible to others.

> [!NOTE]
>
> An Admin or HR Admin must enable shoutouts for your company and configure a shoutouts channel in Slack before you can use this shortcut. See [Shoutouts](https://help.gowindmill.com/features/shoutouts.md) for setup instructions.

**1. Trigger the shortcut**

Right-click a message and select **Create a shoutout**, or use the `/shoutout` command.

**2. Write your shoutout**

Add or edit the recognition message. Be specific about what the person did well.

**3. Select employees**

Choose the teammates you want to recognize. You can select multiple people.

**4. Click Send**

Your shoutout is saved and shared in Windmill.

### Create a private note

Private notes are personal records about employees—only you can see them. They're useful for tracking observations, feedback, or context you want to remember for reviews or 1:1s.

**1. Trigger the shortcut**

Right-click a message and select **Create a private note**, or use the `/private-note` command.

**2. Write your note**

The message content is pre-filled as a quote. Add any additional context.

**3. Select employees**

Choose who this note is about. You can select multiple employees, including yourself.

**4. Click Save**

Your note is saved privately in Windmill.

> [!NOTE]
>
> Private notes are only visible to you. The employees you tag won't be notified or see the note.

### Add to 1:1 agenda

Capture discussion topics as they come up and add them directly to your upcoming 1:1 meetings.

**1. Trigger the shortcut**

Right-click a message and select **Add to 1:1 agenda**, or use the `/1-1-agenda` command.

**2. Write the agenda item**

Edit or add context to the topic you want to discuss.

**3. Select employees**

Choose which 1:1 partners should receive this agenda item. Only employees with upcoming 1:1 meetings with you will appear.

**4. Click Add**

The item is added to your 1:1 agenda page with a link back to the original Slack message.

> [!NOTE]
>
> You can only add agenda items for employees you have a scheduled 1:1 with. If someone doesn't appear in the list, check that you have an upcoming 1:1 meeting with them.

### Enabling shortcuts

Slack shortcuts require additional permissions. If you don't see the shortcuts in your Slack workspace, an admin needs to re-authenticate the Slack integration.

**1. Go to Settings > Integrations**

Navigate to the [Integrations page](https://app.gowindmill.com/COMPANY/config/integrations) in Windmill.

**2. Find the Slack integration**

Click on **Slack** in the list of integrations.

**3. Re-authenticate**

Click **Re-authenticate** to grant the additional permissions needed for shortcuts.

## Permissions

You need the ability to connect Slack to third-party applications and install Slack apps.

## Slack OAuth scopes

When you install Windy, Slack will ask you to approve a set of OAuth scopes. The table below lists every scope Windy requests and why it's required.

| Scope | Why Windy needs it |
| - | - |
| `app_mentions:read` | Respond when a user pings `@Windy` in a DM. |
| `canvases:read` | Sync Slack canvases from channels where Windy has been added. |
| `channels:history` | Build context from public channels — the core of 1:1s, coaching, and reviews. |
| `channels:join` | Add Windy to public channels via autojoin or the Windmill Dashboard. |
| `channels:manage` | Power the "Leave channel" action in the Windmill Dashboard. Windy never renames, archives, or modifies channels. |
| `channels:read` | Resolve channel references and let admins pick channels in the UI. |
| `chat:write` | Send direct messages and configured feature posts. This scope does not let Windy answer channel messages or mentions. |
| `chat:write.public` | Deliver ephemeral messages and pulse notifications reliably, even when Windy isn't in the channel. Windy never posts unless pulse notifications are enabled. |
| `commands` | Run the `/shoutout`, `/private-note`, and `/1-1-agenda` slash commands. See [Slack shortcuts](#slack-shortcuts). |
| `files:read` | Include shared files as context alongside messages. |
| `files:write` | Upload files Windy generates, such as shortcut attachments. |
| `groups:history` | Build context from private channels Windy is invited to. Content stays visible only to that channel's human members. |
| `groups:read` | Resolve private-channel references and metadata. |
| `groups:write` | Manage settings on private channels Windy created. |
| `im:history` | Follow up on its own DM conversations. Windy is never added to DMs between other users. |
| `links:read` / `links:write` | Show rich previews when Windmill links are pasted into Slack. |
| `lists:read` | Use Slack Lists referenced in channels as context. |
| `reactions:read` | Read reaction metadata if needed for Slack interactions. Windmill does not currently store reactions as synced channel data. |
| `reactions:write` | Add reactions to messages. |
| `team:read` | Display the connected workspace in Windmill's integrations UI. |
| `users.profile:read` | Match Slack users to Windmill employees and display profile data. |
| `users:read` | Map Slack users to Windmill employees. |
| `users:read.email` | Link a Slack account to a Windmill employee record by email. |
| `usergroups:read` | Resolve `@usergroup` mentions in messages. |

## FAQs

> [accordion] Does Windy notify everyone when added to a channel?
>
> **No, Windy does not send notifications when added to a channel.**
>
> When you add Windy to a Slack channel, channel members will NOT receive any notifications, pings, or alerts.
>
> A message will appear in the channel that says "Windy has joined this channel", but this is just a visible message in the channel history — it doesn't trigger any notifications to channel members. People will only see this message if they're actively viewing the channel.

> [accordion] How do I remove Windy from a channel?
>
> In Slack, type `/remove @Windy` in the channel you want to remove Windy from.
>
> Admins can also remove Windy through the Windmill Dashboard:
>
> 1. Go to **Settings > Integrations > Slack**
> 2. Click **Open settings**
> 3. Find the channel in **Slack Channels with Access**
> 4. Click the **Leave** icon in the channel's row

> [accordion] Can my manager (or anyone else) see messages from a private channel they're not in?
>
> **No.** Windmill mirrors Slack's permissions exactly. Raw messages from a private channel are **never** visible to anyone who isn't a member of that channel — even if Windy has been added to it.
>
> Adding Windy to a private channel does not change who can see the content. If you can't read the channel in Slack, you can't read it in Windmill.
>
> The only Slack data Windmill exposes outside of channel membership is **aggregate activity counts** from [Slack Business Analytics](https://help.gowindmill.com/integrations/slack-analytics.md), such as "Alex sent 42 messages on Monday." Slack Business Analytics never exposes message content, channel names, or DM participants.

> [accordion] What's the difference between Slack and Slack Business Analytics?
>
> **Slack Business Analytics** is only for Slack Business+ and Enterprise Grid plans. This integration provides additional stats about your company's Slack usage but doesn't give Windmill access to messages or channels.
>
> **Slack** (the standard integration) works with any Slack plan. This integration doesn't give Windmill access to messages until you add Windy to specific channels.

> [accordion] What types of Slack data do you store once Windy is added?
>
> Windmill stores the following data:
>
> * Messages (both in threads and outside of threads)
> * Slack canvases in channels where Windy has been added
> * Users
> * Channels
>
> Windmill only has access to channels where Windy has been added. Slack canvases follow the same channel membership rules as messages. We don't currently store reactions as synced channel data. Slack scopes may permit additional content in the future, but Windmill only syncs the data listed above today.

> [accordion] Where can I chat with Windy in Slack?
>
> Open your direct-message conversation with the Windy app. Add the Windmill Slack app to public or private channels only when you want Windmill to read channel context.

> [accordion] Can Windy respond to me in a Slack channel?
>
> No. In Slack, Windy only responds in your direct-message conversation with the Windy app. Windy does not respond to messages or `@Windy` mentions in public, private, or Slack Connect channels. Adding the Windmill Slack app to a channel gives Windmill access to permitted channel content as context. It does not create a Windy conversation in that channel.

> [accordion] Why do I see two Windy entries in a Slack Connect channel?
>
> A Slack Connect channel can contain a Windy app from each organization. The circle-avatar Windy belongs to your workspace. The square-avatar Windy belongs to the external organization.
>
> Do not use either channel mention to start a Windy chat. Windy does not respond in Slack Connect channels. Open a direct message with your workspace's Windy to start a conversation.

> [accordion] Windy isn't sending Slack messages after I connected Slack
>
> If Windmill is installed on your whole Slack Enterprise Grid organization, the app might not be in any workspace yet. A Slack Org Owner, Org Admin, or Integrations Admin can add it to a workspace. See [Add Windmill to a workspace](#add-windmill-to-a-workspace).

> [accordion] The Slack settings page says No workspaces. What do I do?
>
> The app is not in any workspace yet. Select **Add workspace** and add the workspace that your team uses. If you are not a Slack Org Owner, Org Admin, or Integrations Admin, send the link to someone who has one of these roles.

> [accordion] Do I need to resend messages after I add a workspace?
>
> Only for messages that did not arrive. Slack blocked those messages because Windmill did not have access to your workspace yet. After you add the workspace, send any missing test pulse or message again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.