> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sonoransoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dispatch AI

> Use voice commands to control your radio, set timers, and work with Sonoran CAD across games.

Dispatch AI helps you control Sonoran Radio and work with Sonoran CAD by voice. Change channels, manage scanned channels, set timers, review your current CAD call, and more while playing.

![Sonoran Radio Dispatch AI](https://docs-assets.sonoransoftware.com/sha256/cf/cf6ed1bcb6fdccfe0270c7c90ad4f6742d657b3b629929a228493745d9b47ef4.webp)

> [!WARNING]
>
> Dispatch AI is in public beta. Usage limits depend on your community's [subscription](/radio/pricing/pricing-faq/standalone-pricing#dispatch-ai); a free tier is available.

## Common Setup

Complete this setup once for each Radio server using Dispatch AI. **The current setup requires a linked Sonoran CAD community, including for radio commands.**

1. In Sonoran CAD, open **Admin** > **Advanced** > **In-Game Integration** > **Web API**. Copy the community ID and API key.
2. In CAD, open **Admin** > **Customization** > **Servers** and note the server ID. The default is `1`.
3. In Radio's admin panel, open **Customization** > **Dispatch AI**. Select a Radio server or use **+** to create one.
4. Under **Link Sonoran CAD**, enter the CAD community ID, API key, and server ID. Fields save automatically when you leave them.
5. Toggle **Dispatch AI Enabled** on.
6. Sign in to Radio with your Sonoran account, join that Radio server, and connect to a channel. Use the same account in CAD for actions involving your unit.

This CAD API link is also required for [desktop overlay panic synchronization](/radio/tutorials/integrations/sonoran-cad-integration#desktop-overlay-panic). Configure it for the Radio server used by your overlay. Panic synchronization works even when **Dispatch AI Enabled** is off.

![Dispatch AI configuration showing enable controls, timer settings, and the Sonoran CAD link](https://docs-assets.sonoransoftware.com/sha256/31/319a68757bf6ad5cb5fbef824e77d3f7730469bd3085da7285ac3120081c286a.jpg)

*Configure Dispatch AI for the selected Radio server.*

## Using the AI

Hold push-to-talk and start your request with **Dispatch**, the default wake word. For example: “Dispatch, switch me to TAC 1.” Wait for the AI's response before making another request.

When the first user connects, allow a few seconds for the “Dispatch Online” announcement.

> **Wake words and hotkeys**
>
> 1. Open **Settings** > **AI** to configure your wake word. Use the microphone button to record a custom wake word.
> 2. For a manual trigger in the web or desktop app, open **Settings** > **Hotkeys** and set **AI Toggle**.
> 3. Hold push-to-talk, activate the AI, and speak your request.
>
> Listen for the activation beep. Say the wake word near the start of your transmission.
>
> ![Dispatch AI wake word settings](https://docs-assets.sonoransoftware.com/sha256/86/8696ef95183ed9afbe869f4290f6a90069b89040960c9f253464dce15be89c70.png)
>
> FiveM players can also use the [in-game AI keybind](/radio/game-integrations/fivem/fivem#setup).

## Radio Commands

These commands work across games, including **FiveM, ER:LC, and Arma 3**. Use the channel names configured by your community.

| Action | Example |
| - | - |
| Change your primary transmit channel | “Dispatch, switch me to TAC 1.” |
| Move another connected user | “Dispatch, move A-12 to Dispatch.” |
| Add a scanned channel | “Dispatch, add Fire to my scanned channels.” |
| Remove a scanned channel | “Dispatch, remove Fire from my scanned channels.” |
| Hear your current channels | “Dispatch, what channel am I on?” |

Channel changes respect community access permissions. Moving another user requires permission to move clients. Include the group name when several channels have the same name, or answer the AI's clarification.

## Timers

Ask for a timer by duration and, optionally, a purpose. Dispatch AI tells you when it expires.

| Action | Example |
| - | - |
| Start a timer | “Dispatch, set a timer for five minutes.” |
| Start a named timer | “Dispatch, start a two-minute PIT timer.” |
| Cancel your timer | “Dispatch, cancel my timer.” |

You can have one active timer in the Radio server. Starting another replaces it. Timers must be at least 10 seconds and no longer than the community's configured maximum, up to 30 minutes.

> **Configure community timer limits**
>
> 1. Open **Customization** > **Dispatch AI** and select the Radio server.
> 2. Under **Dispatch Timers**, turn **Enable dispatch timers** on or off.
> 3. Set **Maximum timer duration (minutes)** from `1` to `30`. Leave the field to save.
>
> The default maximum is 30 minutes. See the [setup screenshot](#common-setup) for these controls.

## Sonoran CAD Commands

CAD actions use the community and server linked in [Common Setup](#common-setup). Be on duty with the appropriate unit selected in CAD when asking about your status or current call.

> **Review your current call**
>
> Ask the AI to repeat the details of the CAD dispatch call you are attached to.
>
> “Dispatch, repeat my current call.”
>
> You can also ask about the latest call or give a short correction to a recent request, such as “Dispatch, actually, the plate is ABC124.” Be specific if several calls or units could match.

> **Status, lookups, and panic**
>
> | Action | Example |
> | - | - |
> | Update your status | “Dispatch, A-10, mark me available.” |
> | Update another unit's status | “Dispatch, set B-11 to 10-8.” |
> | Run a plate lookup | “Dispatch, run the plate ABC123.” |
> | Run a name lookup | “Dispatch, check John Doe.” |
> | Toggle panic | “Dispatch, toggle my panic status.” |
>
> Use your community's configured status codes. Lookup results are sent to CAD with a brief radio response.

> **Create and manage calls**
>
> | Action | Example |
> | - | - |
> | Create a call | “Dispatch, show me out on traffic with a blue sedan, plate ABC123.” |
> | Attach to a call | “Dispatch, attach me to the robbery in progress.” |
> | Attach another unit | “Dispatch, attach B-11 to my call.” |
> | Add a note | “Dispatch, add a note to my call: the vehicle is white.” |
> | Detach yourself | “Dispatch, clear my call.” |
> | Close the call | “Dispatch, close my call.” |
>
> New calls use your unit's location when available unless you specify another location. Including a plate in a new call also runs a plate lookup.

> **Unit groups**
>
> “Dispatch, add me and B-11 to group Ladder 12.”
>
> “Dispatch, clear my unit group.”
>
> Use the unit number or name to identify other units.

## Game-Specific Features

The shared commands above apply across games. Choose your game for additional setup and integrations.

> **[FiveM](/radio/game-integrations/fivem/fivem)**
>
> Emergency call readouts, GPS routing, and automatic arrival status.

> **[ER:LC](/radio/game-integrations/roblox/erlc)**
>
> Read emergency calls over the channels assigned to each map zone.

> **[Arma 3](/radio/game-integrations/arma-3/arma-3)**
>
> Use shared radio commands and timers from the desktop overlay.

## Customization

> **Community phrases and human dispatchers**
>
> Open **Customization** > **Dispatch AI** and select the Radio server.
>
> * Expand an action under **Example prompts** to add short examples of your community's radio phrases.
> * Use the human-dispatcher button to choose whether AI stays active or pauses when a dispatcher is active in CAD.
>
> Keep example phrases short and specific.

> **Language, transcripts, and phrase corrections**
>
> Open **Settings** > **AI** to choose the AI language, review **Recent Transcripts**, or add **Phrase Overrides** for commonly misheard words. The AI uses the app's language by default.
>
> ![Recent transcripts and phrase override controls](https://docs-assets.sonoransoftware.com/sha256/ee/eee896a7a4531da2ccde8d6e8ec57cef662ceaa6c38b84ae0e840aec1c11403a.png)

> **AI volume and replies**
>
> Adjust **AI Volume** under **Settings** > **Audio**. In the AI settings, choose whether to hear replies to other users or only replies directed to you.
>
> ![Settings for hearing Dispatch AI replies](https://docs-assets.sonoransoftware.com/sha256/07/075077af99587d672c3800c75bb6144bdddba952d0e2036c8d0fb1f6119f12da.png)

## Token Usage

View your community's usage under **Settings** > **AI** > **Token Usage**, or in the admin **Dispatch AI** panel. Limits reset on the first of each month. Once the limit is reached, further AI requests are unavailable until the reset or a subscription upgrade.

See [Dispatch AI usage limits](/radio/pricing/pricing-faq/standalone-pricing#dispatch-ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.