Discord is a major tool for building Web3 communities. Voice has built a tool to help you build and manage yours, using a Voice account as authorization.
Table of Contents
How it works
Voice provides a free to use Discord integration that allows for Voice NFTs to work as access tokens to private Discord channels. This is done via setting custom roles, which can be set based on specific NFTs, NFTs by a specific creator, or on NFTs from a series.
Creating a Discord Server
If you are new to using Discord, or have never set up your own Discord before, we recommend reading through their Getting Started guide or jumping right into their tutorial on creating your own server.
Setting up Roles
The Voice Discord integration allows you to assign custom roles to users based on the NFTs they own on Voice. Roles allow for managing a user's access to specific channels within Discord. For example, you can make a channel in a server called “Best Friends”, and only allow users in your Discord with the role “best-friend” to access and post inside of that channel.
Before you begin to set up rules that allow adding roles based on NFTs, give Discord’s role tutorial a read to set up what you need.
Installing the Voice Discord Bot
Visit this link to add the Voice Verify application and bot to your discord server
You must be an administrator within the server
In addition to being a server administrator you must also have the administrator permissions turned on for the admin role in that server. To do this go to server settings -> roles, select the admin role, and then click permissions. Scroll to the bottom and turn on the “Administrator” flag.
Adding a Rule
Rules are the logic that allows for assigning roles to users based on the NFTs that they own. You will need to be an administrator within the Discord server in order to create these. In order to create a rule you will need:
A role that will be granted to users who satisfy the rule conditions. See the “Setting up Roles” section for more details about this.
The ID of the Series or specific NFT that will grant access to the role, or the name of an account on Voice.com that you would grant the role to for anyone who owns an NFT from that creator.
For a specific NFT or series this is the long numeric sequence found at the end of that NFTs URL. For example, for the NFT https://www.voice.com/creation/100000000000001 the ID would be “100000000000001”
For an account the account name is everything that comes after voice.com/ in the url. So for https://www.voice.com/voiceevents the account name would be voiceevents.
Once you have the role set up and the ID or account name you want to set it up for you will need to create the role, aka the logic for when that role is assigned to a user. To do this:
Make sure you have direct messages turned on for your server.
Go to any channel in your server (consider creating a private channel just for you to create rules in, but this isn’t required)
Type /voice into that channel
You will see a list of options appear - the Discord bot is designed to make this process easy for you
Click “rule add” from the menu that appears
Now that you have specified that you want to add a rule, you will see a new set of options. Select “role”
When prompted, type in the exact role name you set up above that you want to grant for this rule. For example, its the role “best-friend”
Press tab
You will now have two options to select, click on “match_type”
If you are looking to assign the role based on the user owning an NFT by a specific creator, type “Creator”
if you are looking to assign the role based on the user owning a specific NFT or any NFT from a specific Series type “NFT”
Press tab
You will now have one option left to select, click on “match”
When prompted, enter the Voice NFT ID that you got above, or the Voice username. Note: If you use the ID of a series, anyone who owns an edition of that series will satisfy the rule.
You will get a DM from the Voice Verify bot (must be open to DMs in the server) saying whether adding the rule succeeded or failed, and if it failed, why it failed
Removing a rule
Removing rules that you have set up is easy!
Go into the channel you were using to set up rules.
Type /voice and a set of options will appear
Select “rule remove”
Fill out the same details the same way you did when originally creating a rule in the section above.
Viewing Rules
Go to any channel in your server and type:
/voice rule list
You will get a DM from the Voice Verify bot (must be open to DMs in the server) with the list of rules for your Discord server
How to claim Discord roles based on Voice NFTs
For projects that have set up Discord roles for specific NFTs, it's easy to claim those roles.
Go to any channel in that Discord server and type (make sure you have DMs turned on).
Type /voice sync
You will receive a DM from the Voice Verify bot.
If you have not yet linked your Discord account to your Voice account the DM will include a Discord Authentication link that will link your Discord account to your Voice account. Linking your account once will link it for all Discord servers that you are a member of.
Click the link
Click the button to accept the request
You will be redirected to Voice and see your account has been linked
Go back to any channel in your server and type /voice sync again
If you have already linked your Voice account the DM will report the list of Discord server roles that you have been granted.