> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connecting Slack

Connect Slack so Katalyz notifications reach you (and your team) where you're already communicating.

> ⚠️ Requires org role **Admin** on the Katalyz side **and** on the Slack side (a Slack admin must be able to authorize the app in the Slack workspace).

## Connection procedure

The integration is **two-way**: you have to **both** enable Slack on the Katalyz side **and** add Katalyz as an app inside Slack. One step alone isn't enough.

### 1. On the Katalyz side — enable Slack

1. Go to **Settings → Integrations**.
2. Find **Slack** in the list, click **Connect**.
3. You're redirected to Slack for OAuth authorization.

### 2. On the Slack side — authorize and install the Katalyz app

![](https://storage.crisp.chat/users/helpdesk/website/-/5/5/4/8/554891f22af0b400/screenshot-1806-043905-pm_13d28xz.jpg)
### 2. Côté Slack — autoriser et installer l'app Katalyz

Step 1 lands you on Slack's OAuth authorization screen. This is where the app actually gets installed into your Slack workspace:

1. **Check the target Slack workspace.** It's shown at the top-right of the authorization screen (under your avatar). If you belong to more than one Slack workspace, **click it to switch** to the right one before continuing — the wrong choice here installs Katalyz into the wrong workspace.
2. **Review the requested permissions.** Slack lists everything Katalyz will be able to do (send messages, read basic workspace info, etc.).
3. **Click "Allow"** at the bottom-right. Slack installs the app and redirects you back to Katalyz; the integration status flips to **Connected**.
4. **Verify the install on the Slack side**: open your Slack client → in the left sidebar, expand the **Apps** section (or click **More → Apps**) — **Katalyz** should be listed. A DM with the **Katalyz** bot also appears under **Direct Messages**.

> **If "Allow" sends a request to a Slack admin instead of installing directly**: your Slack workspace probably has **App Management** enabled, which requires an admin to approve new apps. The request goes to a Slack admin; once they click **Approve**, finish the OAuth on the Katalyz side. See Slack's docs on [managing app installations](https://slack.com/help/articles/202035138-Add-apps-to-your-Slack-workspace).

Once both sides are done, Katalyz notifications arrive as **direct messages from the Katalyz bot** in Slack (there's no channel to configure — see [Slack notifications](https://katalyz.crisp.help/en/article/slack-notifications-what-youll-receive-csxvad/)).

## ⚠️ Common pitfalls

### Free Slack — 10-app cap

On the **free Slack tier**, a workspace is capped at **10 installed apps**. If you've already hit that limit, **installing Katalyz will fail** with an error on the Slack side.

Fixes:

- Uninstall an unused Slack app to free a slot, then retry the install from the Katalyz side.
- Or upgrade to a paid Slack plan (Pro, Business+, Enterprise) which lifts the cap.

This is the most common reason step 2 fails.

## Permissions Katalyz requests

The Slack install screen surfaces the exact scopes Katalyz requests — the full canonical list will be published here ahead of GA.

## Per-user notification preferences

Each user controls their own Slack notifications in **Settings → Notifications**. See [Notification preferences](https://katalyz.crisp.help/en/article/notification-preferences-1mglop1/).

## Related articles
- [Slack notifications: what you'll receive](https://katalyz.crisp.help/en/article/slack-notifications-what-youll-receive-csxvad/)
- [Quieting Slack alerts](https://katalyz.crisp.help/en/article/quieting-slack-alerts-eagt1k/)
- [Slack notifications are silent](https://katalyz.crisp.help/en/article/slack-notifications-are-silent-y02ddj/)