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

# Voicemail

> Record voicemail with transcription and notifications

The **Voicemail** node records a voicemail from the caller, optionally transcribes it, and sends notifications via email or webhook.

## Behavior

* Plays a custom greeting (if configured), then a beep
* Records the caller's message up to the configured max duration
* Stops recording on silence timeout
* Optionally transcribes the recording
* Sends notifications with the recording and transcript

## Configuration

| Parameter               | Type    | Default | Range  | Description                                                                  |
| ----------------------- | ------- | ------- | ------ | ---------------------------------------------------------------------------- |
| `greeting`              | string  | `""`    | —      | Custom greeting message played before the beep. Leave empty for no greeting. |
| `maxDuration`           | number  | `120`   | 10–600 | Maximum recording duration in seconds                                        |
| `beepEnabled`           | boolean | `true`  | —      | Play a beep tone before recording starts                                     |
| `transcribeEnabled`     | boolean | `true`  | —      | Transcribe the voicemail using speech-to-text                                |
| `transcriptionLanguage` | string  | `"en"`  | —      | Language code for transcription (e.g., `en`, `es`, `fr`)                     |
| `notifyEmail`           | string  | `""`    | —      | Email address to notify when a voicemail is received                         |
| `notifyWebhook`         | string  | `""`    | —      | Webhook URL to POST voicemail data to                                        |
| `allowRerecord`         | boolean | `true`  | —      | Allow the caller to re-record their message                                  |
| `silenceTimeout`        | number  | `5`     | 1–30   | Stop recording after this many seconds of silence                            |

## Use cases

<AccordionGroup>
  <Accordion title="After-hours voicemail">
    Time Check (Closed) → TTS ("Leave a message after the beep") → Voicemail → End Call. Configure `notifyEmail` to send the recording to your team.
  </Accordion>

  <Accordion title="Transfer fallback">
    Transfer (Timeout/Failed) → Voicemail. When no agent is available, capture the caller's message and notify via webhook for CRM integration.
  </Accordion>

  <Accordion title="Multi-language voicemail">
    Use a Switch node on the caller's language preference, then route to separate Voicemail nodes with matching `transcriptionLanguage` values.
  </Accordion>
</AccordionGroup>
