Aller au contenu

Guide pas à pas pour intégrer votre Agent Quickchat AI à Discord. Créez un bot, configurez les permissions et passez en production sur votre serveur.

Dans ce guide, nous allons voir comment intégrer votre Assistant IA à votre serveur Discord. Voici l’aperçu des étapes :

  1. Créer un serveur Discord
  2. Créer une application Discord
  3. Configurer votre application Discord
  4. Ajouter le bot à votre serveur Discord
  5. Intégrer votre bot Discord avec Quickchat AI
Play

Pour commencer l’intégration, vous avez besoin d’un serveur Discord. Si vous n’avez pas de compte, rendez‑vous sur discord.com pour en créer un. Une fois connecté, suivez ce guide pour créer votre serveur Discord.

Accédez à discord.com/developers/applications tout en étant connecté à votre compte Discord et créez une nouvelle application.

Avant d’ajouter votre bot au serveur, activez le Message Content Intent pour votre application. Cela permet à votre bot de lire les messages envoyés par les utilisateurs sur votre serveur.

Interface Quickchat AI

Vous devez maintenant ajouter votre bot à votre serveur. Pour ce faire, construisez l’URL suivante et collez‑la dans votre navigateur :

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

D’où vient le numéro des permissions ?

Le numéro de permissions (309237712896) correspond aux autorisations suivantes :

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

Il s’agit du minimum requis pour que votre bot fonctionne correctement. Vous pouvez le vérifier en allant sur discord.com/developers/applications, en sélectionnant votre application, en cliquant sur Bot à gauche puis en faisant défiler :

Permissions de votre bot

Où trouver VOTRE CLIENT ID ?

Le plus simple est de regarder la barre d’adresse de votre navigateur et de copier le long numéro qui fait partie de l’URL :

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

Votre client ID

Dans cet exemple, le client id est 1234567890123456789, ce qui signifie que l’URL complète pour ajouter le bot sera :

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

Pour connecter votre bot à Quickchat AI, récupérez votre Discord Bot Token depuis le Developer Portal.

  1. Allez dans Bot SettingsReset TokenCopy Token

Réinitialiser le token

  1. Dans le Tableau de bord Quickchat AI, rendez‑vous dans External Applications, ouvrez l’intégration Discord, activez Activer Discord et collez votre token.

Coller le token

Retournez sur Discord – votre bot devrait être en ligne et prêt à discuter ! @mentionnez‑le pour démarrer une conversation. 🤖💬

Bot actif

Par défaut, lorsqu’il est @mentionné, le bot répond dans le même canal. Vous pouvez modifier ce comportement avec le réglage Mode de réponse de l’intégration : Répondre dans le canal (par défaut) ou Répondre dans les fils de discussion. Avec Répondre dans les fils de discussion, le bot répond dans un fil et les utilisateurs peuvent y poursuivre la conversation sans le mentionner à nouveau.

Conversation dans un fil

”Integration requires code grant” lors de l’ajout du bot

Section intitulée « ”Integration requires code grant” lors de l’ajout du bot »

Votre application a Require OAuth2 Code Grant activé, ce qui bloque le flux d’invitation simple du bot. Dans le Developer Portal, ouvrez votre application, allez dans Bot, désactivez Require OAuth2 Code Grant, enregistrez puis rouvrez l’URL d’invitation.

La page d’autorisation affiche un gâteau ou un message “baked”

Section intitulée « La page d’autorisation affiche un gâteau ou un message “baked” »

Cet écran insolite est la page de succès de Discord : le bot a bien été ajouté. Pour le confirmer, ouvrez Paramètres du serveur → Intégrations → Bots et applications et cherchez votre bot dans la liste.

Le bot est dans le serveur mais apparaît hors ligne

Section intitulée « Le bot est dans le serveur mais apparaît hors ligne »
  1. Dans le tableau de bord Quickchat AI, ouvrez External Apps → Discord et vérifiez l’état de la connexion. Un token invalide ou un intent manquant y est signalé avec des instructions.
  2. Les tokens de bot ne s’affichent qu’une seule fois. En cas de doute, cliquez sur Reset Token dans le Developer Portal, copiez le nouveau token et collez-le à nouveau dans Quickchat.
  3. Vérifiez que Message Content Intent est activé dans Bot → Privileged Gateway Intents.
  4. Patientez jusqu’à une minute après l’enregistrement : le bot redémarre quand ses paramètres changent.

@mentionnez le bot dans un salon auquel il a accès. Vérifiez que ses permissions de rôle et de salon incluent Send Messages, Create Public Threads, Send Messages in Threads et Read Message History. Le mode de réponse (salon ou fils) se configure dans Quickchat sous External Apps → Discord.


Rejoignez notre serveur Discord pour en savoir plus sur la meilleure façon de tirer parti de Quickchat AI 👉 discord.gg/KqkHwvPRNH