Bot Discord
Le bot compagnon Duck Dev AI déploie vos serveurs Discord et centralise les commandes, permissions et options de configuration.
Bot Discord
Le bot Discord Duck Dev AI déploie vos serveurs générés directement sur Discord. Ajoutez-le à votre serveur, générez un code de déploiement, et lancez une commande pour créer toute la structure en quelques secondes.
Le bot nécessite les permissions Gérer les rôles, Gérer les canaux, Envoyer des messages et Lire les messages. La permission Administrateur n'est jamais requise.
Vérifiez l'état du bot à tout moment via l'endpoint GET /health qui retourne le statut, l'uptime et le timestamp.
Ajouter le bot à votre serveur
Obtenir le lien d'invitation du bot
Depuis la page de déploiement de votre projet, cliquez sur « Déployer ». L'application récupère automatiquement le lien d'invitation du bot et son nom d'utilisateur.
Autoriser le bot
Cliquez sur le lien d'invitation, sélectionnez votre serveur Discord dans la liste déroulante, puis acceptez les permissions demandées par le bot.
Vérifier la connexion
Dans votre serveur Discord, tapez la commande /ping pour vérifier que le bot est en ligne et répond correctement. Le bot affichera sa latence.
N'accordez JAMAIS la permission Administrateur au bot. Duck Dev AI utilise uniquement des permissions sûres et ciblées. La permission Administrateur n'est jamais requise ni utilisée par le bot.
Permissions du bot
Le bot a besoin des permissions suivantes pour créer la structure de votre serveur :
- Gérer les rôles : créer et configurer les rôles générés par l'IA.
- Gérer les canaux : créer les catégories et canaux texte, vocaux, d'annonce et stage.
- Envoyer des messages : confirmer le déploiement et afficher les étapes.
- Lire les messages : recevoir et traiter les commandes slash.
- Gérer les webhooks : activer la configuration optionnelle des webhooks.
Le bot bloque explicitement la permission Administrateur. Même si vous l'ajoutez manuellement, le bot ne l'utilisera pas. Seules les permissions listées ci-dessus sont nécessaires.
Commandes
Le bot prend en charge les commandes slash suivantes :
| Commande | Description |
|---|---|
/ping | Vérifie la latence et l'état du bot. |
/info | Affiche les informations sur le bot et le lien d'invitation. |
/help | Liste toutes les commandes disponibles. |
/deploy | Démarre un déploiement à partir d'un fichier JSON. |
/serveur | Déploie un serveur Duck Dev AI avec un code de déploiement. |
Déploiement via /serveur
La commande /serveur est la méthode principale pour déployer un serveur généré par Duck Dev AI.
Générer un code de déploiement
Générez un code de déploiement depuis votre projet sur Duck Dev AI. Le code utilise le format DUCK-XXXX-XXXX.
Lancer la commande dans Discord
Dans le serveur Discord où le bot est installé, tapez la commande suivante :
/serveur code: DUCK-XXXX-XXXX
Récupérer la configuration
Le bot vérifie le code de déploiement, puis récupère la configuration associée à votre projet.
Créer la structure Discord
Le bot crée les rôles, catégories et canaux définis dans votre configuration.
Vérifier le résultat
Le bot confirme le déploiement et affiche un résumé des éléments créés.
Vous pouvez configurer des options de sécurité sur votre code de déploiement : limite d'utilisations, date d'expiration et identifiants des utilisateurs Discord autorisés. Consultez la page Déploiement Discord pour plus de détails.
Endpoint de santé
Le bot expose un endpoint HTTP pour les vérifications d'état, notamment sur les plateformes d'hébergement comme Render :
GET /health: retourne le statut du bot, son nom d'utilisateur, son temps de fonctionnement et l'horodatage.GET /: retourne un message simple confirmant que le bot est en ligne.
L'endpoint /health est utilisé par les plateformes d'hébergement comme Render pour vérifier que le bot fonctionne correctement. Vous pouvez aussi l'utiliser pour surveiller le bot en production.