# Discord Ticket Setup

**Please note:** you can only connect one Discord server to each Mava dashboard. 

## Connect Mava to your Discord

### **Step 1: Create a new integration**

* Within the Mava Dashboard go to the [integrations page](https://dashboard.mava.app/dashboard/admin/integrations)
* Create a new 'Discord' integration

### Step 2: Add Mava to your Discord Server

* Select which server you want to add Mava to from the dropdown 

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/zCGVCAtx0l0cf9ALHDag/image.png" alt=""><figcaption></figcaption></figure>

* Authorize Mava to join your server (Mava doesn't require admin permissions like most bots, but we do require the permissions listed in the screenshot below to ensure the bot functions properly).

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/ePzeJqzbvEXn40c9j9Vh/image.png" alt=""><figcaption></figcaption></figure>

### Step 3: Select the Discord channel

***Tip:** We recommend creating a new channel within your Discord called e.g. '🎟️- Support-Tickets' or '🆘-Open-Ticket'. This channel can be private if you just want to test the bot out. We recommend this channel is ONLY used for support tickets and that non-admin users are not given permission to write in the main channel. This ensures that the only action users can take is to press the 'Create Ticket' button making the support process very clear.*&#x20;

* Find your existing ticket channel or the new one you just created from the dropdown.&#x20;
* After selecting which Discord channel you want the Mava bot in, you might receive an error message like the one below. Move onto the next step to set the correct permissions.&#x20;

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/ejSTzX34LpiI69R1pgSL/image.png" alt=""><figcaption></figcaption></figure>

### Step 4: Set the correct Discord channel permissions

* Open your Discord server and find the channel you added Mava to from the left hand channel list. In this example we are adding the Mava bot to a channel called ‘support-ticket’

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/WdcZMP8pTURGftQaBPHk/image.png" alt="" width="375"><figcaption></figcaption></figure>

* Right click on that channel (’support-ticket’ in our example) and select ‘Edit Channel’

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/a06QwJaAKneHBlAP9RbG/image.png" alt="" width="375"><figcaption></figcaption></figure>

* Select the ‘Permissions’ option from the top left menu.

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/Kk127v813YcMLgPGrUlH/image.png" alt=""><figcaption></figcaption></figure>

* Find the Mava bot from in the ‘Roles/Members’ section and click on it. If you don’t see the Mava role, you will need to search for it manually.

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/5U5CMysi5zRVOoh8peju/image.png" alt=""><figcaption></figcaption></figure>

* Once you have clicked on the ‘Mava’ Member you will be able to update the Permissions, under the ‘General Channel Permissions’ header. Press the green tick for the following permissions and save your changes.

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/vdqvLUpslsltWxDEffmU/image.png" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/QXYQV7QYeQ62GcBNMIeF/2image.png" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/TpVfGfSC1Zb9L7vlPj6J/3image.png" alt="" width="375"><figcaption></figcaption></figure>

* To make sure your users are able to interact with private threads properly, including allowing them to share screenshots, you will need to update settings for each of the roles within your sever. Just like you did with the Mava bot, you now need to add any roles into the channel that you want to be able to use the bot.

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/IF6f1cMVvRAmgS0g7h4N/Untitled.png" alt=""><figcaption></figcaption></figure>

* For users that you want to be able to open tickets (usually each role apart from @everyone) you need to update the permissions as follows. Make sure the "Send Messages in Threads" permission is turned on, otherwise users won't be able to type in the ticket.

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/7mJerouyf1mAkeGLwD8X/Untitled.png" alt="" width="362"><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/GE270eeNMRWvPdRXna1Z/2Untitled.png" alt="" width="359"><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/5VjpLaSN64xZ77wkyu4j/3Untitled.png" alt="" width="358"><figcaption></figcaption></figure>

* Go back to the Mava dashboard and press the ‘Check Permissions’ button.&#x20;

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/WQQQYqvGX0POMxQoVHHz/image.png" alt=""><figcaption></figcaption></figure>

* You'll see a confirmation message if the channel permissions are set correctly

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/qQLQmE9AOQypcNYmUUJW/image.png" alt=""><figcaption></figcaption></figure>

### Step 5: Customize your ticket panel

* This panel will be visible to users within your ticket channel and will be how they create a ticket in your Discord server. You can either update the text now or come back later to customize your ticket panel.

<figure><img src="https://content.gitbook.com/content/Tebv3SzLbdQL5VOCHzvx/blobs/GFWjFwRDKIPzuEwt45NG/image.png" alt=""><figcaption></figcaption></figure>

### Step 6: Send ticket panel to Discord

* To complete the setup and send the ticket panel to your Discord channel, press the Next button

### Step 7: Create a test ticket

* Go back into your Discord and press the 'Create Ticket' button

<figure><img src="https://2748965171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTebv3SzLbdQL5VOCHzvx%2Fuploads%2FJWpwne4catHT8cLVNh7x%2Fimage.png?alt=media&#x26;token=2a0949fb-488e-4dc2-bf36-a8147b8df34a" alt=""><figcaption></figcaption></figure>

* If you're set your permissions correctly, this will open a new ticket as a private thread within Discord
* You'll see your username under the channel list on left hand side after the thread has opened.

<figure><img src="https://2748965171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTebv3SzLbdQL5VOCHzvx%2Fuploads%2FspKGo5rWasA6q2BqtvJn%2Fimage.png?alt=media&#x26;token=c846fd92-f506-400c-a1e8-ad68a84f7da8" alt=""><figcaption></figcaption></figure>

* You can now type in the ticket, press buttons from your [Chatbot builder](https://mava.gitbook.io/mava-docs/getting-started/chatbot-builder) or close out the ticket