Intégration Discord

Ajoutez votre agent à des serveurs Discord via les slash commands et les messages directs.

Aperçu

L’intégration Discord offre :

Prise en charge des slash commands (/ask)
Conversations par message direct
Disponibilité dans tout le serveur
Réponses spécifiques par canal
Mise en forme par embeds enrichis
DMs en mode texte facultatifs (pas besoin de préfixe de commande)

Prérequis

Un compte Discord
Permission Manage Server sur le serveur cible
Accès au Discord Developer Portal

Étapes de Configuration

1. Créer une Application Discord

Rendez-vous sur le Discord Developer Portal
Cliquez sur New Application
Saisissez un nom (par exemple, « My Support Bot »)
Cliquez sur Create

2. Récupérer vos Identifiants

Depuis le Discord Developer Portal, collectez ces valeurs :

Champ	Description	Où le Trouver
Application ID	L’ID de votre app Discord	Page General Information
Public Key	Chaîne hex de 64 caractères pour la vérification de signature	Page General Information
Bot Token	Token secret de votre bot	Section Bot → Reset Token
Guild ID (facultatif)	ID du serveur pour l’enregistrement instantané des commandes	Clic droit sur le serveur → Copy Server ID

Gardez votre Bot Token en sécurité — ne le partagez jamais publiquement. Toute personne disposant du token peut prendre le contrôle de votre bot.

3. Connecter à Cuneiform Chat

Rendez-vous dans Agents → Sélectionnez votre agent
Allez dans l’onglet Integrations
Cliquez sur Discord
Saisissez vos Application ID, Public Key et Bot Token
Saisissez éventuellement un Guild ID pour l’enregistrement instantané des slash commands
Cliquez sur Connect

4. Configurer la Webhook URL (Obligatoire)

Après la connexion, une boîte de dialogue de succès affiche votre Webhook URL :

Copiez la Webhook URL depuis la boîte de dialogue de succès
Dans le Discord Developer Portal, allez dans General Information
Repérez Interactions Endpoint URL
Collez la webhook URL et cliquez sur Save Changes

Cette étape est obligatoire. Discord utilise cette URL pour envoyer les interactions de slash commands à votre bot.

5. Ajouter le Bot à votre Serveur

Utilisez le bouton Add to Server sur la carte d’intégration, ou utilisez l’URL d’invitation fournie après la connexion. Cela ajoute le bot avec les permissions requises.

Utiliser le Bot

Slash Commands

Les utilisateurs interagissent avec votre bot via le slash command /ask :


/ask Quels sont vos horaires d'ouverture ?

Le bot traite la question et répond dans le canal.

Messages Directs

Envoyez un message au bot directement pour des conversations privées :

Trouvez le bot dans la liste des membres de votre serveur
Faites un clic droit et sélectionnez Message
Utilisez la commande /ask ou activez Text DMs (voir ci-dessous)

Bascule Text DMs

L’interrupteur Text DMs sur la carte d’intégration contrôle le comportement des messages directs :

Off (par défaut) : les utilisateurs doivent utiliser la commande /ask en DMs
On : les utilisateurs peuvent envoyer des messages texte simples en DMs (sans préfixe de commande)

Pour activer Text DMs, vous devrez activer Message Content Intent dans Discord Developer Portal → section Bot → Privileged Gateway Intents.

Format des Réponses

Les réponses apparaissent sous forme d’embeds enrichis avec :

Le texte de la réponse
Les références de sources (facultatif)
Le branding de votre bot

Fonctionnalités

Accès dans Tout le Serveur

Une fois ajouté, le bot est disponible dans tous les canaux texte où il dispose des permissions.

Prise en Charge des Threads

Le bot peut répondre dans les threads, gardant les conversations bien organisées.

Commandes Instantanées vs Globales

Avec Guild ID : les slash commands sont enregistrés instantanément sur ce serveur
Sans Guild ID : les commandes globales prennent jusqu’à 1 heure pour se propager

Fournissez un Guild ID lors de la configuration pour disposer instantanément des slash commands. Vous pourrez ajouter d’autres serveurs plus tard.

Gérer votre Bot

Chaque bot connecté affiche :

Nom d’utilisateur du bot et statut (Active/Error)
Application ID
Agent associé
Horodatage de Last activity
Webhook URL (à titre de référence)

Actions Disponibles

Action	Description
Add to Server	Ouvre le lien d’invitation pour ajouter le bot à un serveur
Portal	Ouvre le Discord Developer Portal pour cette app
Copy URL	Copie la webhook URL
Test Connection	Vérifie la connectivité du bot
Disconnect	Supprime cette intégration

Dépannage

Le Bot ne Répond Pas

Vérifiez que l’Interactions Endpoint URL est configurée dans le Discord Developer Portal
Confirmez que le bot dispose des permissions dans le canal
Vérifiez que le token est correct dans Cuneiform Chat
Vérifiez que les slash commands sont enregistrés (en tapant / votre commande apparaît)

Les Commandes ne S’Affichent Pas

Les slash commands peuvent prendre jusqu’à une heure pour s’enregistrer globalement. Pour des tests immédiats :

Fournissez un Guild ID lors de la configuration pour un enregistrement instantané
Patientez le temps de la propagation globale si aucun Guild ID n’a été fourni

Erreurs de Permissions

Assurez-vous que le bot dispose de ces permissions :

Send Messages
Use Slash Commands
Embed Links
Read Message History (pour la prise en charge des threads)

Text DMs ne Fonctionnent Pas

Vérifiez que la bascule Text DMs est activée sur la carte d’intégration
Activez Message Content Intent dans Discord Developer Portal → section Bot
Redémarrez la connexion du bot si nécessaire

Sécurité

Les bot tokens sont chiffrés et stockés de manière sécurisée
Les commandes utilisent la vérification de signature intégrée de Discord
Aucun accès aux données du serveur au-delà des interactions directes

Déconnecter

Pour supprimer l’intégration Discord :

Rendez-vous dans Agents → Sélectionnez l’agent → Integrations
Cliquez sur le menu à trois points sur votre bot Discord
Sélectionnez Disconnect

Pour supprimer entièrement le bot de Discord :

Rendez-vous dans les paramètres de votre serveur Discord
Allez dans Integrations → Supprimez le bot