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

# Slack

> What the Synapse app for Slack does, how to install and remove it, what it reads, and how to get support

The Synapse app for Slack posts your team's weekly digest and goal alerts to a channel. It also adds `/synapse` commands, so leads can check AI adoption and developer insights without leaving Slack. Learn more and install it at [synapse.work/slack](https://synapse.work/slack).

## Support

Email **[hi@synheart.ai](mailto:hi@synheart.ai)** for help with the Slack app. You don't need a Synapse account or any other sign-up to contact us.

* **Response time:** we reply within 2 business days.
* **Include:** your Slack workspace name, the command or channel involved, and what you expected to happen. Screenshots help.
* **Security reports:** send them to [security@synheart.ai](mailto:security@synheart.ai).
* **Privacy and data requests:** to access, export or delete your data, email [hi@synheart.ai](mailto:hi@synheart.ai). See the [privacy policy](https://synapse.work/privacy-policy).

## Install

Slack is connected once for the whole organization, and a Synapse Admin installs it.

1. Sign in at [synapse.synheart.ai](https://synapse.synheart.ai) as a Synapse Admin, or [create an account](https://synapse.synheart.ai/signup).
2. Choose **Add to Slack** on [synapse.work/slack](https://synapse.work/slack), or go to **Admin → Connectors** and connect **Slack**.
3. Slack shows the workspace and every permission Synapse asks for. Review them and choose **Allow**.

Slack appears under **Connected** on the [Connectors](https://docs.synheart.ai/synapse/connectors.md) page once it's installed. Slack is included on Synapse Free.

## Use it

**Weekly digest.** Under **Teams → Goals & alerts**, turn on **Post to Slack weekly** and choose a channel. Invite `@Synapse` to that channel. See [Weekly digest](https://docs.synheart.ai/synapse/goals-and-alerts.md#weekly-digest).

**Goal alerts.** When you create an alert, set **Notify via** to **Slack** and choose a channel. See [Goals & alerts](https://docs.synheart.ai/synapse/goals-and-alerts.md).

**Commands.** Type these in any channel Synapse is in:

| Command | Does |
| - | - |
| `/synapse digest` | Shows the full weekly digest |
| `/synapse why` | Shows what moved this week |
| `/synapse recommend` | Lists the top recommended actions |
| `/synapse aei` | Shows AI adoption, delivery and human state, each in its own unit |
| `/synapse ask <question>` | Searches your organization's memory |
| `/synapse remember as adr: <decision>` | Saves a decision for people and agents |

Team figures go only to Synapse leads and admins who have linked their Slack account under **You → My connections**. If a group is smaller than the privacy floor, Synapse doesn't answer for it and says why.

## What Synapse asks Slack for

| Permission | Why |
| - | - |
| `commands` | Adds the `/synapse` command. |
| `chat:write` | Posts the weekly digest, goal alerts and command replies. |
| `channels:read`, `groups:read` | Lists channels, so an admin can choose where Synapse posts. |
| `channels:history`, `groups:history` | Reads message IDs, authors and times. Reads text only from public channels an admin adds as [knowledge sources](https://docs.synheart.ai/synapse/knowledge-sources.md). |
| `users:read` | Shows names instead of user IDs. |
| `users:read`, `users:read.email` (user) | Matches the person installing to their Synapse account. |

Synapse never reads direct messages, files, or the text of private or shared channels. See [What each source gives Synapse](https://docs.synheart.ai/synapse/connectors.md#what-each-source-gives-synapse).

## Remove it

Either of these stops collection:

* In Synapse, go to **Admin → Connectors**, open **Slack** and choose **Disconnect**. To delete what Synapse already imported from Slack, tick **Also delete everything Synapse imported**. See [Disconnecting](https://docs.synheart.ai/synapse/connectors.md#disconnecting).
* In Slack, remove the Synapse app from your workspace's app settings.

If you removed the app in Slack and want the imported data deleted too, email [hi@synheart.ai](mailto:hi@synheart.ai).

## Troubleshooting

| Problem | Fix |
| - | - |
| `/synapse` replies that Slack isn't connected | A Synapse Admin needs to finish installing from **Admin → Connectors**. |
| The digest or an alert doesn't post | Invite `@Synapse` to the channel, then choose **Send one now** under **Weekly digest**. |
| Commands don't return team figures | Link your Slack account under **You → My connections**. Only leads and admins see team figures. |
| Slack is under **Needs attention** | Open it on the Connectors page and choose **Reconnect**. |

If none of these fix it, [contact support](#support).


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