For the complete documentation index, see llms.txt. This page is also available as Markdown.
Sonoran Radio Integration
Sync Sonoran Radio permissions with Discord roles for easy management!
Sonoran Radio Integration
Sonoran Bot makes managing your Sonoran Radio permissions a breeze! Map specific permissions to Discord roles. Users with those Discord roles will be granted the assigned permissions.
Sonoran Radio role mapping is not available when Sonoran Bot is in CMS mode. Sonoran CMS manages your CAD and Radio permissions inside the app with CMS user ranks.
If you already have Sonoran Bot configured for another product, you can add the Radio community ID and API key in the /settings menu under API Menu > Change Radio Setup.
/settings -> API Menu -> Change Radio Setup
After the Radio credentials are saved, the bot enables one of these sync modes automatically:
RADIO if only Radio is configured
CAD_RADIO if both CAD and Radio are configured
CMS_BIDIR if CMS is configured
CMS takes priority over CAD and Radio sync. If CMS credentials are present, live role sync runs through the CMS path until CMS is removed from the community setup.
Radio credentials are saved without setup-time validation. The first real validation usually happens when you open the Radio role mapping menu or run /sync.
2. Create a Radio Bit Map
Generating Radio Bit Maps
In Sonoran Radio, navigate to Members > Permission Generator
Toggle the desired permissions to generate a bit map below. Toggling private channels will add the channel IDs as a comma separated list at the end.
Once complete, copy the bit map to be entered into Sonoran Bot.
3. Configure Role Mapping
Configuring Radio Role Mapping
Run /rolemap to configure how Discord roles translate into Sonoran Radio access.
If your community is in CAD_RADIO mode, the bot first asks whether you want to manage CAD mappings or Radio mappings. If your community is in RADIO mode, the bot opens the Radio mapping menu directly.
/rolemap product selector in CAD_RADIO mode
/rolemap Radio main menu showing selector
Select the Discord role you wish to map to specific Radio permissions. Enter the radio permission bit map from the previous step.
Selected Radio role view in /rolemap
To delete an existing role mapping, edit it and enter 0 as the value.
4. Syncing Users
Syncing User Permissions
In order for the bot to sync users in your radio community, their Sonoran account must be linked to Discord. Users can run /linkme to link their Discord to their Sonoran Software account.
User permissions are synced across all linked Discord guilds. If you have multiple Discord servers linked to the same Sonoran community, the bot gathers all of them and checks the member's roles across every linked server that the bot is in.
Automatic Sync
Sonoran Bot will automatically sync and update Radio permissions on:
Discord role changes
Members exiting the Discord guild
Members being banned from the Discord guild
Manual Sync
Users can run /sync to force a manual permission sync.
Administrators can force a community-wide sync by running /sync community: yes
Troubleshooting
If Radio sync does not work, check these first:
Confirm the user's Sonoran account is linked to Discord (/linkme).
Confirm the correct Sonoran Radio community ID and API key are saved.
Confirm the Discord role is actually mapped in /rolemap.
Confirm the permission integer was generated correctly.
Run /sync manually to test the user.
If /rolemap or /sync fails immediately after setup, the most likely causes are invalid Radio credentials or a missing linked Sonoran account.
