# Discord bot

All your Quests are actionable within Discord. 

Our bot automagically injects a Quest update into the designated channel, allowing anyone to easily complete the task without leaving your server.

[Sign-up for Community Hub today](https://sesamelabs.xyz/sign-up/?utm_source=docs\&utm_medium=gitbook\&utm_campaign=web2shift)

## Video walkthrough

{% embed url="<https://www.youtube.com/watch?v=34Z-YwEG34w>" %}

### Overview

Once deployed, our Discord bot automatically creates a "Quest" channel category that helps organize all bot activity.&#x20;

In the Quest category, the bot creates a handful of useful channels:

* Announcements - Home to any questing-related announcements, such as new quests, quest steps, leaderboard ranking updates, and quest winners&#x20;
* Commands - Dedicated channel to use any quest-related bot commands
* Activity - A feed of quest-related activity such as quest completions ![🤣](https://discord.com/assets/567230faa19ec889fad5613630597049.svg) ⁠
* Meme-contest - A place to see and react to memes for the weekly meme contest&#x20;

### Bot settings

From your Community Hub admin dashboard, you can configure the Discord bot to:

* Automatically notify a specific Discord role when a new quest is published
* Send a notification when a quest is started
* Send a notification when quest winners are selected

Simply click on "Settings" in the left-hand sidebar, then "Discord Bot"

<figure><img src="https://3213183904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYEDPrGtuajMM2jtubY4%2Fuploads%2FaNTmmHdkJMaAoiO4KaIg%2FScreenshot%202023-08-11%20at%205.09.45%20PM.png?alt=media&#x26;token=7efdc278-b0c5-47b9-af39-797e41f82dae" alt=""><figcaption></figcaption></figure>

### Bot commands <a href="#bot-commands" id="bot-commands"></a>

These are some useful bot commands that can be called from within Discord using the "/" + \[command] format:

* `/checkin` - Daily check in&#x20;
* `/quest` - View the latest quests&#x20;
* `/leaderboard` - View the leaderboard&#x20;
* `/status` - View your current status information, such as level, xp, and credits&#x20;
* `/submit-meme` - Submit a meme for the weekly meme contest!

> Admin only commands check for Discord user permissions to manage channels&#x20;

* `/award-credits` - (Admin only) Manually award credits to users&#x20;

![](https://3213183904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYEDPrGtuajMM2jtubY4%2Fuploads%2FY1S6hFEb9EudLzJDIW2T%2Fimage.png?alt=media\&token=8aadcd64-7453-4885-b06a-9bb404fe1a3f)![](https://3213183904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYEDPrGtuajMM2jtubY4%2Fuploads%2F0OwF2Io4Fm3a6cIQVtlA%2Fimage.png?alt=media\&token=a69b2d9d-a922-485a-ab93-640556d34411)![](https://3213183904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYEDPrGtuajMM2jtubY4%2Fuploads%2FjZC4aEGwtqPM1ySQNno8%2Fimage.png?alt=media\&token=d352a0f3-4e69-4305-92f9-ca5cac9f78fd)![](https://3213183904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYEDPrGtuajMM2jtubY4%2Fuploads%2FkMt0gx0XBAnvvrgheNgW%2Fimage.png?alt=media\&token=a3d58c31-2160-48bc-b601-fee93ef12816)

* `/rush` - (Admin only) Create a Twitter Rush quest with configurable reward amounts and the option to remove specific actions

  <figure><img src="https://3213183904-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYEDPrGtuajMM2jtubY4%2Fuploads%2FXUS7y2IlZrQqgtHO6dDy%2Frush%20bot%20commands.png?alt=media&#x26;token=613b8605-07a5-4c31-87b7-12b4143bf615" alt=""><figcaption></figcaption></figure>

> If you installed the bot prior to 6/20/2023 and decide to restrict permissions, you will need to change all of the quest channel permissions to allow the bot to send messages&#x20;