# Permission

You can find a detailed list of permissions and why we need them [here](https://communityone.io/bot-security/).

Three sensitive permissions that we need

* Manage Server
* Manage Role
* Manage Channels

**Why do we need Manage Server permission?** 

To track bot user activity on our analytics dashboard, we access system messages from your server logs to analyze user behavior. If you are a web3 community that is aggressively marketing, granting this permission enables us to deliver highly reliable, live analytics. You can continue to check out your analytics, but without details about bot users if you don't give us permission.

If you enable [Collab](/communityone/feature-deepdive/hype-engine/collab.md), we need manage server permissions to create a unique invite link per collab so that we can track how effective each collab is.

**Why do we need Manage Role permission?** 

This permission allows us to tag new users and notify them about a private onboarding channel with our Spark, which you can configure via Spark auto-onboarding feature. It also lets us tag you with important alerts, especially updates and changes that you've done via our dashboard. You can use most of our spark except for the private onboarding feature.

With Hype Engine, we require Manage Role permission if you put a custom role as a reward in the item shop. We automatically grant users the roles. 

**Why do we need Manage Channels permission?** 

This permission allows us to create a communityone-alert channel in your server, where you'll receive notifications about bot configuration changes, updates, and errors. We'll inform you when changes are reflected as you modify your bot via our web dashboard. Additionally, it lets us create private onboarding channels, allowing new users to interact with Spark in a private channel to increase engagement rate. You can set up all features via communityone.io/dashboard without this permission, but you won't get an update on your Discord if something goes wrong. You can use most of our spark except for the private onboarding feature.

With Hype Engine, we require Manage Channel permissions so that we can create (1) a leaderboard channel where we give daily updates on the top 10 players and (2) an item-shop channel where users can redeem their points. 

{% hint style="info" %}
Join [Discord](https://discord.gg/nVqt3z78Mw) for questions, comments, and a little gift <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f381/512.gif" alt="🎁" data-size="line"> or back to [CommunityOne Home](https://communityone.io/)
{% endhint %}


---

# 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://communityone.gitbook.io/communityone/feature-deepdive/permission.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.