Comment créer un bot Discord avec n8n et l’IA ?

Un bot Discord avec n8n et l’IA peut répondre au­to­ma­ti­que­ment aux messages, traiter des contenus et exécuter dif­fé­rentes tâches en arrière-plan. Pour cela, Discord, n8n et un modèle d’IA sont connectés afin d’analyser les messages entrants et de dé­clen­cher les réponses ou actions ap­pro­priées. Ces bots peuvent notamment servir à au­to­ma­ti­ser la com­mu­ni­ca­tion, modérer un serveur ou intégrer des services externes à Discord.

Quels sont les avantages d’un bot Discord créé avec n8n ?

Un bot Discord créé avec n8n permet d’au­to­ma­ti­ser de nombreux processus sans dé­ve­lop­pe­ment logiciel classique. Plutôt que de pro­gram­mer un bot complet en Python ou en Ja­vaS­cript depuis zéro, vous cons­trui­sez un workflow visuel dans n8n à partir de dif­fé­rents blocs. Cette approche est par­ti­cu­liè­re­ment adaptée si vous souhaitez vous fa­mi­lia­ri­ser avec les au­to­ma­ti­sa­tions.

Autres avantages :

• Mo­di­fi­ca­tions sim­pli­fiées : les dif­fé­rentes étapes du workflow peuvent être adaptées di­rec­te­ment dans l’interface, ce qui facilite les ajus­te­ments ul­té­rieurs.
• Fonctions d’IA : vous pouvez enrichir votre bot avec des fonctions d’in­tel­li­gence ar­ti­fi­cielle, par exemple pour générer des réponses au­to­ma­tiques, résumer des contenus ou faciliter la mo­dé­ra­tion.
• Nom­breuses in­té­gra­tions : n8n peut être connecté à de nombreux services. Votre bot peut ainsi traiter des données provenant de Google Sheets, de bases de données, de CRM ou de systèmes helpdesk. Des outils comme Jira peuvent également être intégrés à n8n pour créer au­to­ma­ti­que­ment des tickets ou publier des messages de statut dans Discord.
• Bonne tra­ça­bi­lité : le workflow permet de voir pré­ci­sé­ment quelles étapes sont exécutées et à quel moment. Cela facilite la recherche d’erreurs et les ex­ten­sions ul­té­rieures.
• Stan­dar­di­sa­tion des processus : pour les équipes et les en­tre­prises, n8n permet d’au­to­ma­ti­ser et de stan­dar­di­ser les tâches ré­cur­rentes.

Quels sont les prérequis ?

Avant de commencer à créer un bot Discord avec n8n et l’IA, vous devez réunir quelques prérequis es­sen­tiels. Une pré­pa­ra­tion soignée facilite la mise en place et permet de connecter les dif­fé­rents com­po­sants sans dif­fi­culté. La plupart des accès né­ces­saires peuvent être con­fi­gu­rés ra­pi­de­ment, mais il est pré­fé­rable de préparer tous les éléments à l’avance.

Pour mettre en œuvre votre projet, vous avez besoin de :

• Une instance n8n en cours d’exécution, ac­ces­sible pu­bli­que­ment avec HTTPS
• Un compte Discord
• Un serveur Discord sur lequel vous disposez de droits d’ad­mi­nis­tra­tion
• Un accès au Discord Developer Portal
• Un jeton de bot
• Un Webhook et un bot connecté à Discord
• Un accès API à un service d’IA, par exemple OpenAI
• Un peu de temps pour effectuer les premiers tests et ajus­te­ments

Pour les débutants : nous vous re­com­man­dons de créer votre propre serveur Discord pour effectuer les premiers tests. Vous pourrez ainsi ex­pé­ri­men­ter votre workflow n8n et corriger d’éven­tuelles erreurs sans affecter un serveur existant ou utilisé en pro­duc­tion.

Comment créer un Discord bot avec n8n et l’IA étape par étape ?

Étape 1 : préparer un serveur Discord pour les tests

Si vous n’avez pas encore votre propre serveur de test, commencez par en créer un. Ouvrez Discord, cliquez sur le symbole plus dans la barre latérale gauche, puis créez un nouveau serveur. Donnez-lui un nom : ce serveur vous permettra ensuite de tester votre bot Discord avec n8n dans un en­vi­ron­ne­ment séparé.

Un serveur de test dédié est par­ti­cu­liè­re­ment utile pour vérifier de manière contrôlée les messages, les au­to­ri­sa­tions et les réponses du bot. Lors des premiers essais avec des au­to­ma­ti­sa­tions, de petites erreurs peuvent fa­ci­le­ment se produire. Dans un en­vi­ron­ne­ment de test, vous pouvez les iden­ti­fier et les corriger sans perturber un serveur existant. Veillez à disposer des droits d’ad­mi­nis­tra­teur sur ce serveur.

Étape 2 : créer une ap­pli­ca­tion dans le Discord Developer Portal

Ouvrez main­te­nant le Discord Developer Portal et connectez-vous avec votre compte Discord. Cliquez sur New Ap­pli­ca­tion, puis attribuez un nom à votre ap­pli­ca­tion. Cette ap­pli­ca­tion servira de base à votre futur bot Discord avec n8n.

Passez ensuite à la section « Bot » et créez le bot. Discord génère alors un profil qui pourra com­mu­ni­quer ul­té­rieu­re­ment avec votre workflow n8n. L’élément le plus important est le Bot-Token. Ce jeton fonc­tionne comme un mot de passe pour votre bot et sera ensuite en­re­gis­tré dans n8n. Conservez-le donc de manière con­fi­den­tielle : toute personne qui y a accès pourrait prendre le contrôle de votre bot ou effectuer des actions en votre nom.

Close

Étape 3 : définir les au­to­ri­sa­tions né­ces­saires pour le bot

Pour que votre bot puisse fonc­tion­ner sur votre serveur, il a besoin des au­to­ri­sa­tions ap­pro­priées. Dans le Developer Portal, vous pouvez définir pré­ci­sé­ment les droits qui lui sont accordés. Pour un simple bot Discord avec n8n et l’IA, les au­to­ri­sa­tions suivantes suffisent gé­né­ra­le­ment au début :

• Lire les messages
• Envoyer des messages
• Lire l’his­to­rique des messages
• Intégrer des liens
• Envoyer des pièces jointes

Selon le cas d’usage, d’autres au­to­ri­sa­tions peuvent être né­ces­saires, par exemple pour la mo­dé­ra­tion, la gestion des rôles ou les in­te­rac­tions avec les canaux. Pour les débutants, il est re­com­mandé de n’activer que les droits réel­le­ment né­ces­saires. Cette approche permet de conserver une con­fi­gu­ra­tion claire tout en ren­for­çant la sécurité.

Close

Étape 4 : inviter le bot sur le serveur Discord

À l’étape suivante, créez un lien d’in­vi­ta­tion pour votre bot Discord avec n8n afin de pouvoir l’ajouter à votre serveur Discord. Pour cela, accédez à la section « OAuth2 » du Discord Developer Portal et ouvrez « OAuth2 URL Generator ».

Dans « Scopes », activez au minimum l’option « bot ». Si vous souhaitez utiliser des slash commands, ajoutez aussi « ap­pli­ca­tions.commands ». Sé­lec­tion­nez ensuite les au­to­ri­sa­tions dont votre bot aura besoin, par exemple pour lire et envoyer des messages. Discord génère alors au­to­ma­ti­que­ment une URL. Ouvrez ce lien, sé­lec­tion­nez votre serveur de test et confirmez l’in­vi­ta­tion.

Close

Le bot apparaît alors sur votre serveur. S’il ne réagit pas encore aux messages, c’est tout à fait normal : vous con­fi­gu­re­rez sa logique et ses fonc­tion­na­li­tés dans n8n à l’étape suivante.

Étape 5 : créer un Webhook Discord

Pour de nombreux workflows, un Webhook constitue le moyen le plus simple d’envoyer des messages de n8n vers Discord. Les Webhooks sont toutefois un canal uni­que­ment sortant. Pour créer un bot Discord avec n8n capable de réagir aux actions des uti­li­sa­teurs, par exemple aux slash commands, un Webhook seul ne suffit donc pas. Vous avez également besoin des in­te­rac­tions, qui sont con­fi­gu­rées à l’étape 7.

Ouvrez dans Discord les pa­ra­mètres du canal texte souhaité et accédez aux in­té­gra­tions. Vous pouvez alors créer un nouveau Webhook. Donnez-lui un nom, sé­lec­tion­nez le canal et copiez l’URL du Webhook. Vous in­di­que­rez ensuite cette URL dans n8n. Votre workflow pourra ainsi envoyer au­to­ma­ti­que­ment des messages à Discord sans que vous ayez à pro­gram­mer vous-même toute la logique du bot.

Close

Étape 6 : ouvrir n8n et créer un nouveau workflow

Ouvrez votre instance n8n et créez un nouveau workflow. Donnez-lui un nom explicite. Con­trai­re­ment à une simple au­to­ma­ti­sa­tion, un véritable bot Discord avec n8n ne se limite pas à envoyer des messages. Votre workflow doit en plus pouvoir recevoir les requêtes entrantes de Discord et y répondre.

Une structure typique se compose de trois parties :

• Entrée (Discord → n8n)
• Trai­te­ment (IA)
• Sortie (n8n → Discord)

Étape 7 : établir la connexion entre Discord et n8n (In­te­rac­tions)

Con­trai­re­ment aux Webhooks, qui servent uni­que­ment aux messages sortants, les in­te­rac­tions per­met­tent de trans­mettre des données de Discord à votre workflow. Il s’agit de requêtes struc­tu­rées, dé­clen­chées par exemple via des slash commands. Chaque fois qu’un uti­li­sa­teur exécute une telle commande dans Discord, une requête est envoyée à une URL que vous avez définie. Cette URL est ensuite fournie par n8n.

Créez d’abord un nœud Webhook dans votre workflow. Ce nœud sert de point d’entrée pour les requêtes provenant de Discord. Ouvrez ses pa­ra­mètres, sé­lec­tion­nez la méthode POST et attribuez-lui un chemin, par exemple discord-interaction.

Une fois ces pa­ra­mètres en­re­gis­trés, n8n génère au­to­ma­ti­que­ment une URL de Webhook. Deux variantes sont proposées dans l’interface : une URL de test et une URL de pro­duc­tion. L’URL de test convient seulement aux essais ponctuels dans l’éditeur. Pour utiliser votre bot Discord avec n8n, vous avez besoin de l’URL de pro­duc­tion, car celle-ci reste ac­ces­sible lorsque le workflow est activé.

À l’étape suivante, vous devez en­re­gis­trer cette URL dans Discord. Ouvrez pour cela le Discord Developer Portal et sé­lec­tion­nez l’ap­pli­ca­tion créée pré­cé­dem­ment. Dans la section « General In­for­ma­tion », vous trouverez le champ « In­te­rac­tions Endpoint URL ». Saisissez-y l’URL de pro­duc­tion générée par n8n, puis en­re­gis­trez les mo­di­fi­ca­tions.

Comment vérifier la signature et le ping de vé­ri­fi­ca­tion ?

Pour que Discord accepte et utilise du­ra­ble­ment votre URL du point de ter­mi­nai­son des in­te­rac­tions, votre Endpoint doit répondre à deux exigences es­sen­tielles :

1. Répondre au ping de vé­ri­fi­ca­tion : lors de la con­fi­gu­ra­tion, Discord envoie au­to­ma­ti­que­ment une requête de test avec le contenu suivant.

{
"type": 1
}

Votre Endpoint doit répondre à cette requête sans mo­di­fi­ca­tion par une réponse de type Pong. Celle-ci indique que votre Endpoint est joignable. La réponse suivante doit donc être envoyée :

{
    "type": 1
}

2. Effectuer la vé­ri­fi­ca­tion de signature : en com­plé­ment, Discord contrôle chaque requête entrante à l’aide des en-têtes de sécurité X-Signature-Ed25519 et X-Signature-Timestamp. Cette signature permet de vérifier que la requête a bien été signée par Discord et qu’elle n’a pas été modifiée. Pour les ap­pli­ca­tions en pro­duc­tion, cette vé­ri­fi­ca­tion est obli­ga­toire.

Quelle solution de con­tour­ne­ment utiliser ty­pi­que­ment en en­vi­ron­ne­ment de pro­duc­tion ?

En pratique, l’ar­chi­tec­ture suivante est souvent utilisée :

Discord → Middleware (vérification de la signature) → Webhook n8n

Le midd­le­ware peut par exemple être im­plé­menté comme un petit service autonome, sous la forme d’un serveur Node.js, d’une fonction ser­ver­less (par exemple avec Cloud­flare Workers) ou comme partie in­té­grante d’un service backend existant. L’important n’est pas la tech­no­lo­gie utilisée, mais le rôle joué par cette couche in­ter­mé­diaire.

Ce composant se situe lo­gi­que­ment entre Discord et votre instance n8n et remplit plusieurs fonctions es­sen­tielles. Il vérifie d’abord chaque requête entrante à l’aide de la signature transmise afin de s’assurer que les données pro­vien­nent bien de Discord et n’ont pas été altérées. Il répond également cor­rec­te­ment à la requête de ping envoyée par Discord, né­ces­saire à la vé­ri­fi­ca­tion de l’Endpoint.

Ce n’est qu’une fois ces vé­ri­fi­ca­tions ef­fec­tuées avec succès que le midd­le­ware transmet la requête au véritable Webhook n8n. De cette façon, votre workflow n8n ne reçoit que des données validées et fiables et peut pour­suivre le trai­te­ment comme prévu.

La connexion est désormais établie : chaque fois qu’un uti­li­sa­teur exécute une commande Slash, Discord envoie au­to­ma­ti­que­ment les données cor­res­pon­dantes à votre workflow n8n, qui est alors déclenché.

Étape 8 : créer une commande Slash pour le bot

Pour que les uti­li­sa­teurs puissent dé­clen­cher votre bot di­rec­te­ment dans le chat, vous avez besoin d’une commande Slash. Ces « Ap­pli­ca­tion Commands » sont créées via l’API Discord.

Avant de créer la commande Slash, vous avez besoin de deux valeurs im­por­tantes provenant du Discord Developer Portal :

• Ap­pli­ca­tion ID : vous la trouvez dans la section « General In­for­ma­tion » de votre ap­pli­ca­tion.
• Bot-Token : celui-ci se trouve dans la section « Bot ». Traitez ce token de manière con­fi­den­tielle, car il permet d’accéder à votre bot.

La commande elle-même est créée via une requête HTTP vers l’API Discord. Vous pouvez exécuter cette requête soit depuis un terminal, soit di­rec­te­ment avec un outil comme n8n. Un exemple avec curl ressemble à ceci :

curl -X POST https://discord.com/api/v10/applications/VOTRE_APPLICATION_ID/commands \
-H "Authorization: Bot VOTRE_BOT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "name": "ask",
    "description": "Posez une question au bot",
    "options": [
        {
            "name": "question",
            "description": "Votre question",
            "type": 3,
            "required": true
        }
    ]
}'

Remplacez au passage  :

• VOTRE_APPLICATION_ID par votre véritable Ap­pli­ca­tion ID
• VOTRE_BOT_TOKEN par votre Bot-Token Cette requête crée une nouvelle commande Slash nommée /ask. En com­plé­ment, une option de saisie appelée « question » est définie, via laquelle les uti­li­sa­teurs peuvent trans­mettre un message au bot.

Une fois la requête exécutée avec succès, la nouvelle commande est dis­po­nible. Ouvrez votre serveur Discord et cliquez dans un champ de saisie de texte. Saisissez /. Votre nouvelle commande devrait alors ap­pa­raître au­to­ma­ti­que­ment dans la liste de sug­ges­tions.

Étape 9 : traiter les données entrantes depuis Discord

Dès qu’une commande Slash est exécutée, Discord envoie une requête struc­tu­rée à votre Webhook. Pour traiter les in­for­ma­tions qu’elle contient, ajoutez un nœud Set après le Webhook. Vous y extrayez les données per­ti­nentes, en par­ti­cu­lier le nom d’uti­li­sa­teur et le message saisi, à l’aide d’ex­pres­sions JSON.

Exemple :

{
"username": "{{$json.member.user.username}}",
"message": "{{$json.data.options[0].value}}"
}

Les in­for­ma­tions les plus im­por­tantes sont ainsi à votre dis­po­si­tion sous une forme claire et struc­tu­rée.

Close

Étape 10 : trans­mettre le message à un modèle d’IA

À l’étape suivante, vous connectez votre workflow à un grand modèle de langage (LLM). Dans n8n, vous pouvez pour cela utiliser le nœud OpenAI ou appeler di­rec­te­ment une API avec un nœud HTTP Request. Le nœud OpenAI actuel de n8n prend en charge l’API OpenAI Responses. Pour les débutants, le nœud OpenAI constitue gé­né­ra­le­ment la solution la plus simple.

Si vous utilisez ce nœud pour la première fois, vous devez d’abord ren­seig­ner vos iden­ti­fiants. Cliquez sur « Cre­den­tials » dans le nœud, puis sé­lec­tion­nez « Create New Cre­den­tial ». Saisissez votre clé API et en­re­gis­trez les iden­ti­fiants.

Con­fi­gu­rez ensuite le nœud pour trans­mettre au modèle le message reçu sur Discord. Choi­sis­sez une opération de type texte ou message et saisissez un prompt qui définit le cadre souhaité pour la réponse de l’IA. Un modèle simple peut par exemple être :

Vous êtes un assistant sur un serveur Discord.
Répondez de manière aimable et compréhensible en cinq phrases maximum.
Utilisateur : {{$json.username}}
Message : {{$json.message}}

Veillez à ne pas saisir ma­nuel­le­ment les valeurs username et message, mais à les reprendre sous forme d’ex­pres­sions depuis le nœud précédent.

Étape 11 : préparer la réponse pour Discord

La réponse d’un nœud d’IA dans n8n ne se compose souvent pas uni­que­ment de texte brut, mais aussi de données de structure et de mé­ta­don­nées. Pour que Discord ne reçoive ensuite que la réponse pro­pre­ment dite, vous préparez le résultat dans une étape sup­plé­men­taire. Ajoutez de nouveau un nœud Set après le nœud d’IA. Créez-y un nouveau champ nommé reply. Dans ce champ, reprenez le texte de réponse issu du résultat du nœud d’IA.

Un exemple typique ressemble à ceci :

{
"reply": "{{$json.output[0].content[0].text}}"
}

Si votre sortie est struc­tu­rée dif­fé­rem­ment, vous pouvez le vérifier fa­ci­le­ment en con­sul­tant l’output du nœud OpenAI après un test. Vous voyez alors pré­ci­sé­ment où se trouve le texte généré par l’IA.

De plus, vous pouvez formater la sortie, par exemple en lui ajoutant un préfixe. La réponse brute de l’IA peut ainsi être trans­for­mée en un message Discord plus clair et plus agréable à lire :

{
"reply": "**Bot IA :** {{$json.reply}}"
}

Étape 12 : renvoyer di­rec­te­ment la réponse à Discord

Cette étape est par­ti­cu­liè­re­ment im­por­tante, car Discord n’attend pas une réponse Webhook classique pour les in­te­rac­tions. Votre Endpoint doit au contraire répondre à la slash command avec une réponse d’in­te­rac­tion valide.

Dans n8n, vous pouvez con­fi­gu­rer le nœud Webhook pour qu’il attende la fin du workflow avant de renvoyer le résultat de la dernière étape. Il ne répond ainsi pas im­mé­dia­te­ment, mais seulement une fois que le dernier nœud a été exécuté.

Cliquez de nouveau sur le nœud Webhook au début du workflow. Re­cher­chez la section « Respond ». Ne sé­lec­tion­nez pas la réponse immédiate, mais l’option « When Last Node Finishes ».

Close

Vous trouverez ensuite le paramètre per­met­tant de définir les données de réponse. Sé­lec­tion­nez « First Entry JSON » afin que n8n renvoie l’objet JSON issu du dernier nœud.

Pour que Discord accepte cette réponse, votre dernier nœud doit renvoyer un objet JSON qui ressemble à ceci :

{
"type": 4,
"data": {
"content": "{{$json.reply}}"
}
}

Con­crè­te­ment, ajoutez un nœud Set sup­plé­men­taire après votre nœud Reply existant. Dans ce dernier nœud, dé­fi­nis­sez les champs afin d’obtenir exac­te­ment cette structure. Un champ type reçoit la valeur 4. Un autre champ data contient le sous-champ content, dans lequel vous insérez la réponse générée par l’IA.

Close

Étape 13 : tester le workflow en détail

Avant d’utiliser le bot de manière per­ma­nente, testez soig­neu­se­ment l’ensemble du processus. Commencez par activer le workflow, car les URL de Webhook de pro­duc­tion ne fonc­tion­nent dans n8n que lorsque le workflow est actif. n8n distingue par ailleurs clai­re­ment les URL de test et de pro­duc­tion. Pour Discord, utilisez l’URL de pro­duc­tion.

Accédez ensuite à votre serveur Discord et saisissez la slash command, par exemple :

/ask question : Qu’est-ce que n8n ?

Dès que vous envoyez la commande, Discord doit trans­mettre la requête à votre In­te­rac­tions Endpoint. Ouvrez ensuite dans n8n la liste des exé­cu­tions. Vous pouvez y cliquer sur chaque étape in­di­vi­duel­le­ment et vérifier quelles données sont arrivées et comment elles ont été traitées. Si tout fonc­tionne cor­rec­te­ment, une réponse est envoyée dans Discord.

Quels sont les exemples d’uti­li­sa­tion pratiques de bots Discord avec n8n et l’IA ?

Avec n8n, vous pouvez non seulement créer un simple bot de réponse, mais aussi au­to­ma­ti­ser dif­fé­rents workflows Discord. Les exemples suivants pré­sen­tent trois cas d’uti­li­sa­tion concrets, faciles à mettre en œuvre même pour les débutants.

Exemple 1 : créer un bot FAQ pour les questions de la com­mu­nauté

Un bot FAQ répond au­to­ma­ti­que­ment aux questions ré­cur­rentes. Cette solution est par­ti­cu­liè­re­ment utile lorsque les membres d’un serveur posent ré­gu­liè­re­ment des questions si­mi­laires sur des produits, des règles, des horaires d’ouverture ou des pro­cé­dures. L’IA peut in­ter­pré­ter une question entrante et générer une réponse concise et con­vi­viale. Vous pouvez également récupérer des in­for­ma­tions pré­dé­fi­nies à partir d’un tableau, d’une base de données ou d’un document interne. Les uti­li­sa­teurs ob­tien­nent ainsi plus ra­pi­de­ment les in­for­ma­tions re­cher­chées, sans que les mo­dé­ra­teurs aient à répondre ma­nuel­le­ment à chaque question. Sur les serveurs de support ou de com­mu­nauté, cela peut re­pré­sen­ter un gain de temps important.

Close

Exemple 2 : utiliser un bot Discord avec n8n pour la mo­dé­ra­tion

Un bot de mo­dé­ra­tion peut analyser les nouveaux messages et détecter ra­pi­de­ment les contenus pro­blé­ma­tiques. L’IA peut notamment vérifier si un message contient des insultes, ressemble à du spam ou est hors sujet. Dans n8n, vous pouvez ensuite définir des règles précisant les actions à effectuer selon le résultat de l’analyse. Le bot peut par exemple avertir l’équipe de mo­dé­ra­tion ou trans­fé­rer un message vers un canal dédié à la vé­ri­fi­ca­tion.

Un tel bot ne remplace pas la mo­dé­ra­tion humaine, mais il peut aider à trier les contenus plus ra­pi­de­ment. Dans les grandes com­mu­nau­tés, cette au­to­ma­ti­sa­tion peut ainsi réduire con­si­dé­ra­ble­ment la charge de travail de l’équipe de mo­dé­ra­tion.

Close

Exemple 3 : créer un bot de synthèse pour les longues dis­cus­sions

Sur les serveurs Discord actifs, les in­for­ma­tions im­por­tantes peuvent ra­pi­de­ment se perdre au milieu de nombreux messages. Un bot de synthèse peut, à in­ter­valles réguliers ou sur demande, regrouper plusieurs messages et générer un bref ré­ca­pi­tu­la­tif. Cette fonction convient notamment aux serveurs de projet, aux com­mu­nau­tés d’ap­pren­tis­sage ou aux canaux d’équipe internes.

n8n collecte les messages per­ti­nents, les transmet à l’IA, puis publie le résumé dans un canal défini. Les par­ti­ci­pants n’ont ainsi pas besoin de relire l’in­té­gra­lité d’une con­ver­sa­tion pour connaître les prin­ci­paux points abordés. La vi­si­bi­lité s’en trouve améliorée et les uti­li­sa­teurs gagnent du temps.

Close