> For the complete documentation index, see [llms.txt](https://taskoncommunitys-organization.gitbook.io/guide-book/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://taskoncommunitys-organization.gitbook.io/guide-book/community-hub/bot-integration/discord-integration/how-to-add-taskon-discord-bot.md).

# 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>