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

Si Quickchat AI signale une erreur sur la page d’intégration Discord, il renvoie directement vers la section correspondante ci-dessous.

PrivilegedIntentsRequired : votre bot s’est connecté, mais son Message Content Intent est désactivé, il ne peut donc pas lire les messages. Dans le Developer Portal, ouvrez votre application, allez dans Bot → Privileged Gateway Intents, activez Message Content Intent et enregistrez. Le bot redémarre automatiquement, comptez environ une minute.

Activer Message Content Intent

InvalidToken : le token dont dispose Quickchat AI est incorrect ou a été régénéré. Un token de bot ne s’affiche qu’une seule fois, et le réinitialiser invalide l’ancien. Dans le Developer Portal, ouvrez votre application, allez dans Bot, cliquez sur Reset Token, copiez le nouveau token, puis cliquez sur Reconnect dans Quickchat AI et collez-le.

Réinitialiser le token du bot

Si “Integration requires code grant” apparaît 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 redémarre dès que vous changez son token ou ses paramètres, patientez donc jusqu’à une minute après l’enregistrement. S’il ne se met toujours pas en ligne ou ne répond pas :

  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 un lien vers la correction exacte.
  2. Vérifiez que Message Content Intent est activé (voir ci-dessus) et que le token est à jour (utilisez Reset Token en cas de doute).
  3. @mentionnez le bot dans un salon auquel il a accès, et 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.
  4. Choisissez s’il répond dans le salon ou dans un fil avec le paramètre Mode de réponse 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

Dernière mise à jour :