aslain.dev
0%
01 Hizmetler 02 Hakkımda 03 Projeler 04 Stack 05 Blog 06 İletişim
← Tüm makaleler Discord-bots

Discord Bot Verificatie: de complete gids voor een geverifieerde bot

Je bot groeit, de invite-link wordt van hand tot hand doorgegeven, en op een dag merk je dat hij geen nieuwe servers meer kan joinen. Precies hier komt Discord bot verificatie om de hoek kijken. Discord vereist een officiële verificatie van elke applicatie die de drempel van 100 servers passeert; zonder deze stap kan je bot geen servers boven de 100 joinen. In deze gids leg ik precies uit wat er bij de drempel gebeurt, hoe de verificatieaanvraag werkt, hoe de goedkeuring van privileged intents daarbij past, en de praktische manieren om het proces soepel te doorlopen.

Waarom bestaat de drempel van 100 servers?

De redenering van Discord is simpel: een kleine bot is experimenteel, maar een bot die honderdduizenden gebruikers bereikt is een serieuze verantwoordelijkheid. Voordat je 100 servers bereikt, kun je vrij ontwikkelen en testen; er is geen goedkeuring nodig. Op het moment dat je bot zijn 100e server joint, ontploft er niets, maar vanaf dat punt moet hij de verified (geverifieerde) status bereiken om nieuwe servers te blijven joinen. Verificatie is dus eigenlijk een mijlpaal waar je op moet plannen terwijl de bot nog klein is; de aanvraag voorbereiden bij server 50 is veel comfortabeler dan in paniek raken bij server 99.

Voorbereiden voordat je aanvraagt

De verificatieaanvraag vraagt je om duidelijk te beschrijven wat je bot doet en hoe hij data gebruikt. Zorg dat je het volgende klaar hebt voordat je de aanvraag opent:

  • Een duidelijke botbeschrijving: leg de kernfunctie uit, welke commando's hij biedt en welke data hij aanraakt, in gewone taal.
  • Onderbouwing voor privileged intents: als je de intents GUILD_MEMBERS, PRESENCE of MESSAGE_CONTENT gebruikt, leg dan met een concreet voorbeeld uit waarom elk nodig is.
  • Privacybeleid en gebruiksvoorwaarden: voor een bot die data verwerkt zijn deze inmiddels een verwachte standaard. Houd ze klaar, al is het een eenvoudige pagina.
  • Team- / identiteitsgegevens: verificatie kan vereisen dat de eigenaar van de applicatie zijn identiteit bevestigt; daarvoor heb je een geldig identiteitsbewijs nodig.

Privileged intents: de echte kern van verificatie

De meeste ontwikkelaars denken dat verificatie alleen gaat over het "ontgrendelen van de serverlimiet", terwijl het werkelijk veeleisende deel de goedkeuring van privileged intents is. Discord zet drie privacygevoelige gateway intents apart:

  • GUILD_MEMBERS — de ledenlijst, join/leave-events, rolwijzigingen.
  • GUILD_PRESENCES — de online-status van gebruikers en hun activiteiten.
  • MESSAGE_CONTENT — de tekstinhoud van berichten (privileged sinds 2022).

Onder de 100 servers kun je deze intents met één klik vanuit het Developer Portal aanzetten. Maar voor een geverifieerde bot moet je voor elke privileged intent aparte goedkeuring verkrijgen. De meest gemaakte fout hier is het aanvragen van MESSAGE_CONTENT terwijl je het eigenlijk niet nodig hebt. Als je bot puur via slash commands werkt, heb je meestal geen toegang tot berichtinhoud nodig, en deze intent niet aanvragen versnelt je aanvraag.

Zet in code alleen de intents aan die je echt gebruikt. Een typische minimale opzet met discord.js ziet er zo uit:

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    // MessageContent alleen als je prefix-commando's / tekst lezen nodig hebt:
    GatewayIntentBits.MessageContent,
  ],
});

client.once('clientReady', () => {
  console.log(`Ingelogd als: ${client.user.tag}`);
});

client.login(process.env.DISCORD_TOKEN);

De gouden regel hier: de intent die je aanvraagt moet overeenkomen met de intent in je code. Als je in de aanvraag zegt "ik luister naar member-events voor moderatie" maar de GuildMembers intent staat niet aan in je code, of andersom, dan duurt de beoordeling langer.

Het aanvraagproces, stap voor stap

  1. Open je applicatie in het Developer Portal en controleer onder het tabblad Bot welke privileged intents zijn ingeschakeld.
  2. Plaats je bot indien mogelijk onder een Team; dat is gezonder voor zowel beveiliging als organisatorische zichtbaarheid.
  3. Vul het verificatieaanvraagformulier in: botbeschrijving, onderbouwing van intents, link naar privacybeleid.
  4. Voltooi de identiteitsverificatiestap als daarom wordt gevraagd.
  5. Dien de aanvraag in en wacht op de beoordelingsperiode. Deze kan variëren van enkele dagen tot meerdere weken, afhankelijk van de drukte.

Praktische tips om afwijzing te voorkomen

  • Maak onderbouwingen concreet. In plaats van "ik heb ledendata nodig", schrijf "ik luister naar het GuildMemberAdd-event om een welkomstrol toe te kennen wanneer nieuwe leden joinen".
  • Vraag geen extra intents aan. Elke privileged intent die je inschakelt betekent een aparte onderbouwing en een extra beoordelingslast.
  • Verduidelijk je databewaarbeleid. Bewaar je berichtinhoud, en hoe lang? Een duidelijk antwoord wekt vertrouwen.
  • Houd je bot draaiend. Een bot die tijdens de beoordeling onbereikbaar is of fouten geeft, maakt een slechte indruk.
  • Vraag op tijd aan. Begin voordat je 100 servers bereikt, zodat je groeimomentum niet onderbroken wordt.

Wat verandert er na verificatie?

Eenmaal goedgekeurd verschijnt er een Verified-badge op het profiel van je bot en kan hij vrij servers boven de 100 joinen. Die badge stelt gebruikers ook gerust; bij het toevoegen van een onbekende bot is geverifieerd zijn een serieuze plus. Goedgekeurde privileged intents zijn permanent, maar als je het gedrag van de bot ingrijpend wijzigt (bijvoorbeeld nieuwe data gaat verzamelen) wordt van je verwacht dat je trouw blijft aan je privacytoezeggingen. Verificatie is geen einde, het is het begin van het draaien van een verantwoorde bot.

Veelgestelde vragen

Heb ik verificatie nodig als mijn bot onder de 100 servers zit?

Nee. Verificatie is niet verplicht onder de 100 servers, en je kunt privileged intents zelf inschakelen vanuit het Developer Portal. Maar als je van plan bent te groeien, loont het om het proces vroeg te leren kennen.

Kan ik een bot bouwen zonder de MESSAGE_CONTENT-intent?

Ja. De meeste moderne bots werken met slash commands, knoppen en menu's; deze interacties vereisen geen toegang tot berichtinhoud. Deze aanpak is zowel privacyvriendelijk als makkelijker te verifiëren.

Hoe lang duurt verificatie?

Er is geen vaste duur; meestal varieert het van enkele dagen tot meerdere weken. Een duidelijke aanvraag, concrete onderbouwingen en aangevraagde intents die consistent zijn met je code versnellen het proces merkbaar.

Wil je je bot klaarmaken voor verificatie? Of je nu een schone intent-architectuur vanaf nul wilt of dat ik je bestaande bot klaarmaak voor de verificatieaanvraag — voor een solide, duurzame Discord bot, neem contact met me op.

Bu kategorideki tüm yazılar →

Devamı için