# Discord Bot

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeDvZI8JmYFNtuSDWbfcvPkaQi9FONfADOrxwQcG9eksYmSBrJ1vt0wsEOnq7OJIaPTgHeAmdxo5qGJDKaCtEqw-RV5VACmZ1wyCagdB5-4gzWHRjrsFaWJD4lNM-9JgmQKnK12?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

## **How to add a Discord bot**

Discord members can easily access real-time information about community tasks, ensuring seamless integration between Discord and the task incentive system.<br>

Click on “`Community Hub`,” select “`Bot Integration`,” then click on “`Discord Integration`,” and follow the prompts to enable the buttons for *Automatic Notification on Discord* and *Predefined Commands on Discord*.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfbUxazmeS9h-MwDoAduCuQ6oeCA2gwmgEnEHtuxLlDN2afqMSPI6WC8S8y_ZWpKJkj9VwCsFYO7HnGWZaXck0uqur_Lyr8sQXcN4sxmBfHe4OkYZVFP7pkioxdBHcIyg2QjFGkeA?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

**`Automatic Notification on Discord`:** This feature enables automatic notifications on Discord for new tasks or quests, keeping users informed and encouraging immediate participation.

**`Predefined Commands on Discord`:** This feature allows users to complete tasks, query points, levels, or rankings through predefined commands.

These two features operate independently, but it is recommended to enable both when setting up the Discord bot for optimal functionality.<br>

Currently, the TaskOn Discord Bot supports multiple features: `Automatic Notification`, `Predefined Commands on Discord`

Features like `Discord Role Auto-distribution`, `Discord Message`, and `Discord Alerts` will be available soon.

### Enable Automatic Notification on Discord:

After clicking the *Automatic Notification on Discord* button, you will be prompted to select a Discord Server (one where your account has administrative privileges).&#x20;

Choose the Discord community you want to integrate and select the corresponding Channel(s).

If this is your first time binding the community, you will be redirected to Discord for verification and permission requests. If the community has been previously added, no further authorization is required.

Then, click `Authorize` *a* `different Discord`.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf4uCgEudi_Dxd1w091ebU2ZNu12vt0436C6TtUPONmzCBsEkL58pJLjPPXoukQru2SEIYLAf9Mxojv-wIdHaWFcV-crdkUqB2fsuwo-u4DI6hNphPy6mf81yPoazk8iLL9rKW2?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

### Enable Predefined Commands on Discord:

If you have already set up `Automatic Notification on Discord`, enabling `Predefined Commands on Discord` for the same Discord community will automatically indicate that it has been successfully added, requiring no further action.

If this is your first time, after clicking the *Automatic Notification on Discord* button, you will be prompted to select a Discord Server (one where your account has administrative privileges). Choose the Discord community you want to integrate and select the corresponding Channel(s). Then, click `Authorize a different Discord`.

<figure><img src="https://422440725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaikZy1CQmprkOt4N09Jt%2Fuploads%2FOoP7mkSDIXpbjiqig5mH%2F%E6%88%AA%E5%B1%8F2025-08-01%2011.16.25.png?alt=media&#x26;token=961d45b8-229e-4132-a02e-404039ec6a9e" alt=""><figcaption></figcaption></figure>

After redirecting to Discord, click `Authorize` to complete the setup.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfT15KrFcKhQ1IoW5dmlx984Jg5KmfPZyIZQuF4JMWI6K9vOmq1xYmKFS7PjaT-lTDdTL1F2V7QdjNHXdI8NNPqv0gHlI8KF9vaDVenrVuZNbVDWA5UP5E3OXIpnZEu7I-NbmFw?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

### **Discord Bot Set up**

Once the setup is complete, access the Discord server to configure the bot’s permissions. First, adjust the bot’s role priority.<br>

Click “Server Settings,” select *Roles*, and locate the TaskOn role.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcEkafKRayy9UkOuv6FHVSQuSOwRkAw3hLW7J1YyJUHI0EdB2uODVpaOP9BJuZSjNk57t2Cx0ynQDJwjmEv6LvlOs41mNDnLks5ARNnn7MP4RSgdNc1qE50R9bycXisO-fK5SyjSA?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfltXyQAhHCGPnlBid5F6t1AiixnhKWwVmErS8D_lIIXKk2sDQsGGfF-91BxUusowp1xAXx7msV2eAU5NCGc05bZX8lQ11iulWIzDXKwMBdBYF3JZxJtL953nI5mYWAhaQntOdYeA?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfYlnwjR3iWQMe9G2Ynt-Dx-3KPrirKOg3vSj5q5iFW8U2KeozCdHknwgdny0qiKPID6va_vyfGpU3Wb6sbtJfXpB3kbAZW1P_ikqd-5CMCqq0vyW4cjhcDE5HbTvtNpCMZ5Fd0kQ?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

Click “`Roles`” and move the TaskOn bot role above other roles, then click *Save Changes*.

Next, click the TaskOn role, select “Permissions,” and check the appropriate boxes.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfRO3mk1b2iDs9LF9RiAaYgDKnrSV9luuXeeWIr_aM4IJHCVqtFxcu_hsztbr7qrWJ8MNFPp-eyJCZK6qQfPKri5SOAPlxKAqQmC7iz2t3Mwdjs7Odsgp5XjxazypxvGb1G8RbRNg?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

### **Automatic Notifications**:

&#x20;Notify authorized Discord channels about new content published on the TaskOn platform.\
Required permissions:

· `View Channels`

· `Send Messages`

· `Embed Links`

· `Mention @everyone, @here, and All Roles`

These permissions allow the bot to view specific channels, control channel visibility, send notification messages, embed TaskOn event links, and `Mention @everyone, @here, and all roles`.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdcQIqCJs8CVFTvXWLjrVLTRhUiDmT2AB9_9TjSiM7mPQzUFd8YIF5XxnHcuRe-1gQ6afaRaS0jTeP20T2nih-CZIXW58LGVY4wH899yZ3r9h0ynM2_hlDhox9x3l25I2TRcaJQ?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc_2RiPuXxxSsidz362yxcqBYeRV0U_qNvklzWULzwp2iupAoK6I_u1mcWitftdVZR1ZxSgtMggOpaaeXhiOzz6YOa4TQlma5hMmErKLNYoCT2y0WEegRU1JX_x3AlrIMMwcyb4rQ?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe47PpD21MT04kVG_eyOYHc5IKCKdQfeskRttifCcYeVWkTojq3zQkcI2eaQKhJl-vQ2z1tVY33EQkMhYB4xCSgZ4UztKTx9BOjxZla8XKlqcDWckXht6uleAumsA0N8ZzakukJ?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcN1cRJV9hbCNPpar2rxdooZNJ7LDt2ytv30dOfFhgFRyJ3FQYsH3RIh3jqt0JXZXJs7tyxBS07K96SuTjTkEIwNco7hkftw2QC-GY8sipbZO7eoq0QYm_lJYD2ORgeOD9YmaqH?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

### **Predefined Commands**:&#x20;

Commands for completing tasks, querying points, levels, or rankings.\
Required permissions:

· View Channels

· Send Messages

These permissions allow the bot to view specific channels, control channel visibility, and send command-related messages.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcXclO7XrzkzUAidtvGo9JBZx4KJWjo_hc052KRpTuZdDdlpNXClkYc1StBWUxHC9UR82OnXMjuqdwX_OjMxa0nPKMvZExEEUVAFfImtK5Jpdx1tJIq9aal0kDZApI4F_Bfs521hA?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc2Cpj9BXSO4Oe8VsKHr46CtQJU5zfFvRxvd00LfU684sGHjwZRo3xtJtaMh6JaXkmR7K5UCUZnkQyCG1doLVzbWqBjFYalK4nRyr6_eXx0mphIjlNIxh3VvYNsKiYfvp8RPuODNw?key=0Ugs8HwP_vZfQwQiqIZ9vA" alt=""><figcaption></figcaption></figure>