# Discord

##

{% hint style="info" %}
We are in the process of updating our documentation. Please note that the images displayed in this tutorial may not accurately reflect the current appearance of the backend. However, rest assured that the process remains the same. As such, we have retained the old guide until the new version is released.
{% endhint %}

## Step 1 - App Settings

To create a custom bot, go to the "Settings | Apps" section, choose "Create App", and select "Discord". In order to generate the necessary Bot Token, you will need to visit the Discord Developer Page, which is conveniently linked within the "Apps > Discord > Create/Update" page when you initiate the creation of your customized Siva bot.

<div align="left"><figure><img src="/files/k4tfPgCyCyTAeEsRuZYx" alt="" width="563"><figcaption><p>Navigate to Apps, to create new Engage2Earn Apps</p></figcaption></figure> <figure><img src="/files/TiHxzwfBc8mtXM5HNamW" alt="" width="376"><figcaption><p>Click on "Create App"</p></figcaption></figure> <figure><img src="/files/fCKPaMmGcON7bOzzWwCg" alt="" width="263"><figcaption><p>Select Discord App</p></figcaption></figure></div>

## Step 2 - Developer Portal

Click on the "Visit Discord Developer Page" Link to navigate to the Discord Developer Portal. Login or Register with your Discord account, to access your personal Developer Dashboard.

<div align="left"><figure><img src="/files/4iQjemfqlZohwzxuNQba" alt="" width="563"><figcaption><p>Direct link to the Discord Developer Portal</p></figcaption></figure> <figure><img src="/files/QoOTwBEmqnIKIi3wHYNB" alt="" width="563"><figcaption><p>Discord Developer Portal after login</p></figcaption></figure></div>

## Step 3 - Discord App

Create a new Discord app by clicking on "New Application" in the Discord Developer Portal Dashboard, choose a name for the app, enter your custom bot bio, choose the bot image, and generate the access token for your Bot.

<div align="left"><figure><img src="/files/l8QQy65DWDRrqCwAMW9R" alt="" width="563"><figcaption><p>Click on New Application to create a new Discord app</p></figcaption></figure> <figure><img src="/files/J94O4RDBf7hkRSs5rixJ" alt="" width="341"><figcaption><p>Enter the name of your Bot, tick the checkbox, and hit the Create button</p></figcaption></figure> <figure><img src="/files/sy38EESg2rxSqJYXmzqu" alt="" width="563"><figcaption><p>Enter your customized details in the Discord Developer Portal</p></figcaption></figure></div>

## Step 4 - Generate Token

In order to reward long messages, we verify if a message contains more than 20 words. To configure your Discord bot accurately and generate the necessary Discord bot token, follow these steps: Click on the "Bot" menu button within the Discord Developer Portal, scroll down until you locate "MESSAGE CONTENT INTENT," enable the checkbox, and then click on "Save Changes."

Scroll to the top after saving the changes, to generate your Bot token.

<div align="left"><figure><img src="/files/LGKCk9QQaOpHuMkozWx7" alt="" width="563"><figcaption><p>Enabling the "MESSAGE CONTENT INTENT" is required to reward quality content</p></figcaption></figure> <figure><img src="/files/LIoQU17Z0wbz8jBBEgkq" alt="" width="563"><figcaption><p><mark style="color:red;">It is important to keep the Bot token confidential</mark></p></figcaption></figure></div>

{% hint style="danger" %}
**IMPORTANT!**

Keep the Bot token confidential, safe, and secure!

Treat it like the private key of your crypto wallet.
{% endhint %}

<div align="left"><figure><img src="/files/fZXCMiTUEJpggbiBlnoK" alt="" width="339"><figcaption><p>Lets change the Discord bot token - click on "Yes, do it!"</p></figcaption></figure> <figure><img src="/files/30rwUYV5EV0CawSbQzrm" alt="" width="563"><figcaption><p>The token has been generated, simply click on the "Copy" button to copy the token to your clipboard</p></figcaption></figure></div>

## Step 5 - Activate Token

Return to siva.gg and input the copied Bot token within the "Settings | Apps | Create New | Discord" section of the Siva backend. Afterward, click on the blue "Verify App Token" button to proceed.

Hit the "Save App" button, to save and activate your custom bot.

<div align="left"><figure><img src="/files/P06Xr1pnyBuX5v0u7ZFo" alt="" width="563"><figcaption><p>If the Bot token is valid, the Avatar, Bio and Owner will be shown</p></figcaption></figure> <figure><img src="/files/WCEexaTwiGObdP2TwO8X" alt="" width="286"><figcaption><p>The custom bot shows up in the apps list</p></figcaption></figure></div>

## Step 6 - Invite Bot

The final step is to invite your custom bot to your Discord server. To do this, go to your app's settings page and select your Discord bot (the one you've just created). Click on the "Invite Bot" button to send an invitation to your server.

<div align="left"><figure><img src="/files/WVwWDLWux0590MbNTbpa" alt="" width="286"><figcaption><p>Select your bot, to get to the settings page</p></figcaption></figure> <figure><img src="/files/aGR8JpHAUaGBVYCj8F6H" alt="" width="563"><figcaption><p>Invite your custom Bot to your Discord server</p></figcaption></figure></div>

As a final step, you need to **remove the free Siva bot from your server** to activate your custom bot - **Done** ✅\
\
Congratz! Your bot is now fully prepared, allowing you to utilize your own NFTs and Tokens as Rewards and/or Requirements. Please refer to this guide for detailed instructions on setting it up.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.siva.gg/founders-guide/backend/project-settings/apps/discord.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
