Comment intégrer Slack avec n8n auto‑hébergé ?

L’in­té­gra­tion de Slack avec n8n dans une instance auto-hébergée vous permet d’intégrer di­rec­te­ment Slack à vos workflows d’au­to­ma­ti­sa­tion et de cen­tra­li­ser vos processus. Vous pouvez ainsi envoyer des messages, traiter des évé­ne­ments et au­to­ma­ti­ser ef­fi­ca­ce­ment les processus internes de votre équipe.

Quels sont les avantages de l’in­té­gra­tion de Slack avec n8n ?

La connexion de Slack avec n8n vous offre une interface centrale pour relier com­mu­ni­ca­tion et au­to­ma­ti­sa­tion. Vous pouvez envoyer au­to­ma­ti­que­ment dans Slack des no­ti­fi­ca­tions provenant de dif­fé­rents systèmes et vous assurer ainsi que les in­for­ma­tions im­por­tantes par­vien­nent ra­pi­de­ment à votre équipe. Dans le même temps, les tâches manuelles sont réduites, car les processus ré­cur­rents comme les rapports de statut, les re­por­tings ou les rappels peuvent être au­to­ma­ti­sés. De plus, Slack peut servir d’interface de contrôle pour dé­clen­cher des workflows ou réagir à certains évé­ne­ments.

Dans les en­vi­ron­ne­ments n8n auto-hébergés, vous conservez par ailleurs le contrôle sur la sécurité et les accès. n8n permet également de combiner Slack avec de nombreux autres services, par exemple grâce à l’in­té­gra­tion de Discord dans n8n, afin de mettre en place des au­to­ma­ti­sa­tions complexes entre dif­fé­rents systèmes. Vous pouvez aussi étendre vos workflows ou les adapter à de nouvelles exigences à tout moment.

Quelles sont les con­di­tions préa­lables ?

Avant de con­fi­gu­rer l’in­té­gra­tion de Slack avec n8n, vérifiez ra­pi­de­ment que votre instance n8n et votre workspace Slack rem­plis­sent les con­di­tions né­ces­saires. Contrôlez notamment les prérequis suivants :

• n8n auto-hébergé avec une URL publique : votre instance n8n doit être ac­ces­sible pu­bli­que­ment via une URL fixe afin que les re­di­rec­tions OAuth et les callbacks Slack fonc­tion­nent cor­rec­te­ment.
• HTTPS pour le domaine n8n : Slack exige HTTPS pour les URL de re­di­rec­tion OAuth. Une URL HTTP non chiffrée ne suffit donc pas en pratique.
• Workspace Slack avec les droits d’ad­mi­nis­tra­tion ou les au­to­ri­sa­tions né­ces­saires : pour installer l’ap­pli­ca­tion dans le workspace, vous devez gé­né­ra­le­ment disposer des droits ap­pro­priés, car l’ap­pli­ca­tion doit être autorisée à utiliser les scopes demandés.
• Accès à la gestion des ap­pli­ca­tions Slack : vous devez pouvoir accéder à l’interface dé­ve­lop­peur de Slack pour créer une ap­pli­ca­tion, définir les scopes et, si né­ces­saire, activer les Event Subs­crip­tions.
• Dé­fi­ni­tion des actions Slack sou­hai­tées : selon que vous souhaitez uni­que­ment envoyer des messages ou réagir à de nouveaux messages, les exigences en matière d’au­then­ti­fi­ca­tion et d’au­to­ri­sa­tions peuvent varier.

Quelles sont les étapes à suivre pour intégrer Slack à n8n ?

Étape 1 : con­fi­gu­rer cor­rec­te­ment l’URL publique de n8n et le reverse proxy

Avant de connecter Slack, votre instance n8n doit être ac­ces­sible via la bonne URL externe. C’est par­ti­cu­liè­re­ment important si n8n fonc­tionne en interne sur le port 5678, mais est publié via un reverse proxy sous son propre domaine avec HTTPS. Dans ce type de con­fi­gu­ra­tion, vous devez définir ex­pli­ci­te­ment l’adresse publique afin que n8n génère des URL de callback et de webhook correctes.

Dé­fi­nis­sez pour cela la variable WEBHOOK_URL avec votre domaine HTTPS externe. Sinon, n8n risque d’utiliser des URL internes qui ne seront pas ac­ces­sibles depuis Slack. Dé­fi­nis­sez aussi N8N_PROXY_HOPS=1 afin que n8n in­ter­prète cor­rec­te­ment les en-têtes transmis par le proxy. Veillez en outre à ce que votre reverse proxy trans­mette les en-têtes X-Forwarded-For, X-Forwarded-Host et X-Forwarded-Proto, car ils sont né­ces­saires à la détection correcte de l’URL. Une con­fi­gu­ra­tion correcte est in­dis­pen­sable pour que la connexion OAuth avec Slack et le dé­clen­cheur Slack fonc­tion­nent de manière fiable.

Un exemple possible dans un fichier Docker Compose ressemble à ceci :

services:
    n8n:
        image: docker.n8n.io/n8nio/n8n:stable
        ports:
            - "5678:5678"
        environment:
            - N8N_HOST=n8n.example.com
            - N8N_PROTOCOL=https
            - N8N_WEBHOOK_URL=https://n8n.example.com/
            - N8N_PROXY_HOPS=1
            - GENERIC_TIMEZONE=Europe/Paris
            - TZ=Europe/Paris
        volumes:
            - n8n_data:/home/node/.n8n
volumes:
    n8n_data:

Étape 2 : créer une app Slack pour l’in­té­gra­tion n8n

Pour connecter Slack à n8n, vous avez besoin d’une ap­pli­ca­tion Slack dédiée. Cette ap­pli­ca­tion constitue la base technique qui permet ensuite à n8n de com­mu­ni­quer avec votre workspace. Dans l’interface dé­ve­lop­peur de Slack, créez une nouvelle ap­pli­ca­tion, attribuez-lui un nom et sé­lec­tion­nez le workspace souhaité.

Dans la section « Basic In­for­ma­tion », vous trouverez ensuite les prin­ci­pales in­for­ma­tions de l’ap­pli­ca­tion, notamment le Client ID et le Client Secret, que vous ren­seig­ne­rez plus tard dans n8n. Vous ne créez pas ici un bot Telegram classique avec n8n au sens d’un chatbot programmé de manière autonome, mais une ap­pli­ca­tion qui permet à n8n d’accéder à Slack de manière autorisée.

Procédez étape par étape :

1. Ouvrez la gestion des ap­pli­ca­tions Slack.
2. Sé­lec­tion­nez « Create an App ».

Close

3. Sé­lec­tion­nez « From scratch ».
4. Attribuez un nom à l’ap­pli­ca­tion, par exemple n8n test.
5. Sé­lec­tion­nez votre workspace Slack.

Close

6. Ouvrez ensuite la nouvelle ap­pli­ca­tion dans la vue détaillée.

Étape 3 : préparer OAuth dans Slack et reprendre l’URL de re­di­rec­tion depuis n8n

À l’étape suivante, vous connectez Slack à n8n via OAuth2. Pour cela, n8n génère au­to­ma­ti­que­ment, dans les Slack Cre­den­tials, une URL de rappel OAuth (OAuth Callback URL) que vous devez en­re­gis­trer dans Slack comme URL de re­di­rec­tion.

Ouvrez pour cela un nouveau workflow dans n8n, ajoutez un nœud Slack et créez de nouveaux iden­ti­fiants avec OAuth2. Copiez ensuite l’URL de rappel affichée et ouvrez la con­fi­gu­ra­tion de votre ap­pli­ca­tion Slack, dans la section « OAuth & Per­mis­sions ». Saisissez cette URL dans « Redirect URLs » et en­re­gis­trez la mo­di­fi­ca­tion.

Close

Vous pouvez ensuite ajouter les scopes né­ces­saires et installer l’ap­pli­ca­tion dans votre workspace. Ce n’est qu’une fois ces étapes terminées que vous pourrez autoriser la connexion dans n8n via votre na­vi­ga­teur. Veillez à ce que l’URL de re­di­rec­tion saisie cor­res­ponde exac­te­ment à votre domaine HTTPS ac­ces­sible pu­bli­que­ment, car Slack n’accepte que des adresses HTTPS sé­cu­ri­sées.

Étape 4 : définir les scopes Slack ap­pro­priés et installer l’ap­pli­ca­tion

Pour que n8n puisse réel­le­ment effectuer des actions dans Slack, vous devez attribuer les au­to­ri­sa­tions ap­pro­priées. Pour les cre­den­tials OAuth, n8n propose plusieurs scopes courants qui cons­ti­tuent un bon point de départ.

Les scopes dont vous avez réel­le­ment besoin dépendent toutefois des tâches que votre workflow doit effectuer. Si vous souhaitez uni­que­ment envoyer des messages, un ensemble nettement plus réduit suffit gé­né­ra­le­ment, par rapport à des workflows qui chargent des fichiers, lisent des réactions ou ré­cu­pè­rent des in­for­ma­tions sur les canaux. Après avoir saisi les scopes, installez l’ap­pli­ca­tion via « Install to Workspace » et confirmez les au­to­ri­sa­tions. n8n peut ensuite établir la connexion.

Pour de nombreux workflows n8n, les scopes suivants cons­ti­tuent un point de départ adapté :

• chat:write
• channels:read
• channels:history
• users:read
• files:read
• files:write
• reactions:read
• reactions:write

Étape 5 : connecter et tester les iden­ti­fiants Slack dans n8n

Une fois l’ap­pli­ca­tion installée dans Slack, retournez dans n8n et finalisez la connexion OAuth en ren­seig­nant le Client ID et le Client Secret de votre ap­pli­ca­tion.

Close

Dans les cre­den­tials Slack, cliquez ensuite sur l’option de connexion via le na­vi­ga­teur et autorisez l’accès à votre workspace. Si tout est cor­rec­te­ment configuré, le nœud Slack peut alors être utilisé di­rec­te­ment dans vos workflows.

Close

n8n prend en charge de nom­breuses actions dans le nœud Slack, notamment les opé­ra­tions sur les canaux, l’envoi de fichiers, les réactions, les requêtes con­cer­nant les uti­li­sa­teurs et, surtout, les opé­ra­tions sur les messages, comme « Send a message » ou « Update a message ». Pour un premier test, il est pré­fé­rable d’utiliser un workflow très simple, lancé ma­nuel­le­ment, qui envoie un seul message dans un canal Slack sé­lec­tionné. Vous pouvez ainsi vérifier im­mé­dia­te­ment si l’au­then­ti­fi­ca­tion, les scopes et le canal cible fonc­tion­nent cor­rec­te­ment.

Une con­fi­gu­ra­tion de test simple se compose d’un Manual Trigger et d’un nœud Slack. Dans le nœud Slack, sé­lec­tion­nez par exemple :

• Resource: Message
• Operation: Send a message
• Channel: #au­to­ma­tio­nen

Assurez-vous que votre ap­pli­ca­tion a déjà été ajoutée au canal cible.

Étape 6 : con­fi­gu­rer en option le Slack Trigger pour les évé­ne­ments Slack entrants

Si vous ne souhaitez pas seulement envoyer des messages à Slack depuis n8n, mais aussi permettre à des évé­ne­ments Slack de dé­clen­cher des workflows, vous avez besoin du Slack Trigger. Une dif­fé­rence im­por­tante doit alors être prise en compte : le Trigger n’utilise pas OAuth2, mais un jeton d’accès (Access Token) à l’API que vous générez di­rec­te­ment dans Slack.

Créez ce token dans l’ap­pli­ca­tion Slack, dans la section « OAuth & Per­mis­sions ». Après avoir ajouté les scopes requis, installez l’ap­pli­ca­tion via « Install to Workspace ». Slack met ensuite à votre dis­po­si­tion, sous « OAuth Tokens for Your Workspace », un Bot User OAuth Token com­men­çant par xoxb-. Copiez ce token et utilisez-le dans n8n comme Access Token API.

Créez ensuite dans n8n les iden­ti­fiants Slack cor­res­pon­dants à l’aide de ce token et ajoutez un nœud Slack Trigger à votre workflow. Sé­lec­tion­nez l’événement qui doit dé­clen­cher le workflow. Copiez l’URL de webhook affichée par le nœud, puis ouvrez dans Slack la section « Event Subs­crip­tions ». Activez la fonction et saisissez l’URL comme Request URL afin que Slack puisse envoyer les évé­ne­ments à n8n. Sé­lec­tion­nez ensuite les évé­ne­ments de bot souhaités. Vous pouvez également ren­seig­ner le Signing Secret de Slack dans n8n afin de vérifier les requêtes entrantes.

Close

Il est important de noter que Slack n’autorise qu’une seule Request URL par ap­pli­ca­tion. Si vous passez d’un en­vi­ron­ne­ment de test à un en­vi­ron­ne­ment de pro­duc­tion, vous devez donc adapter cette URL en con­sé­quence ou utiliser une URL fixe en séparant clai­re­ment les workflows.

Quels workflows Slack avec n8n pouvez-vous mettre en place ?

La véritable force de l’in­té­gra­tion Slack se révèle avec des au­to­ma­ti­sa­tions concrètes. Dans n8n, Slack ne sert pas uni­que­ment à envoyer de simples no­ti­fi­ca­tions, mais aussi à gérer des va­li­da­tions, des escalades, des trans­ferts de fichiers ou la trans­mis­sion struc­tu­rée de messages système. Surtout dans les équipes qui gèrent de nombreux processus ré­cur­rents, l’in­té­gra­tion de Slack avec n8n peut rac­cour­cir les temps de réaction et réduire les étapes manuelles.

Exemple 1 : publier au­to­ma­ti­que­ment les messages système et de mo­ni­to­ring dans Slack

Un workflow très courant consiste à envoyer des messages de statut provenant de serveurs, d’outils de mo­ni­to­ring ou de for­mu­laires vers un canal Slack. Une in­for­ma­tion im­por­tante arrive ainsi di­rec­te­ment là où votre équipe travaille déjà, plutôt que dans des emails isolés ou sur des tableaux de bord qui ne sont pas consultés en per­ma­nence.

Dans n8n, le workflow peut par exemple être déclenché par un Webhook, un Cron Trigger ou un autre service. Les données peuvent ensuite être préparées, filtrées et trans­for­mées en un message Slack lisible. Vous pouvez ainsi trans­mettre di­rec­te­ment des erreurs, des dé­ploie­ments, des sau­ve­gardes ou des messages de support vers un canal d’ex­ploi­ta­tion ou d’équipe. Le Slack Node envoie ensuite au­to­ma­ti­que­ment le message final dans le canal souhaité. Si né­ces­saire, vous pouvez ajouter plusieurs Slack Nodes pour notifier plusieurs équipes en parallèle. Cela peut être utile lorsque les messages doivent être répartis dans dif­fé­rents canaux selon leur niveau de gravité ou leur type.

Close

Exemple 2 : trans­mettre au­to­ma­ti­que­ment à Slack les nouveaux fichiers ou contenus issus d’autres outils

Un autre cas d’usage pertinent est le transfert au­to­ma­tique de nouveaux fichiers, tickets ou en­re­gis­tre­ments vers Slack. Lorsqu’une nouvelle entrée est créée dans un autre système, n8n peut récupérer les in­for­ma­tions, les trans­for­mer en un court résumé et les publier dans le canal de l’équipe. Personne n’a ainsi besoin de consulter ré­gu­liè­re­ment plusieurs outils ma­nuel­le­ment.

De cette manière, des rapports, de nouveaux messages reçus via Telegram dans n8n, des fichiers d’export ou des PDF générés peuvent être transmis au­to­ma­ti­que­ment à Slack avec un bref contexte. L’équipe peut alors réagir im­mé­dia­te­ment, sans devoir vérifier au préalable si de nouveaux contenus sont dis­po­nibles. Ce workflow peut notamment améliorer la vi­si­bi­lité des nouveaux contenus pour les équipes marketing, support ou projet.

Close

Exemple 3 : réagir aux évé­ne­ments Slack et dé­clen­cher d’autres processus

Slack peut devenir le dé­clen­cheur d’un workflow n8n. Avec un trigger, de nouveaux messages, des réactions ou d’autres évé­ne­ments peuvent lancer di­rec­te­ment un workflow. Vous pouvez ainsi définir, par exemple, qu’un message dans un canal spé­ci­fique déclenche un trai­te­ment interne, interroge des données dans un système tiers ou démarre un processus dans un autre outil.

Dans n8n, vous pouvez d’abord vérifier les données de l’événement entrant, puis orienter le workflow vers dif­fé­rents chemins selon son contenu. Par exemple, des messages suivant un certain schéma peuvent être au­to­ma­ti­que­ment classés, transmis via n8n à un système de tickets comme Jira ou do­cu­men­tés en interne. Les réactions à un message Slack peuvent également servir de signal de va­li­da­tion. Il est important de limiter le trigger aux évé­ne­ments et aux canaux réel­le­ment né­ces­saires afin d’éviter des exé­cu­tions de workflow inutiles.

Close