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.

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

Integration Steps (Takes 5-10 minutes )

  1. The bot integration process can be done through either the Discord desktop application or the web application 💻

  2. Gather & send Credentials, register with humanID.

  3. [Only proceed after you heard from us!] Add the Bot to Your Discord Server

2a. Find Your Discord Server's ID

  • Why:

    • This record helps us identify the server that you manage, so we can provide authentication services accordingly.

  1. In a signed-in Discord server, click on the gear icon

  2. Scroll down to the Advanced section then turn on Developer Mode

  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

2b. Register with humanID and find your Credentials

  • Why:

    • Allows 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, so your bot can interface with the core humanID service.

Find humanID Client ID and humanID Client Secret in the humanID Developer Console

  1. Register via the humanID Developer Console

  2. Create a new project

    1. THIS IS IMPORTANT - choose the project name as it will appear to your end users. We will ask your users to "Log into xyz" - what's xyz for you? For example, your Discord server's name could make sense.

  3. Click on Create New Credentials

  4. In this step, enter any 'Credential Name' you like, and choose 'Production' and 'Server'.

  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. If you are not the owner of the server, you can ask the owner to do so, and grant you administrator privileges.

  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. Under the "Add to Server:" section, choose the Discord server that you wish the humanID Discord Bot to live in.

  4. When asked to confirm granting the humanID Discord Bot Administrator access, confirm and click on Continue.

  5. Finish any final authorization step to add the bot.

P.S. Sometimes the "humanID-verified" role tag will not be automatically given to users. In this case, admin can manually assign this role to users.

Configure the ✅Verified Role

After adding the humanID Verification Bot to your server, the bot will create a "humanID-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.

Default Permissions of the humanID-verified Role

By default, the bot will give the following permissions to the humanID-verified Role:

  • View Channels

  • Change Nickname

  • Send Messages

  • Send Messages in Threads

  • Create Public Threads

  • Embed Links

  • Attach Files

  • Add Reactions

  • Use External Emoji

  • Read Message History

  • Use Application Commands

Grant access to private channels

Manually change permissions of verified users

Last updated