Important information to know about the GATR Bot and the Discord Role automation feature.
Installation and Removal #
If your GATR account is Community tier or higher, the Discord integration will be available to you in your Account page. The Integrate Discord interface will allow you to add and remove this integration from the GATR system, but you may still need to uninstall the bot manually in your Discord server settings. After installation, it is important to edit the Roles menu in your server so that the bot’s role is at the top, or at least above all other roles that you plan to automate.
NFT Role Transfers #
Token gates that provide Discord roles will preserve the user’s original roles prior to accessing the gate, so that a user’s roles can be rolled-back as opposed to wiped. If an NFT that was used in a Discord gate is sold to another user, the original holder will lose their Discord roles at the time that the new holder uses a Discord gate related to the same guild. In the case that the original holder simply transfers their token to a different wallet for safekeeping, they would not lose their roles.
Role Time-To-Live #
All role provisions have a time-to-live that is set in your Time-To-Live options during gate creation, creating an expiration date for role removal. Upon expiry, the GATR system will double-check that a user’s wallet still passes your gate conditions and either remove the user’s roles or extend the expiry date. This applies to gates that target stake pools and dReps, while roles that were provisioned from NFT-based triggers keep their roles until the moment a new holder uses that same asset.
Migrating From Other Bots #
We are working on a convenient self-service way to migrate Discord role data from your existing bot gating service to ours, and in the meantime please send a message in our Discord server to discuss ways we can help you export your data. Without a migration step, our GATR bot wouldn’t know which tokens / wallets were responsible for the role provisions, making it appropriate only for new projects.
There are many ways to proactively procure the wallet address from each Discord user that has previously received a token-gated role, such as with an automation tool like Zapier.com. You can create a token-gated channel only for users with gated roles, and a Zapier automation that manages each discord user’s last response on their own row in Google Sheets. It is always useful to know the wallet addresses of your Discord users, and in the near future the sheet can be used to import to GATR. From that point, you would be able to delete the token gating bot you are currently using and NFT Gater would pick up from there, tracking NFT ownership and de-authorizing roles if necessary.
