Setup discord bot

A step-by-step guide to setup discord with your dapp. Follow these simple steps to get started. If you get stuck anywhere, please reach out to our team on discord


Objective and contents

At the end of this guide, you should be able to integrate discord server for your customers.

Estimated time to complete this guide: ~10 min

Step 1 - Create a free account on hashmail dapp console :key:

👋🏼If you have already setup your dapp on the hashmail console, please skip to step 2

Get your access to the hashmail dapp console for free here

Step 2 - Integrate Discord with your dApp

Enabling Support Tickets in Discord for Your dApp

Creating a support ticket system in Discord for your dApp not only ensures efficient management of user inquiries but also provides a seamless user experience. It allows users to raise their concerns directly within Discord, avoiding the need for separate platforms.

Key Benefits:

  • Centralized user support process
  • Streamlined communication
  • Clear, organized, and real-time responses
  • Utilizes Discord's privacy and notification features

Setting up the Support Ticket System in Discord

  1. Access the Chat Support Page: Navigate to the 'chat support' page in the console.
  2. Go to Discord Setup: Find 'discord setup' listed under preferences within chat support.
  3. Check Prerequisites: Confirm you are an admin or a member of the Discord server you wish to connect with your dApp.
  4. Integrate with Discord: Click on the 'integrate discord' button to begin the process.
Integrate Discord Screen

Integrate Discord Screen

Step 3 - Connect with your discord community server

_Server Selection: After clicking 'Integrate Discord', you'll be redirected to choose the server you wish to connect with your dApp. Select the appropriate server to continue the process.

Select server screen

Select server screen

Choose Your Server: From the 'ADD TO SERVER' dropdown menu, you'll see a list of all the servers you're connected with on Discord. Select the server you wish to connect to your dApp.

Grant Permissions: The next phase involves granting the necessary permissions for integrating Discord. It's essential to check all the permissions; failure to do so might result in incorrect configuration of Discord.

Permission screen

Permission screen

Step 4 - Configure discord

Once connected you need to set discord BOT NAME, DESCRIPTION etc.

Discord has 4 configuration options :

Channel Name: Choose from a dropdown menu listing all the server's channel names. Pick the channel where all support tickets will be created.

Whitelisted Roles: These are roles granted special privileges or permissions within a server. Only these roles can view all tickets, ensuring confidentiality and privacy. Carefully select the roles that should have this access. This controlled approach helps maintain data security and keeps sensitive information within the ticketing system accessible only to designated roles.

Bot Name: Bots are automated user accounts performing various tasks and interacting with users. Pick a bot name reflecting its purpose and is memorable, aligning with your Discord server's theme. You can preview the bot name on the right-hand side of the screen.

Message Preview: Whenever a new ticket is created, the bot displays this text to provide the user with crucial information and instructions. It acknowledges the ticket creation and reassures the user their issue is being addressed. This can be previewed in real-time on the right-hand side of the discord setup page.

Save and Update: After filling out this form, click on the 'Save' button. All the parameters will be saved, and changes will be reflected on Discord.

Step 5 - All done ✅

Once Discord is successfully integrated into your system, users can conveniently raise tickets directly from your Discord server. This streamlined process enhances user engagement and allows for quick and efficient issue resolution.

To learn more about how to raise a ticket and make the most of this integrated support system, please visit this documentation here which is specifically created to guide users through the ticket submission process. By familiarizing themselves with the instructions provided, users can ensure that their concerns are effectively communicated and addressed, promoting a smooth and satisfactory support experience within the Discord environment.

If you have any inquiries or require further assistance regarding the Discord integration process, please feel free to contact us. Our team is readily available to provide support and address any questions you may have. Don't hesitate to reach out, and we'll be delighted to assist you in any way possible.

How to disconnect server

To disconnect a server, you can use the "Disconnect" button this will allow you to sever the connection between your dApp and the Discord server, effectively disabling the integration.

When you click on the "Disconnect" button, it will initiate the disconnection process. This will revoke the necessary permissions and privileges granted to your dApp, effectively terminating its access to the Discord server.

how to connect with different server

After disconnecting from the server, you can integrate with another server by following the same process. Simply select a different server during the connection setup, and you'll be ready to proceed.

Result 🎉

With Discord successfully integrated, users will immediately see changes on Discord, including the new bot and its description. This integration streamlines the way you manage and resolve user concerns by enabling them to submit tickets directly through Discord.

Instead of navigating multiple platforms, users can conveniently report issues, ask questions, or seek assistance all in one place. This consolidation of communication channels allows for efficient tracking and resolution of user tickets.

Furthermore, the seamless fusion of Discord in your ticketing system enhances the capabilities of your support team. They can provide timely responses and solutions, which in turn improves the user experience and boosts customer satisfaction.