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

# Connecter Slack

Connectez Slack pour recevoir les notifications Katalyz (vous et votre équipe) là où vous communiquez déjà.

> ⚠️ Nécessite le rôle d'organisation **Admin** côté Katalyz **et** côté Slack (un admin Slack doit pouvoir autoriser l'app dans l'espace de travail Slack).

## Procédure de connexion

L'intégration est **bidirectionnelle** : il faut **à la fois** activer Slack côté Katalyz **et** ajouter Katalyz comme app dans Slack. Une seule des deux étapes ne suffit pas.

### 1. Côté Katalyz — activer Slack

1. Allez dans **Paramètres → Intégrations**.
2. Trouvez **Slack** dans la liste, cliquez sur **Connecter**.
3. Vous êtes redirigé vers Slack pour l'autorisation OAuth.

![](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

L'étape 1 vous renvoie sur l'écran d'autorisation OAuth de Slack. C'est là que se fait l'installation effective de l'app dans votre espace de travail Slack :

1. **Vérifiez l'espace de travail Slack ciblé.** Il est affiché en haut à droite de l'écran d'autorisation (sous votre avatar). Si vous êtes membre de plusieurs espaces Slack, **cliquez dessus pour basculer** sur le bon avant de continuer — un mauvais choix ici installe Katalyz dans le mauvais workspace.
2. **Vérifiez les permissions demandées.** Slack liste tout ce que Katalyz pourra faire (envoyer des messages, lire des informations basiques sur l'espace, etc.).
3. **Cliquez sur « Allow »** (Autoriser) en bas à droite. Slack installe alors l'app et vous renvoie vers Katalyz ; le statut de l'intégration passe à **Connecté**.
4. **Vérifiez l'installation côté Slack** : ouvrez votre client Slack → dans la barre latérale gauche, dépliez la section **Apps** (ou cliquez sur **More → Apps**) — **Katalyz** doit y figurer. Un DM avec le bot **Katalyz** apparaît aussi dans **Direct Messages**.

> **Si « Allow » envoie une demande à un admin Slack au lieu d'installer directement** : votre espace de travail Slack a probablement l'option **App Management** activée, qui exige qu'un admin approuve les nouvelles apps. La demande est envoyée à un admin Slack ; une fois qu'il a cliqué sur **Approuver**, terminez l'OAuth côté Katalyz. Voir la doc Slack [Manage app installations](https://slack.com/help/articles/202035138-Add-apps-to-your-Slack-workspace).

Une fois la double activation faite, les notifications Katalyz arrivent comme **messages directs du bot Katalyz** dans Slack (il n'y a pas de canal à configurer — voir [Notifications Slack](https://katalyz.crisp.help/fr/article/notifications-slack-ce-que-vous-allez-recevoir-ehkq7o/)).

## ⚠️ Pièges courants

### Slack gratuit — limite de 10 applications

Sur la **version gratuite de Slack**, votre espace de travail est plafonné à **10 applications installées** maximum. Si vous avez déjà atteint cette limite, **l'installation de Katalyz échouera** avec un message d'erreur côté Slack.

Solutions :

* Désinstallez une application Slack inutilisée pour libérer un slot, puis recommencez l'installation côté Katalyz.
* Ou passez à un plan Slack payant (Pro, Business+, Enterprise) qui lève la limite.

C'est la cause la plus fréquente d'échec à l'étape 2.

## Permissions demandées par Katalyz

L'écran d'installation Slack affiche les scopes exacts demandés par Katalyz — la liste canonique complète sera publiée ici avant la GA.

## Préférences de notification par utilisateur

Chaque utilisateur contrôle ses propres notifications Slack dans **Paramètres → Notifications**. Voir [Préférences de notification](https://katalyz.crisp.help/fr/article/preferences-de-notification-1kj1p03/).

## Articles liés
* [Notifications Slack : ce que vous recevrez](https://katalyz.crisp.help/fr/article/notifications-slack-ce-que-vous-allez-recevoir-ehkq7o/)
* [Limiter les alertes Slack](https://katalyz.crisp.help/fr/article/reduire-les-alertes-slack-1vuwnxz/)
* [Les notifications Slack sont silencieuses](https://katalyz.crisp.help/fr/article/les-notifications-slack-sont-silencieuses-17bkugf/)