> 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FjScfiaXAH8XbxiE4VBK1%2F%E6%88%AA%E5%B1%8F2024-07-03%2010.48.40.png?alt=media&amp;token=e10e6e09-519e-40c0-b18d-53da47f9f93a" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FGpcsnsFAsKEocB6TWRoA%2F%E6%88%AA%E5%B1%8F2024-06-28%2015.07.42.png?alt=media&amp;token=f05d39aa-a4ce-446c-95ed-82a637d20f0f" alt=""><figcaption></figcaption></figure> <figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2F9zKCyCYwmH3RZjYbHMkL%2F%E6%88%AA%E5%B1%8F2024-06-28%2015.07.51.png?alt=media&amp;token=7976e8fe-ddea-41c1-8ea7-aeb6a0f4c985" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FPCkyF0Olj4WShwTk6AYy%2F%E6%88%AA%E5%B1%8F2024-07-03%2010.48.48.png?alt=media&amp;token=03ea9887-c9e5-428a-acfd-1deea576b63b" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FL6ijcwa9OZH2bQ1qhhUt%2F%E6%88%AA%E5%B1%8F2024-07-03%2010.48.58.png?alt=media&amp;token=c45a53da-ff42-4b28-b71e-53a53aaffbcf" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FWELRSuAhnHBU8iFxKdlE%2F%E6%88%AA%E5%B1%8F2024-07-03%2010.49.05.png?alt=media&amp;token=7e08e66c-bfca-40e8-831a-f2eb302425fe" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FujMJ8fkBC9PZLbXHKhF8%2F%E6%88%AA%E5%B1%8F2024-07-03%2013.49.56.png?alt=media&amp;token=e3f6fcb1-a21d-46fa-8a3d-48c7c802bda3" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2F0MUdF2QT8tA3lfGRRHPR%2F%E6%88%AA%E5%B1%8F2024-07-03%2013.49.25.png?alt=media&amp;token=a761677c-4f8d-4cb0-b88a-319ccf1593b7" alt=""><figcaption></figcaption></figure> <figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FmfpiwodVjZREBHUQWj85%2F%E6%88%AA%E5%B1%8F2024-07-03%2013.49.36.png?alt=media&amp;token=5cae8bdc-7430-455c-9465-736d4cc42242" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FFngzt7B37HzulzEfjOiT%2F%E6%88%AA%E5%B1%8F2024-07-03%2010.50.01.png?alt=media&amp;token=0a46920a-031c-4c93-a859-dbd0df604311" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FKAIi5dgBQgeiu3wQacHy%2F%E6%88%AA%E5%B1%8F2024-07-10%2015.40.16.png?alt=media&amp;token=7a16f97a-abaa-4b19-b498-e4c2a260df97" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2F7vbcSes0mivRLHO6OrYk%2F%E6%88%AA%E5%B1%8F2024-07-10%2015.47.03.png?alt=media&amp;token=91d0e1a3-65e5-4afd-9851-27807c5b20b3" 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="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FQyHqZ110VL6OyK3IFFBu%2F%E6%88%AA%E5%B1%8F2024-05-31%2016.20.57.png?alt=media&amp;token=986f2e15-831b-4659-aaca-57d9509ba642" alt="" width="263"><figcaption></figcaption></figure>

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

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FhoZHrY8d6WMfBMf07laK%2F%E6%88%AA%E5%B1%8F2024-05-31%2016.21.20.png?alt=media&amp;token=2b734ab8-c400-4090-86ce-45b872d0d2b4" alt="" width="563"><figcaption></figcaption></figure>

**Automatic Notification**

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

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FSWR1deRCLdy5r4k1G1PN%2F%E6%88%AA%E5%B1%8F2024-07-03%2013.40.10.png?alt=media&amp;token=27267a34-f478-4460-8f02-7d831de946cd" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FYYED7xwCLJ8OK0BzxSYb%2F%E6%88%AA%E5%B1%8F2024-07-03%2013.41.48.png?alt=media&amp;token=ffc8afb6-6817-47b5-9054-9e07175d0799" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2F6sue9E7DhnvhUTFvICkc%2F%E6%88%AA%E5%B1%8F2024-07-03%2013.41.53.png?alt=media&amp;token=b5bd6e8e-439c-479b-a83b-4a626ce20019" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FhdglLap4mzvDS4tRfKGe%2F%E6%88%AA%E5%B1%8F2024-07-03%2013.42.00.png?alt=media&amp;token=bbdbc2c4-8390-4707-a1c1-fd6bf9765370" alt="" width="375"><figcaption></figcaption></figure>

**Predefined Commands**

`View Channels`, `Send Messages` .

<div><figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FVQwxcR85oSxmmKIlOiJS%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.29.33.png?alt=media&amp;token=c12b6269-0a90-4143-ae21-66d7d3d01c4f" alt=""><figcaption></figcaption></figure> <figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FmIaIj9gKSs8pt0cqJNBB%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.29.44.png?alt=media&amp;token=0b3b7dc1-febd-4f07-be5b-4a9976ff244e" alt=""><figcaption></figcaption></figure></div>

**Discord Role Auto-distribution**

`View Channels`, `Manage Roles` .

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FIzdmSX7mQK9PSDcwdZrS%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.31.21.png?alt=media&amp;token=4eb5bf3a-661d-4c45-84bc-a7b35f08df3f" alt="" width="375"><figcaption></figcaption></figure>

**Discord Message**

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

<div><figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2Fh1aWiY4hkctlEHh37khA%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.32.51.png?alt=media&amp;token=fb711008-c060-44e0-b0d9-30c725f0f117" alt=""><figcaption></figcaption></figure> <figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FUQwUpC4GDLWoWyT4fhAW%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.33.05.png?alt=media&amp;token=f1f62a3c-7148-407c-8beb-3d924f900551" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2Fo55LQW5VBsgEI2UCPlTx%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.33.26.png?alt=media&amp;token=b39ea87f-c313-4f3b-9706-4c6878dbdba8" alt="" width="375"><figcaption></figcaption></figure>

**Invite Task Verification**

`Manage Server` .

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2F07tHzrcpNKOUEHVVcdRz%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.35.47.png?alt=media&amp;token=e4d0f689-1055-4024-b424-f4c0da8d8be2" alt="" width="375"><figcaption></figcaption></figure>

Finally, click "`Save Changes`".

<figure><img src="https://3435385094-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjhotRGhsA7iGGmOsMlF0%2Fuploads%2FbGh1pX5EWGWOur9X87j9%2F%E6%88%AA%E5%B1%8F2024-07-03%2014.36.12.png?alt=media&amp;token=c9ab9ef7-b0ce-4f68-829b-6c09ae30acb1" alt="" width="563"><figcaption></figcaption></figure>