Image de fond de l’article 9

Lancez votre chatbot IA sur Discord

Vous voulez créer un bot intelligent d’IA conversationnelle pour votre serveur Discord ? Ce guide étape par étape vous accompagne en 10 minutes seulement, sans aucune programmation !

Regardez la vidéo


5 étapes simples pour créer votre bot IA

Suivez ces étapes pour obtenir un chatbot IA entièrement fonctionnel sur votre serveur Discord :

  1. Créez un serveur Discord
  2. Créez une application Discord
  3. Ajoutez le bot à votre serveur
  4. Créez un compte Quickchat AI
  5. Intégrez votre bot Discord à Quickchat AI

À quoi ressemblera votre bot IA

Une fois configuré, votre bot sera en ligne sur Discord, prêt à tenir des conversations naturelles avec les membres de votre serveur.

Résultat attendu : une IA conversationnelle intelligente


Le plus rapide : l’installation en un clic

Si vous avez déjà un compte Quickchat AI, vous pouvez vous passer complètement du Developer Portal. Dans le tableau de bord, ouvrez External Apps dans la barre latérale gauche, sélectionnez Discord, puis, sous Connect, cliquez sur Add to your Discord server.

Écran de connexion Discord dans Quickchat AI avec le bouton Add to your Discord server L’écran de connexion en un clic dans External Apps → Discord.

Discord vous demande d’autoriser l’application partagée Quickchat AI et de choisir un serveur. Cliquez sur Authorize : le bot est en ligne et les membres peuvent le mentionner avec @ dans n’importe quel salon. La seule condition est de disposer de la permission Gérer le serveur sur le serveur choisi.

Les nouveaux inscrits à Quickchat AI arrivent sur une configuration aux couleurs de Discord qui les conduit directement à ce parcours.

Écran d’accueil aux couleurs de Discord présenté aux nouveaux inscrits à Quickchat AI Les nouveaux inscrits commencent sur un écran aux couleurs de Discord qui mène à la connexion en un clic.

Les étapes ci-dessous présentent l’alternative manuelle, l’option Use your own Discord app : vous créez votre propre application Discord et la connectez avec un token de bot. Choisissez cette méthode pour personnaliser le nom et l’avatar du bot, utiliser les messages privés ou les Discord AI Actions, ou installer plusieurs bots sur un serveur. Les Discord Actions nécessitent la connexion de votre propre bot, car elle fournit le token utilisé pour les requêtes à l’API Discord.


1. Créez un serveur Discord

Si vous n’avez pas de compte Discord, créez-en un sur discord.com. Configurez ensuite votre premier serveur :

Créez votre premier serveur


2. Créez une application Discord

Rendez-vous sur le Discord Developer Portal et créez une application.

Créez une application


3. Ajoutez votre bot au serveur Discord

Pensez à autoriser votre bot à recevoir le contenu des messages en activant l’option ci-dessous :

Activez l’accès au contenu des messages

Une fois le bot créé, vous devez l’ajouter à votre serveur. Pour cela, construisez une URL Discord et collez-la dans votre navigateur :

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

D’où vient le nombre de permissions ?

Le nombre de permissions (309237713920) correspond à la demande des permissions suivantes :

  • View Channels
  • Send Messages
  • Create Public Threads
  • Send Messages in Threads
  • Read Message History

Il s’agit de l’ensemble minimal de permissions nécessaire au bon fonctionnement de votre bot. Vous pouvez le vérifier sur discord.com/developers/applications : sélectionnez votre application, cliquez sur Bot à gauche et faites défiler la page :

Permissions de votre bot Discord

Où trouver YOUR CLIENT ID ?

Le plus simple est de regarder la barre d’adresse du navigateur et de copier le long nombre présent dans l’URL :

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

Votre client ID

Ici, le client ID est 1234567890123456789. L’URL complète à ouvrir pour ajouter le bot au serveur est donc :

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

En cas de problème à cette étape :

  • « Integration requires code grant » : l’option Require OAuth2 Code Grant est activée pour votre application. Dans le Developer Portal, ouvrez votre application, allez dans Bot, désactivez cette option, enregistrez, puis rouvrez l’URL d’invitation. (détails)
  • Un écran avec un gâteau / « baked » apparaît : c’est la page de confirmation de Discord, votre bot a bien été ajouté. Vérifiez dans Paramètres du serveur → Intégrations → Bots et applications.
  • Conseil : une fois le token du bot collé dans le tableau de bord Quickchat AI (étape 5), la page d’intégration Discord génère cette URL d’invitation et affiche une liste de vérification. Vous pouvez donc éviter de construire l’URL manuellement.

4. Créez un compte Quickchat AI

Inscrivez-vous à Quickchat AI pour doter votre bot d’une IA conversationnelle aux échanges naturels.

Quickchat AI permet de créer des agents IA avec des bases de connaissances personnalisées, des AI Actions et bien plus, parfaits pour les bots Discord, les sites web et d’autres canaux.


5. Intégrez votre bot à Quickchat AI

Pour connecter votre bot à Quickchat AI, récupérez votre token de bot Discord dans le Developer Portal.

  1. Allez dans Bot SettingsReset TokenCopy Token

Réinitialisez le token

  1. Dans le tableau de bord Quickchat AI, ouvrez External Apps → Discord, choisissez Use your own Discord app et collez votre token. Quickchat AI démarre le bot et indique son état pendant le démarrage.

Collez le token

Si le bot ne passe pas en ligne

Lorsqu’un bot ne démarre pas, la page d’intégration Discord affiche l’erreur exacte et un lien direct vers la solution. Les deux cas les plus fréquents sont :

  • Token invalide : le token est incorrect ou a été régénéré (réinitialiser un token invalide l’ancien). Ouvrez votre bot dans le Developer Portal, allez dans Bot → Reset Token, copiez le nouveau token, puis cliquez sur Reconnect dans Quickchat AI et collez-le. Consultez Token de bot invalide pour voir la capture correspondante.
  • Message Content Intent est désactivé (signalé par PrivilegedIntentsRequired) : le bot est connecté mais ne peut pas lire les messages. Ouvrez votre bot dans le Developer Portal, allez dans Bot → Privileged Gateway Intents, activez Message Content Intent, puis enregistrez. Consultez Message Content Intent pour repérer l’option exacte.

Le bot redémarre dès que vous modifiez son token ou ses paramètres. Laissez-lui jusqu’à une minute pour passer en ligne.

Si votre propre bot est en ligne mais ne répond jamais

Vérifiez si le bot partagé Quickchat AI, installé en un clic, se trouve encore sur le même serveur. Lorsque les deux bots sont présents, le bot partagé répond et le vôtre reste silencieux, même si son token, ses intents et ses permissions sont corrects. Ouvrez External Apps dans le tableau de bord Quickchat AI, trouvez le serveur sous Connected servers dans la configuration en un clic et retirez-le à cet endroit. Votre propre bot prend immédiatement le relais. Consultez Les deux bots sont sur le même serveur.


Votre bot IA est en ligne !

Retournez sur Discord. Votre bot devrait être en ligne et prêt à discuter ! Il suffit de le mentionner avec @ pour lancer une conversation.

Bot actif

Lorsqu’il est mentionné avec @, le bot répond par défaut dans le salon. Si vous choisissez Thread dans le paramètre Reply in, il crée un fil où les utilisateurs peuvent poursuivre la conversation sans le mentionner.

Conversation dans un fil


Comment le bot répond

Le bot peut être déclenché de plusieurs façons, avec un comportement différent pour l’historique des conversations :

SituationDéclenchementHistorique des conversations
@mention dans un salonMentionnez le bot avec @ dans un salon textuelDépend du paramètre Reply in (voir ci-dessous)
Message dans un fil du botEnvoyez un message dans un fil créé par le botL’historique complet du fil est conservé
Réponse à un message du botUtilisez la fonction Répondre de Discord sur un message du botLance une nouvelle conversation à chaque fois
Commande slash /askTapez /ask et votre question (bot en un clic uniquement)Lance une nouvelle conversation à chaque fois
Message privéEnvoyez un MP au bot (application personnelle uniquement)Conservé pendant toute la session de messages privés

Un simple message dans un salon ne déclenche rien. C’est volontaire, pour que le bot reste silencieux sur un serveur animé, et c’est la raison la plus fréquente pour laquelle un bot récemment ajouté semble en panne. /ask sert notamment d’alternative plus facile à découvrir : taper / dans n’importe quel salon l’affiche, et la commande fonctionne lorsque l’accès au contenu des messages est restreint. Elle est enregistrée sur le bot partagé en un clic. Si vous connectez votre propre application, il faut donc utiliser les @mentions.

Le paramètre « Reply in »

Dans le tableau de bord Quickchat, sous Channels > External Apps > Discord, le menu déroulant « Reply in: » propose deux options :

  • Channel (par défaut) : le bot répond directement dans le salon où il a été mentionné. Chaque @mention démarre une nouvelle conversation sans mémoire des interactions précédentes.
  • Thread : le bot crée un nouveau fil pour chaque @mention. Le fil porte le nom du bot et de l’utilisateur (par exemple, « Aria & john_doe »). À l’intérieur, le bot répond à chaque message sans exiger de @mention et l’historique complet de la conversation est conservé.

Messages privés

Les MP nécessitent votre propre application Discord. Le bot partagé en un clic répond uniquement sur les serveurs, car répondre à des MP non sollicités avec une identité partagée affecterait tous les serveurs qu’il dessert.

Avec votre propre application, aucune @mention n’est nécessaire en MP. Le bot répond à chaque message et l’historique persiste pendant toute la session. Il n’a pas accès à l’historique des salons du serveur lorsqu’il répond en MP.

Remarque : le bot répond uniquement dans les fils qu’il a lui-même créés. Si quelqu’un crée un fil manuellement et y écrit, le bot ne répond pas.


Comment le bot comprend le contexte du salon

Lorsque quelqu’un @mentionne le bot dans un salon, celui-ci ne voit pas seulement le message qui le mentionne. Il récupère automatiquement les messages récents du salon et les inclut dans le prompt de l’IA sous forme de transcription horodatée. Le bot comprend ainsi la conversation en cours et peut faire référence aux échanges précédents.

Voici à quoi ressemble ce contexte du point de vue de l’IA :

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

Le bot lit aussi les messages des fils actifs et archivés du salon, afin d’inclure leurs discussions dans le contexte.

Lorsque quelqu’un utilise la fonction Répondre de Discord pour répondre à un message précis, le bot limite son contexte aux messages situés immédiatement autour du message concerné, au lieu de récupérer tout l’historique récent. Cela fournit un contexte ciblé pour la conversation à laquelle l’utilisateur fait référence.

Les contenus particuliers des messages (stickers, GIF, images, embeds, réactions) sont représentés par des annotations. Le bot sait ainsi qu’ils sont présents, même s’il ne les voit pas dans la transcription du contexte. Les tokens de @mention sont remplacés par des noms d’affichage lisibles.

Aucune configuration n’est nécessaire. Le contexte du salon est activé par défaut pour tous les bots Quickchat AI sur Discord.

Le bot utilise le contexte du salon pour répondre à une question complémentaire

Recherche intelligente par IA dans l’historique du serveur

Par défaut, le bot ne lit que les messages du salon où il a été mentionné. Avec Smart AI search over server history activé, l’IA peut consulter les messages de n’importe quel salon textuel du serveur. Elle choisit le salon à consulter en fonction de la question de l’utilisateur.

Par exemple, si quelqu’un demande dans #general « quelle était la conclusion dans #engineering au sujet de la migration ? », le bot peut lire l’historique récent de #engineering et répondre à partir de ce qu’il y trouve.

La fonction prend aussi en charge le filtrage par période et la pagination, afin que l’IA puisse remonter plus loin dans l’historique si nécessaire.

ModePérimètreIdéal pour
Par défautSalon actuel uniquementBot de communauté généraliste
Smart AI search over server historyN’importe quel salon du serveurBots d’assistance et recherche de connaissances entre salons

Remarque : Smart AI search over server history est actuellement en bêta. Si cette fonction vous intéresse, contactez-nous par e-mail ou sur le serveur Discord de Quickchat.

Option Smart AI search over server history dans les paramètres d’intégration Discord


Envoyer des images au bot

Les utilisateurs peuvent joindre une image lorsqu’ils @mentionnent le bot, et l’IA la traite avec ses capacités de vision. Les formats acceptés sont PNG, JPG, JPEG, GIF et WebP. Si plusieurs images sont jointes, le bot traite la première.

L’URL de l’image sur le CDN de Discord est transmise au modèle d’IA avec le texte du message comme entrée multimodale. L’IA voit donc le texte et l’image au même tour. Aucune configuration n’est nécessaire : la compréhension des images est activée par défaut.

Quelques exemples pratiques pour les communautés Discord :

  • Communauté de développeurs : un utilisateur capture une trace d’erreur ou un message d’erreur et demande au bot de l’expliquer.
  • Communauté de design : un utilisateur partage une maquette d’interface et demande l’avis du bot.
  • Communauté de joueurs : un utilisateur partage une capture des paramètres d’un jeu et demande des conseils d’optimisation.
  • Assistance e-commerce : un client envoie une photo d’un produit défectueux au bot d’assistance.

Un utilisateur envoie une capture au bot, qui analyse l’image pour répondre à sa question


Connecter des AI Actions à Discord

Les AI Actions permettent au bot d’appeler des API et des outils externes pendant une conversation Discord. Elles se configurent une fois dans le tableau de bord Quickchat, sous AI Agent > Actions & MCPs, puis fonctionnent sur tous les canaux (Discord, widget de site web, WhatsApp, Telegram, etc.).

Deux types d’actions sont disponibles :

Type d’actionFonctionnement
API ActionEffectue des requêtes HTTP (GET, POST, PUT, DELETE) vers des endpoints externes avec paramètres, en-têtes et corps configurables
Remote MCPSe connecte à un serveur Model Context Protocol pour accéder à des outils et sources de données externes

Voici quelques exemples de ce que vous pouvez créer avec les AI Actions sur Discord :

  • Bot de suivi des commandes : connectez une API Action à votre backend e-commerce pour que les membres demandent « où est ma commande #12345 ? » et reçoivent son statut en temps réel.
  • Bot d’issues GitHub : reliez un Remote MCP à votre dépôt GitHub pour que les développeurs demandent « y a-t-il des bugs ouverts avec le tag critical ? » directement dans Discord.
  • Bot de tickets d’assistance : laissez le bot répondre à partir de votre documentation et ouvrir un fil privé de ticket avec une mention du rôle d’assistance uniquement pour ce qu’il ne peut pas résoudre.
  • Assistant de modération : choisissez les modèles d’exclusion temporaire, d’expulsion, de bannissement et de mode lent pour que les modérateurs les exécutent en langage naturel.
  • Planification de réunions : connectez un Remote MCP à Cal.com ou Google Calendar pour que les utilisateurs réservent des réunions avec votre équipe depuis Discord.
  • Intégration CRM : connectez HubSpot pour que le bot enregistre des prospects ou crée des tickets d’assistance à partir des conversations Discord.
  • Enregistrement des prospects et retours : connectez Google Sheets pour que le bot consigne les prospects, les questions sans réponse et les demandes de démonstration issus de Discord dans une feuille déjà utilisée par votre équipe.

Configurer une API Action

  1. Dans le tableau de bord Quickchat, allez dans AI Agent > Actions & MCPs.
  2. Cliquez sur Add Action. Pour une opération Discord prise en charge, choisissez Discord Action et sélectionnez un modèle. Le modèle d’assistance demande un serveur, un salon et un rôle ; les modèles de modération s’installent directement. Quickchat crée pour vous la requête modifiable, la description, les paramètres, le traitement de la réponse et les conditions d’exécution.
  3. Seulement si vous avez besoin d’un endpoint absent de la galerie, choisissez une action HTTP Request personnalisée. Donnez-lui un nom (par exemple « Consulter le statut de la commande ») et une description indiquant à l’IA quand l’utiliser (par exemple « Utiliser lorsqu’un utilisateur demande le statut de sa commande. Demander d’abord le numéro de commande. »).
  4. Définissez la méthode HTTP (par exemple GET), l’URL de l’endpoint et les paramètres nécessaires, puis enregistrez.

L’action est maintenant disponible pour l’agent sur les canaux compatibles. Les Discord Actions de la galerie sont des actions HTTP Request ordinaires et modifiables : vérifiez donc leur autorisation, leurs cibles et leurs paramètres après modification. Pour un parcours plus détaillé, consultez le tutoriel AI Actions avec HubSpot, le guide du bot de modération Discord (exclusion temporaire, expulsion, bannissement, rôles et mode lent sous forme d’AI Actions) ou la documentation Actions.

Page Actions & MCPs du tableau de bord Quickchat avec une API Action configurée


Pour aller plus loin

Ces guides approfondissent des sujets connexes :


Inscrivez-vous à Quickchat AI pour commencer à créer votre agent IA, ou rejoignez la communauté sur Discord : discord.gg/KqkHwvPRNH