Links

Discord Bot Integration Guide

The How-To Guide

Discord Bot

humanID’s Discord Bot offers a 100% anonymous option for Discord authentication. Protect your server from duplicate and fake accounts, data leaks/theft, and abusive users with a more secure method of authentication. humanID is a product of the nonprofit Foundation for a Human Internet. We guarantees that our Discord authentication bot is anti-spam, anti-raid, and anti-bot with no other motive than to preserve online communities. We never harvest personal data.

Requirement

You should have administrative privileges on the Discord Server that's trying to integrate the Discord Bot 🚨

Integration Steps (Takes 5-10 minutes )

  1. 1.
    The bot integration process can be done through either the Discord desktop application or the web application 💻
  2. 2.
    Gather & send Credentials, register with humanID.
    • Send an email with the following information to [email protected] with the email subject humanID Discord Bot Integration. See below on where to find this information.
        • This record helps us identify the server that you manage, so we can provide authentication services accordingly
        • Essential for the bot to run accurately on your server
        • Allow us to connect your server to humanID, so we are able to verify (or block) individual users for your Discord Server.
        • Verifies that you registered your server with our core authentication service.
        • Essential for the bot to interface with the core humanID service
    • You'll hear from us within 48 hours.
  3. 4.
    [Only proceed after you heard from us!] Add the Bot to Your Discord Server

Finding Your Discord Server's ID

  1. 1.
    In a signed-in Discord server, click on the gear icon
  2. 2.
    Scroll down to the Advanced section then turn on Developer Mode
  3. 3.
    Come back to the server's main page. Above the text channel list, right-click on the server's name and select Copy ID

humanID Developer Console Setup (free!)

Finding Your humanID Client ID and humanID Client Secret

  1. 1.
    Register via the humanID Developer Console
  2. 2.
    Create a new project
  3. 3.
    Click on Create New Credentials
  4. 4.
    In this step, enter any 'Credential Name' you like, and choose 'Production' and 'Server'.
  5. 5.
    Click on your existing humanID projects and locate the clipboard buttons on the server credentials. Click on the small 'copy' buttons and add those to your email to us.

Finishing the Setup in the humanID Developers Console

After creating the credentials, click on Edit Redirect URLs on the bottom-right side of the project page:
  • For 'Successful URL', paste in the following: https://verify.discord.human-id.org/verification_successful
  • For 'Failed URL', paste in:https://verify.discord.human-id.org/verification_failed
  • Don't forget to save the update.

ONLY PROCEED AFTER YOU HEARD FROM US! --> Add the Bot to Your Discord Server

  1. 1.
    If you are not the owner of the server, you can ask the owner to do so, and grant you administrator privileges.
  2. 2.
    Click this link: “Add the humanID Discord Bot to Your Server” . This button will take you to the Discord website. Please ensure that you are logged into the correct Discord account.
  3. 3.
  4. 4.
    Under the "Add to Server:" section, choose the Discord server that you wish the humanID Discord Bot to live in.
  5. 5.
    When asked to confirm granting the humanID Discord Bot Administrator access, confirm and click on Continue.
  6. 6.
    Finish any final authorization step to add the bot.

🎉
Congratulations - you're ready to build a community of humans, without compromising your users' privacy or having to handle private data yourself!

Optional Configurations:

Configure the ✅Verified Role

After adding the humanID Verification Bot to your server, the bot will create a "Verified" role that users can take on. We want to give you the autonomy to configure that role to give your server members access that you feel comfortable with.

  • Head over to the Server Settings panel
  • Make sure that the Verified role is adjusted to sit underneath the humanID Verification role
  • Click on the Verified role to toggle on capabilities that you'd like to give members
  • Permission changes are saved automatically. Congratulations, you've successfully set up the humanID Verification bot! Enjoy😊