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

# Slack

> Connect Slack for communication insights and automated reports

Connect Slack to enable communication insights, automated reports, and AI-powered assistance in Weave.

## Features

* **Automated reports** - Weekly and daily team summaries delivered to Slack channels
* **Individual reports** - Personalized weekly DMs to each team member
* **PR notifications** - Alerts when significant pull requests are merged
* **Conversation metrics** - Track thread activity and response times across your team
* **AI assistant** - Ask questions about your team's metrics directly in Slack

## What's synced

Weave syncs the following data from your Slack workspace:

| Data | Details |
| - | - |
| **Members** | Names, emails, timezones, profile pictures |
| **Channels** | Private channels the Weave bot is added to, and public channels where the bot or a connected Slack user is a member |
| **Messages** | Message content, threads, and timestamps for insights |

<Note>
  Message content is only used to generate communication insights like response
  times and collaboration patterns. Weave does not store or display individual
  message content.
</Note>

## Metrics enabled

Once connected, Weave tracks conversation patterns in your Slack workspace. See [Slack conversations](/metrics/slack-conversations) for details on:

* **Slack threads** - Number of threads started by team members
* **Slack thread response time** - Median time for team members to respond to threads

These metrics help you understand communication volume, team responsiveness, and collaboration patterns across your channels.

<Note>
  Metrics include threads in private channels the Weave bot has been added to, and in public channels where the Weave bot or a Slack user who connected their account to Weave is a member. Bot-initiated threads and bot responses are excluded.
</Note>

## Connecting Slack

<Steps>
  <Step title="Start connection">
    Go to the **Data** page and click **Connect** on Slack
  </Step>

  <Step title="Authorize Weave">
    Sign in to Slack and authorize the Weave app. You'll be asked to approve both bot and user permissions.
  </Step>

  <Step title="Select workspace">
    Confirm the workspace to connect. You can connect multiple workspaces if needed.
  </Step>

  <Step title="Auto-match accounts">
    Weave automatically links Slack users to Weave accounts by matching email or name
  </Step>
</Steps>

## Slack reports

Weave can send automated reports to Slack. Configure these in **Settings > Notifications**.

| Report type | Description | Delivery |
| - | - | - |
| **Weekly report** | Team summary with insights and individual stats | Channel, weekly |
| **Daily report** | Quick daily activity summary | Channel, weekdays |
| **Individual weekly** | Personalized metrics for each team member | DM, weekly |
| **PR notifications** | Alerts when significant PRs are merged | Channel, on merge |

All reports include customizable metrics — for example, code output, PR volume, review turnaround, **output per engineer**, **stale PRs**, and **[output waiting for review](/metrics/output-waiting-for-review)**. Channel reports let you choose the destination channel and schedule. Individual reports are sent in each user's timezone.

For PR notifications, you can set a code output threshold—only PRs exceeding this value trigger a notification.

## AI assistant

Mention the Weave bot in any channel or send it a DM to ask questions about your team's metrics.

**Example questions:**

* "What was our team's code output last week?"
* "Who had the most PR reviews this sprint?"
* "Show me the trend for cycle time"

<Note>The AI assistant requires Team Lead role or higher to use.</Note>

## Permissions

Weave requests the following Slack permissions:

### Bot permissions

| Permission | Purpose |
| - | - |
| `channels:read` | List public channels for report configuration |
| `channels:history` | Read messages in public channels |
| `groups:read` | List private channels the bot is added to |
| `groups:history` | Read messages in private channels |
| `chat:write` | Send reports and notifications |
| `users:read` | Sync workspace members |
| `users:read.email` | Match Slack users to Weave accounts |

### User permissions

| Permission | Purpose |
| - | - |
| `channels:read` | List channels you have access to |
| `channels:history` | Read messages in channels you're a member of |

## Troubleshooting

### Reports not sending

1. Verify the Slack connection is active on the **Data** page
2. Check the report is configured with a valid channel
3. Ensure the Weave bot is added to the target channel

### Missing channels

Private channels only appear if the Weave bot has been added to them. Invite the bot by mentioning `@Weave` in the channel.

### Users not matching

Weave matches Slack users to accounts by email. If a user isn't linked:

1. Ensure their Slack email matches their Weave account email
2. Re-sync the Slack workspace from the **Data** page

## Disconnecting Slack

To disconnect Slack, contact Weave support at [support@workweave.ai](mailto:support@workweave.ai). Slack connections are managed at the organization level and require support assistance to remove.

To revoke Weave's access from the Slack side, go to your Slack workspace settings and remove the Weave app under **Settings & administration > Manage apps**.


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