Pour commencer

Configurez votre premier bot personnalisé, connectez un serveur Discord et commencez à vérifier les membres en moins de 10 minutes. Ce guide vous accompagne dans toutes les étapes, de zéro à un lien de vérification fonctionnel.

Conditions préalables

Avant de commencer, assurez-vous d'avoir les éléments suivants : un compte Discord, le droit de propriété ou le droit d'administrateur sur le serveur Discord que vous souhaitez protéger, et un compte RestoreHub (inscrivez-vous sur restorehub.net avec Discord, Google, GitHub, Apple, ou un email/mot de passe).

Restore Hub fonctionne sur un modèle de bot personnalisé. Au lieu d'ajouter un bot partagé que des milliers de serveurs utilisent, vous créez votre propre application Discord et donnez à Restore Hub les informations d'identification. Cela signifie que vos membres voient le nom et l'avatar de votre bot, et non les nôtres.

Astuce : Vous pouvez commencer entièrement avec le plan gratuit. Les comptes gratuits comprennent 1 bot personnalisé, 2 serveurs, 3 sauvegardes et la vérification du noyau. Les fonctionnalités premium telles que la détection VPN, la détection des altérations et le pare-feu nécessitent une mise à niveau.

Étape 1 - Créer une application Discord

Chaque robot Restore Hub démarre comme une application Discord standard. Vous la créerez dans le portail des développeurs Discord et transmettrez ensuite les informations d'identification à Restore Hub.

1. Ouvrir le portail des développeurs - Accédez à https://discord.com/developers/applications dans votre navigateur. Connectez-vous avec votre compte Discord si vous y êtes invité.
2. Créer une nouvelle application - Cliquez sur le bouton "Nouvelle application" dans le coin supérieur droit. Donnez-lui un nom (ce sera le nom d'affichage du bot sur votre serveur) et acceptez les conditions d'utilisation du développeur Discord.
3. Copier l'identifiant de l'application (client) - Sur la page "General Information", trouvez le champ "Application ID". Cliquez sur "Copier" et enregistrez ce champ quelque part - vous le collerez bientôt dans Restore Hub.
4. Copier la clé publique - Toujours sur "General Information", copiez la clé publique. Restore Hub l'utilise pour vérifier que les charges utiles d'interaction entrantes proviennent bien de Discord.
5. Générer le secret du client - Naviguez jusqu'à la section "OAuth2" dans la barre latérale gauche. Sous "Informations sur le client", cliquez sur "Réinitialiser le secret" et confirmez. Copiez le secret immédiatement - Discord ne l'affiche qu'une seule fois.
6. Créer l'utilisateur Bot et copier le Token - Naviguez vers "Bot" dans la barre latérale gauche. Cliquez sur "Réinitialiser le jeton" et confirmez. Copiez le jeton du robot et conservez-le en lieu sûr. Ce jeton donne le contrôle total du robot, il ne faut donc jamais le partager publiquement.
7. Activer les intentions privilégiées - Faites défiler la page Bot jusqu'à "Privileged Gateway Intents". Activez l'intention des membres du serveur (nécessaire pour le tirage et les sauvegardes des membres) et l'intention du contenu des messages (nécessaire pour les sauvegardes des messages). Cliquez sur "Enregistrer les modifications".

Attention : Votre jeton de bot et votre secret client sont des informations d'identification sensibles. Ne les collez jamais dans des messages Discord, des dépôts publics ou des captures d'écran. Restore Hub les crypte avec AES-256 au repos et ne les affiche jamais après la configuration initiale.

Étape 2 - Définir l'URI de redirection OAuth2

Discord exige que vous mettiez sur liste blanche l'URL exacte vers laquelle les utilisateurs sont redirigés après l'autorisation avec OAuth2. Restore Hub a besoin de cette configuration pour que la vérification fonctionne.

1. Naviguer vers les redirections OAuth2 - Dans le portail des développeurs, allez dans OAuth2 → General. Faites défiler la page jusqu'à "Redirects".
2. Ajouter l'URL de rappel du Hub de restauration - Cliquez sur "Ajouter une redirection" et entrez : https://restorehub.net/api/callback. Si vous prévoyez d'utiliser un domaine personnalisé (par exemple, verify.yourdomain.com), ajoutez également https://verify.yourdomain.com/api/callback. Cliquez sur Enregistrer les modifications.

https://restorehub.net/api/callback

Conseil : vous pouvez ajouter plusieurs URI de redirection. Ajoutez à la fois le rappel restorehub.net et tous les rappels de domaines personnalisés que vous prévoyez d'utiliser.

Étape 3 - Ajouter votre robot à Restore Hub

Maintenant que votre application Discord est configurée, apportez les informations d'identification dans Restore Hub à l'aide de l'assistant de configuration du bot en 5 étapes.

1. Ouvrez la page Bots personnalisés - Connectez-vous à restorehub.net. Dans la barre latérale du tableau de bord, cliquez sur "Custom Bots", puis sur "Add Bot".
2. Collez vos informations d'identification (étape 1 de 5 de l'assistant) - Saisissez le Bot Token, l'ID du client, le secret du client, la clé publique et l'URI de redirection. Restore Hub valide chaque champ en temps réel.
3. Configurer le point de terminaison Interactions (étape 2 de 5 de l'assistant) - RestoreHub génère une URL de point de terminaison des interactions unique pour votre bot (par exemple, https://restorehub.net/api/interactions/{botId}). L'assistant vous donne cette URL et vous demande de la coller dans le portail des développeurs Discord sous General Information → Interactions Endpoint URL. Discord envoie un ping de vérification - RestoreHub répond automatiquement. Une fois que Discord affiche une coche verte, continuez.
4. Définissez votre URL de vérification (étape 3 de 5 de l'assistant) - Choisissez entre une URL basée sur un slug (restorehub.net/s/votre-communauté) ou un domaine personnalisé (verify.yourdomain.com). Les slugs sont instantanés ; les domaines personnalisés nécessitent un enregistrement CNAME (abordé dans la documentation sur les domaines personnalisés).
5. Inviter à un serveur (étape 4 de 5 de l'assistant) - L'assistant génère un lien d'invitation OAuth2 avec les autorisations correctes (gérer les rôles, kicker les membres, voir les canaux, lire l'historique des messages). Cliquez sur "Inviter au serveur", sélectionnez votre serveur Discord dans la liste déroulante et autorisez.
6. Configurer les paramètres du serveur (étape 5 de l'assistant) - Sélectionnez le rôle Vérifié que les membres reçoivent après avoir passé la vérification. Vous pouvez également définir un canal de journalisation pour les événements de vérification, activer la fonction captcha, définir l'âge minimum du compte et activer les fonctions de sécurité.

Étape 4 - Partager le lien de vérification

Votre bot est maintenant en ligne. Partagez l'URL de vérification avec vos membres. Vous pouvez la poster dans un canal, la mettre dans la description de votre serveur, ou utiliser la commande /verify-embed slash pour créer un bouton intégré dans n'importe quel canal.

Lorsqu'un membre clique sur le lien, il est dirigé vers votre page de vérification personnalisée. Il clique sur "Vérifier", s'autorise avec Discord OAuth2 (en accordant l'identification, l'email, les guildes, et les champs d'application guildes.join), et se voit automatiquement attribuer le rôle vérifié dans votre serveur.

Astuce : Utilisez la commande /verify-embed (Premium+) pour afficher une vérification propre avec un bouton directement dans un canal Discord. Les membres cliquent sur le bouton et sont redirigés vers la page de vérification.

Ce qui se passe en coulisses

Les bots de Restore Hub utilisent le point de terminaison des interactions de Discord basé sur HTTP, et non la passerelle WebSocket traditionnelle. Il s'agit d'une distinction architecturale importante qui affecte le comportement du bot.

Avec l'approche de la passerelle, un robot maintient une connexion WebSocket persistante avec Discord et reçoit tous les événements en temps réel (messages, réactions, adhésions de membres, etc.). Cela nécessite une infrastructure toujours active et affiche un point d'état vert/jaune/rouge à côté du bot dans la liste des membres.

Avec l'approche Interactions Endpoint (que Restore Hub utilise), Discord envoie des requêtes HTTP POST à l'URL endpoint de votre bot uniquement lorsqu'un utilisateur déclenche une commande slash ou une interaction avec un bouton. Il n'y a pas de connexion persistante. Le bot apparaît dans la liste des membres sans point d'état - propre et professionnel.

Toutes les autres opérations (attribution de rôles, extraction de membres, création de sauvegardes, élimination de membres) sont effectuées via l'API REST de Discord à l'aide du jeton du bot. Cela signifie que Restore Hub peut évoluer vers des milliers de bots sans maintenir des milliers de connexions WebSocket.

Limites du régime en un coup d'œil

| Fonctionnalité | Gratuite | Premium | Business | Enterprise |
|---|---|---|---|---|
| Serveurs - 2 - 10 - 50 - illimité
| 1 | 5 | 25 | Illimité | Sauvegardes | 3 | 10 | 30 | 50 | Illimité
| Sauvegardes - 3 - 10 - 30 - 50 - illimitées
| Messages/Sauvegarde | 50 | 200 | 500 | 2 000 |
| 6 heures | 1 heure | 15 min | Aucune
| Détection VPN - Non - Oui - Oui - Oui - Oui
| Détection d'Alt - Non - Oui - Oui - Oui - Oui - Oui
| Détection VPN - Non, Oui, Oui, Oui, Oui, Oui, Oui
| Anti-Nuke - Non - Non - Oui - Oui - Oui
| Anti-Nuke - Non - Non - Oui - Oui - Oui - Oui
| Anti-Nuke - Non - Non - Oui - Oui - Oui
| Sauvegardes programmées - Non - Oui - Oui - Oui - Oui
| Commandes Slash | Non | Oui | Oui | Oui | Non | Oui | Oui
| Gestion d'équipe - Non - Non - Oui - Oui - Oui - Oui
| Limite de débit API | 20/10s | 50/10s | 100/10s | 200/10s |

Prochaines étapes

• Lisez la documentation sur les robots personnalisés pour comprendre comment fonctionnent les interactions HTTP et quelles sont les autorisations dont votre robot a besoin.
• Lisez la documentation sur la vérification pour en savoir plus sur chaque contrôle de sécurité dans le flux de vérification.
• Lisez la documentation sur la sécurité pour activer la détection VPN, la détection alt, les règles de pare-feu, l'anti-nuke et l'anti-raid.
• Lisez la documentation sur les sauvegardes pour configurer les instantanés du serveur et les sauvegardes programmées.
• Lisez la documentation sur l'extraction de membres pour savoir comment déplacer des membres vérifiés entre les serveurs.
• Lisez la documentation sur les domaines personnalisés si vous souhaitez vérifier.votredomaine.com au lieu d'une URL de type "slug".
• Lisez la documentation sur l'API REST si vous souhaitez intégrer Restore Hub à vos propres outils ou tableaux de bord.