# Voice note (/ui/candidate-voice-note)

## What it shows [#what-it-shows]

A hook that lets a note be spoken from a card.

## Props [#props]

### useCandidateVoiceNote, its options [#usecandidatevoicenote-its-options]

| Prop | Type | What it does |
| --- | --- | --- |
| `onCommit` (required) | `(text: string) => void \| Promise<void>` | Called with the transcript when a person finishes dictating. |
| `title` | `string` | The trigger's tooltip and the dictation overlay's title. |
| `caption` | `string` | The small caption in the dictation overlay. |

### useCandidateVoiceNote, what it returns [#usecandidatevoicenote-what-it-returns]

| Prop | Type | What it does |
| --- | --- | --- |
| `trigger` (required) | `ReactNode` | A quiet mic icon action, for a card's header actions. |
| `control` (required) | `ReactNode` | The dictation control itself, visually hidden. Render it once, anywhere inside the card: the trigger and `open` drive it. |
| `open` (required) | `() => void` | Opens the dictation overlay, for a host control of its own. |

## Data it needs [#data-it-needs]

The component takes plain values and callbacks and keeps no records of its own. Pass it yours, from the Kith data layer or from a backend you already run.

## Copy to your agent [#copy-to-your-agent]

```text title="Copy to your agent"
Install RecruiterOS/recruit-ui and add a spoken note to a candidate card with the useCandidateVoiceNote hook.
```