# 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="/files/YTPg40tUqIIx7ie7uSOc" 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>


---

# 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/entity-hub-for-business-end/community-hub/bot-integrated/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.