# How to Add TaskOn Discord Bot

`Discord` members can easily access `real-time` information about Community tasks, ensuring a seamless connection between Discord and the Community.

1. Click " `Community Settings`", select "`Discord Integration` ", and enter your Server URL

<figure><img src="/files/GCnpqgaf52WijVgLrZEf" alt="" width="563"><figcaption></figcaption></figure>

Currently, TaskOn Discord Bot supports multiple features: `Automatic notification`, `Predefined Commands on Discord`, `Discord Role Auto-distribution`, `Discord Message,` and Discord `invite task verification`. More will be available in the future.

<table><thead><tr><th width="230">Items</th><th width="370">Note</th><th width="174">Permissions</th><th></th></tr></thead><tbody><tr><td>Automatic notification</td><td>Notifications of new tasks/quests/events on Discord, which keeps users well informed and encourage immediate participation.</td><td><p>Read messages/view channels/</p><p>send messages</p><p>embed links/</p><p>mention everyone</p></td><td></td></tr><tr><td>Predefined commands</td><td>Commands for completing tasks, querying points/levels/rankings...</td><td><p>Read messages/view channels/</p><p>send messages</p></td><td></td></tr><tr><td>Discord role auto-distribution</td><td>Discord roles will be auto-distributed to specific users/winners. You can set Discord role auto-distribution in quests.</td><td><p>Read messages/view channels/</p><p>manage roles</p></td><td></td></tr><tr><td>Discord message</td><td>Set Discord messages in tasks and boost user engagement (sending messages) in your Discord channels.</td><td><p>Read messages/view channels/</p><p>send messages/</p><p>embed links/</p><p>mention everyone</p></td><td></td></tr><tr><td>Invite task verification</td><td>If you set Discord invite task in your community, bot can help you to complete verification automatically.</td><td>Manage server</td><td></td></tr><tr><td>Discord alert (coming soon)</td><td>Notify your members when you stream on Twitch, post on Twitter and upload on YouTube &#x26; Instagram </td><td>/</td><td></td></tr></tbody></table>

<div><figure><img src="/files/c87uKFv6VTDGPJLaOdvN" alt=""><figcaption></figcaption></figure> <figure><img src="/files/u0uoglZmDaffuvp0jXqC" alt=""><figcaption></figcaption></figure></div>

**You can add or modify TaskOn Bot permissions in your Discord Server settings. For detailed instructions on `How to Add Permissions`, please refer to the "`Task Permissions`" section of this article.**

2. Click "`+ Add TaskOn bot to your server & grant permissions`".

<figure><img src="/files/sMbOwJSMPGclz6S0189z" alt="" width="563"><figcaption></figcaption></figure>

3. Allow TaskOn bot to `join server`, `access your username, avatar, and banner`, `create commands`, then click "`Continue`".
4. Grant TaskOn bot permissions: `Read Messages`, `Send Messages`, `Embed Links`, `Mention @everyone, @here, @All roles`. Then, click "`Authorize`".

<figure><img src="/files/wFEtH2yIWn2Zw17UXzXU" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/biBa4oHAtsPRm2QhdDno" alt="" width="563"><figcaption></figcaption></figure>

To enable the TaskOn bot, you need to modify the bot's priority in your Discord server.

1. Click "Server Settings".

<figure><img src="/files/9N2JOPmDfIA4PldqMDY9" alt="" width="251"><figcaption></figcaption></figure>

2. Click "Roles" and move the TaskOn bot role ahead of other roles.
3. Click "`Save changes`".

<div><figure><img src="/files/KWIxlNahKb8IcjkS4odq" alt=""><figcaption></figcaption></figure> <figure><img src="/files/i9mYmhRObFJwA9bsV7fY" alt=""><figcaption></figcaption></figure></div>

### Automatic Notification on Discord

Notifications of new `Tasks`/`Quests`/`Events` on Discord keep users well informed and encourage immediate participation.

If you want to create a Discord channel for the TaskOn bot , please refer to this tutorial: [**Discord Message & Alert**](/guide-book/community-hub/bot-integration/discord-integration/discord-channel-and-alert.md).

1. Back to TaskOn Bot settings webpage, mark the checkbox, choose channels you want bot to send messages, mention roles, then click "`Confirm`".

<figure><img src="/files/Exisn7nGnLowMbKfDdkJ" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/0sWEzHhlLuEZC6alc3V2" alt="" width="337"><figcaption></figcaption></figure>

### Predefined Commands on Discord

Commands for completing `tasks`, querying `points`/`levels`/`rankings`...

1. Mark the checkbox, choose channel, then click "`Confirm`".

<figure><img src="/files/DgirbnvWWGV9QhzOk1Xa" alt="" width="373"><figcaption></figcaption></figure>

### TaskOn Bot Permissions

After adding the TaskOn bot to your server, please ensure that it has the permissions to perform these actions:

1. Click "`Server Settings`".

<figure><img src="/files/vlpNVK1RUBYinXUguKgZ" alt="" width="263"><figcaption></figcaption></figure>

2. Click "`Roles`" and choose TaskOn.
3. Click "Permissions" and mark the checkbox.

<figure><img src="/files/MuSiQlFEbI8HbRH1Hudl" alt="" width="563"><figcaption></figcaption></figure>

**Automatic Notification**

`View Channels`, `Send Messages`, `Embed Links`, `Mention Roles` .

<figure><img src="/files/JwjY1sfka4pOIWiCG8KJ" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/kookQ8fH7PX87PuhKMj4" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/IYzQQzCCAc4jhh6Bvc7J" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/AAn5tFWlwYJlGF8zp9As" alt="" width="375"><figcaption></figcaption></figure>

**Predefined Commands**

`View Channels`, `Send Messages` .

<div><figure><img src="/files/LUExIeleeHjYk49zSE3D" alt=""><figcaption></figcaption></figure> <figure><img src="/files/5spBOVi4AJRxIXYvSr7m" alt=""><figcaption></figcaption></figure></div>

**Discord Role Auto-distribution**

`View Channels`, `Manage Roles` .

<figure><img src="/files/LCPZGBOzqTqLJyGqmeUy" alt="" width="375"><figcaption></figcaption></figure>

**Discord Message**

`View Channels`, `Send Messages`, `Embed Links`, `Mention Roles` .

<div><figure><img src="/files/p1Dam3neyJhPz9qbVvV5" alt=""><figcaption></figcaption></figure> <figure><img src="/files/B41fi3dFlz4KMmMedV46" alt=""><figcaption></figcaption></figure></div>

<figure><img src="/files/MHhUDZMxLbmMYS1bTkNf" alt="" width="375"><figcaption></figcaption></figure>

**Invite Task Verification**

`Manage Server` .

<figure><img src="/files/5B5jfTC6VSKV8nXery18" alt="" width="375"><figcaption></figcaption></figure>

Finally, click "`Save Changes`".

<figure><img src="/files/HUxGA01CDGFfxh9Bfvx3" alt="" width="563"><figcaption></figcaption></figure>


---

# 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://taskoncommunitys-organization.gitbook.io/guide-book/community-hub/bot-integration/discord-integration/how-to-add-taskon-discord-bot.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.