Introduction
Connectez Slack pour permettre à l’assistant IA et aux agents d’effectuer des recherches dans les canaux sélectionnés au moment même où une question est posée.
Il s’agit d’un connecteur en temps réel. Aucune donnée de Slack n’est copiée, indexée ni stockée dans Docebo. Lorsqu’une question est posée, Docebo effectue immédiatement une recherche dans les canaux que vous avez rendus disponibles, à l’aide du compte Slack personnel de la personne qui pose la question.
Fonctionnement des droits pour Slack : chaque collègue connecte son propre compte Slack la première fois que cela est nécessaire. Chaque recherche s’exécute ensuite sous l’identité de cette personne, qui ne voit donc que les contenus qu’elle pourrait ouvrir elle-même dans Slack. Le compte que vous utilisez lors de la configuration sert uniquement à configurer la connexion et à répertorier les canaux parmi lesquels vous pouvez choisir.
1. Prérequis dans le système source
Rôle requis
Vous devez disposer du droit de créer des applications dans votre espace de travail Slack. Si celui-ci exige la validation des nouvelles applications par un administrateur, un administrateur de l’espace de travail doit approuver l’application une seule fois (voir l’étape 3).
Paramètres requis
Le compte utilisé pour l’autorisation doit être membre de chaque canal privé que vous souhaitez rendre disponible.
2. Préparation dans le système source
Vous pouvez soit créer une application Slack à partir du manifeste fourni par Docebo (recommandé), soit réutiliser une application existante.
Créer l’application Slack à partir du manifeste
- Dans l’onglet Autoriser de Docebo, copiez le manifeste à l’aide du bouton de copie.
- Ouvrez Create a Slack app (api.slack.com/apps) et connectez-vous à Slack si nécessaire.
- Choisissez From a manifest, sélectionnez votre espace de travail et cliquez sur Suivant.
- Basculez l’éditeur sur JSON, remplacez son contenu par le manifeste, puis cliquez sur Suivant et sur Créer et Installez.
Slack affiche la page Informations de base de la nouvelle application. Le manifeste contient déjà les droits et l’URL de redirection : vous n’avez donc rien d’autre à configurer.
Le manifeste demande les champs d’application de jeton utilisateur suivants :
| Champ d’application | Ce qu’il permet |
|---|---|
| channels:read | Afficher les informations de base sur les canaux publiques |
| channels:history | Afficher les messages et autres contenus des canaux publics |
| groups:read | Afficher les informations de base sur les canaux privés auxquelles vous avez accès |
| groups:history | Afficher les messages et autres contenus des canaux privés auxquelles vous avez accès |
| search:read.public | Rechercher des messages et des fichiers dans les canaux publics |
| search:read.private | Rechercher des messages et des fichiers dans les canaux privés auxquelles vous avez accès |
| search:read.users | Rechercher des personnes dans l’espace de travail |
| users:read | Afficher les personnes de l’espace de travail |
Vous avez déjà une application Slack ? Réutilisez-la
Ignorez le manifeste et configurez votre application existante :
- Ouvrez l’application sur api.slack.com/apps et accédez à OAuth & Permissions.
- Sous Redirect URLs, ajoutez l’URL de rappel affichée dans Docebo et cliquez sur Save URLs. Elle suit ce modèle : https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, par exemple https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- Sous Scopes → User Token Scopes, ajoutez tous les champs d’application répertoriés ci-dessus.
- N’activez pas Token Rotation. Rien ne doit être activé sur la page Agents : laissez donc le bouton d’activation Slack MCP Server désactivé.
- Si Slack vous demande de réinstaller l’application, faites-le, puis passez à la section suivante.
3. Actions requises dans Docebo
| Informations à saisir | Où les trouver |
|---|---|
| ID client | Application Slack → Informations de base → Identifiants de l’application |
| Secret client | Application Slack → Informations de base → Identifiants de l’application. Cliquez sur Afficher à côté de Secret client. N’utilisez pas le Secret de signature |
Autoriser le connecteur
- Accédez à Modules et intégrations → Connecteurs de connaissances → Créer → Slack. Ce menu n’est visible que par les Superadmins. Dans l’onglet Aperçu, vérifiez les éléments qui feront l’objet de la recherche, puis sélectionnez Démarrer.
- Dans l’onglet Autoriser, suivez les étapes pour créer ou réutiliser votre application Slack (voir Préparation).
- Sur la page Informations de base de votre application, sous Identifiants de l’application, copiez l’ID client et le secret client dans les champs de l’onglet Autoriser.
- Sélectionnez S’authentifier, connectez-vous avec le compte Slack membre de chaque canal privé que vous souhaitez rendre disponible, puis cliquez sur Autoriser. Si votre espace de travail exige la validation des nouvelles applications par un administrateur, Slack affiche plutôt un écran de demande. Un administrateur de l’espace de travail approuve l’application une seule fois, puis vous sélectionnez de nouveau S’authentifier.
- Dans l’onglet Canaux, sélectionnez les canaux que vous souhaitez rendre disponibles, puis enregistrez votre sélection.