Introduction

‍

Unlike many Discord bots, Mava doesn’t require admin permissions. Instead, the Mava bot simply needs channel-level permissions to function, which makes it very secure.

‍

The Mava bot uses private threads to create a private and secure environment for your users to discuss customer support inquiries with your team. By contrast, most other ticket bots create a new channel for each new support ticket. The benefit of using private threads is that it allows an unlimited number of support tickets vs. 50 when using channels  (due to Discord’s channel per category limit). Moreover, it helps keep your Discord more secure and organized. 

‍

When integrating Discord with Mava, you will be asked to grant the Mava bot essential permissions. This article will provide an overview of those permissions and explain what each one does. 

‍

Please read our onboarding guide here, if you haven't already created a Mava account.

‍

Discord user permissions

‍

On the first Discord integration screen, you will need to select which Discord server you want to add the Mava bot to. At this stage, you will see that we require the ability to Create commands in a server. This enables us to create an invitation link to join your selected Discord server.

‍

‍

Authorizing the Mava bot

‍

After you press continue, you will see the following list of permissions that Mava needs within your Discord server:

‍

‍

Here’s what each one does and why we need it for the Mava bot to function correctly:

‍

Read Message - this enables your support agents to see what users have written within private threads within the Mava dashboard.

‍

Send Messages - this enables the Mava bot to post your custom welcome message to users before they open a ticket.

‍

Send Messages in Threads - this enables your support agents to respond to users from the Mava dashboard and for the Mava bot to send your custom automated responses. 

‍

Create Public Threads - this enables the Mava bot to create public threads, which will be used in the future as we enhance the Mava’s functionality.

‍

Manage Messages - this enables the Mava bot to create and delete messages used for automations and agent support chats.

‍

Manage Threads - this enables the Mava bot to create and auto-archive private threads used for each support ticket. 

‍

Embed Links - this enables your support agents to share links with your users and for the Mava bot to share helpful links e.g. a link to the private thread.

‍

Attach Files - this allows your support agents to send images from the Mava dashboard to users within private threads.

‍

Read Message History - this enables your support agents to see what users have written within private threads within the Mava dashboard.

‍

Add Reactions - this enables the Mava bot to react to messages, which will be used in the future as we enhance the Mava dashboard

‍

Configuring the correct Discord channel permissions

‍

After you have added the Mava bot to your Discord server, you will need to correctly configure the channel you want to add the Mava bot to. We have made a quick guide here.

‍

Conclusion

‍

We take security seriously, and that’s why we don’t request admin permissions, utilize private threads and only request permissions essential to allow Mava to function.

‍

If you have any questions, please reach out to a member of the Mava team either on Discord or via our web chat widget. 

‍

Have questions about setting up Mava, data privacy, or anything else? Check out these handy guides:

FAQs

Data Privacy

Getting Started

‍