> For the complete documentation index, see [llms.txt](https://docs.sonoransoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonoransoftware.com/bot/tutorials/getting-started.md).
# Getting Started
Sonoran Bot supports role sync with [Sonoran CAD](/bot/tutorials/sonoran-cad-integration.md) and [Sonoran Radio](/bot/tutorials/sonoran-radio-integration.md). Or, Sonoran Bot can sync roles with [Sonoran CMS](/bot/tutorials/sonoran-cms-integration.md) ranks. CMS ranks manage CAD, Radio, Drive, website, whitelisting, and more.
{% hint style="warning" %}
All commands require at least the `Manage Server` permission on the Discord server you are running the commands in. You will also need a number of other permissions upon inviting the bot.
{% endhint %}
### 1. Invite the Bot to Your Server
Inviting Sonoran Bot
[Invite the bot to your Discord server](https://sonoranbot.com/invite). You must have the "Manage Server" permission to add bots; plus any permissions the bot requires to function. You will also be joined to our support server (Sonoran Software Systems) automatically.
### 2. Setup the Bot and Link your Communities
Setting up Sonoran Bot
After inviting the bot, run the `/settings` command. You will then be prompted to select a logging channel for Sonoran Bot to use.
Next, the bot will ask you if you are using Sonoran CMS or if you wish to manage Sonoran CAD/Radio manually with Discord roles.
Enter your community ID and API key for [Sonoran CAD](https://docs.sonoransoftware.com/cad/api-integration/getting-started/retrieving-your-credentials) and/or [Sonoran Radio](https://docs.sonoransoftware.com/radio/developer-documentation/developer-documentation/api-endpoints-v2/retrieving-your-credentials).
If you are using [Sonoran CMS](https://sonorancms.com/) to manage your community, you only need to enter your [CMS community ID and API key](https://docs.sonoransoftware.com/cms/developer-api-documentation/api-integration/getting-started/retrieving-your-credentials). Sonoran CMS manages your [CAD](https://docs.sonoransoftware.com/cms/integration-capabilities/sonoran-cad-sync) and [Radio](https://docs.sonoransoftware.com/cms/integration-capabilities/sonoran-radio-sync) permissions inside the app with CMS user ranks.
### 3. Invite to Additional Servers
If your community uses multiple discord servers, you can link them all to the same community to utilize the permissions sync easily. Simply set them up normally as you just did, and they will automatically be synced! You will be able to use the bot's commands just like on the primary server.
### 4. Set up Integrations
At this point, you will need to select either CAD or CMS integration. We highly encourage users to make use of the CMS integration as the CMS can integrate with the CAD on its own!
* [CMS Integration](/bot/tutorials/sonoran-cms-integration.md)
* [CAD Integration](/bot/tutorials/sonoran-cad-integration.md)
* [Radio Integration](/bot/tutorials/sonoran-radio-integration.md)
* [Settings](/bot/tutorials/usage/settings.md)
* [Commands](/bot/tutorials/usage/commands.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.sonoransoftware.com/bot/tutorials/getting-started.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.