> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/watch-admin-menu/features/voice-notes-and-staff-voice.md).

# Voice notes and staff voice

Two things: **voice notes**, short recordings in staff chat and tickets, and the **staff voice channel**, a radio channel only staff can join through pma-voice. Neither one turns speech into text.

## Voice notes

The microphone button sits beside **Send** in **Staff chat** and in a ticket's reply box, in game and on the web panel.

1. Press the microphone and speak. Recording stops by itself at the longest note allowed.
2. Press the square to stop. You can listen before it goes anywhere.
3. **Send** posts it, **Discard** throws it away. Nothing is uploaded before Send.

A note plays in the message with play, pause and a progress bar. Notes sent in game play on the web and the other way round.

| Sent in                          | Who hears it                                           |
| -------------------------------- | ------------------------------------------------------ |
| A chat channel or direct message | Whoever can see that channel.                          |
| A ticket reply                   | The player too, like a screenshot in the conversation. |
| A ticket's internal notes        | Not offered, because the note would reach the player.  |

**Players:** with `notes.players = true` the player's own ticket window gets the microphone too, up to `playerMaxPerTicket` notes per ticket. Off by default.

### Where notes are kept

Notes are stored on fivemad.com, not in your database. So:

* Voice notes need `rm_watch_key`, even if your staff never open the web panel.
* fivemad deletes a note after `retentionDays` (at most 90). The message stays and says the note is gone.
* Each server has a storage quota (200 MB unless we tell you otherwise, roughly 14 hours of speech). When it is full, new notes are refused with a message until older ones expire.

### The microphone

* **In game** the menu records from the **default recording device set in Windows**. FiveM does not let a page pick another one. If the microphone is blocked or missing, the button says so instead of recording.
* **On the web panel** the browser asks for the microphone the first time. If you said no, allow it again from the padlock in the address bar.

A minute of speech is about 240 KB.

## Staff voice channel

The **Staff voice** tab joins you to a pma-voice radio channel kept for staff (`cfg.voice.channel.number`, 1337 by default). Everyone in it hears you while you hold push to talk.

* **Join the channel** and **Leave the channel**. The list shows who is in it, with a mark on whoever is talking.
* Push to talk defaults to **Right Alt** (`pushToTalk = 'RMENU'`). Each staff member can rebind it in **Settings > Key Bindings > FiveM** ("Staff voice: push to talk"). pma-voice's own radio key works too.
* pma-voice gives a player one radio channel at a time. Joining leaves the channel you were on, and leaving puts you back on it (`restorePrevious`).
* The web panel's **Staff voice** page shows who is in the channel and who is talking. There is no voice in the browser.

Joining needs the `voice:join` right. pma-voice itself refuses anyone else who tries to tune in by hand, and every few seconds rm\_watch takes out anyone who may no longer be there (demoted, or off duty with `onDuty = true`), and tells them why.

{% hint style="warning" %}

* Pick a channel number no radio script of yours hands out or guards. pma-voice keeps one access check per channel, and the last resource to add one wins.
* The channel needs pma-voice with radios on. With `setr voice_enableRadios 0` the tab says the channel is not available.
  {% endhint %}

## Configuration

```lua
cfg.voice = {
    notes = {
        enabled = true,
        maxSeconds = 60,          -- 5 to 180
        maxKB = 400,              -- 32 to 1024
        retentionDays = 30,       -- 1 to 90
        players = false,          -- players may attach notes to their own ticket
        playerMaxPerTicket = 3,
    },
    channel = {
        enabled = true,
        number = 1337,            -- the pma-voice radio channel for staff
        pushToTalk = 'RMENU',     -- default key, right Alt
        onDuty = false,           -- only staff on duty may join
        restorePrevious = true,   -- leaving puts you back on your old radio channel
    },
}
```

## Permissions

In the **Staff chat** category, moderator by default:

| Action           | Allows                                                                                               |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| `voicenote:send` | Recording and sending notes. A note in a channel also needs `chat:send`, in a ticket `ticket:reply`. |
| `voicenote:get`  | Playing notes.                                                                                       |
| `voice:join`     | Joining the staff channel. Leaving is always allowed.                                                |

{% hint style="info" %}
**RedM:** there are no key bindings. pma-voice's own radio key, **\[** on RedM, talks in the staff channel. `cfg.voice.channel.pushToTalk` can add a game control of your own. See [Differences from FiveM](https://docs.rainmad.com/resources/watch-admin-menu/redm/differences-from-fivem#keys).
{% endhint %}
