# Voicemail

Ringless voicemail delivers an audio message directly to a recipient's voicemail box without ringing the phone. The recipient sees a new voicemail notification and can listen at their convenience. This is useful for non-urgent outreach where a live conversation is not required - appointment reminders, follow-up notifications, or care coordination messages.

## How It Works

1. **Create a use case** - Set up a `ringless_voicemail` use case tied to a telephony setup. The use case determines which phone number is used as the sender.
2. **Send a voicemail** - Upload an MP3 audio file (10-60 seconds, max 8 MB) along with the recipient's phone number. The platform selects the sender phone number from the use case configuration and delivers the message.
3. **Track delivery** - Each voicemail has a status that tracks whether the message was accepted, delivered, or failed. You can list voicemail records filtered by use case, status, or recipient.

## When to Use Ringless Voicemail

Ringless voicemail works well for:

* **Appointment reminders** - Remind patients of upcoming appointments without requiring them to answer a call
* **Follow-up notifications** - Notify patients about test results ready for review, prescription refills, or care plan updates
* **Outreach campaigns** - Reach patients for wellness checks, preventive care reminders, or survey participation

For situations that require a live conversation or immediate response, use [outbound calls](/channels/outbound.md) instead.

## Delivery and Status Tracking

Voicemail records track the lifecycle of each message. You can query voicemails by use case, setup, delivery status, or recipient phone number. This gives operations teams visibility into delivery rates and helps identify failed deliveries that may need follow-up through another channel.

Voicemail endpoints are available through the Platform API. See the [Developer Guide](https://docs.amigo.ai/developer-guide) for endpoint details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.amigo.ai/channels/voicemail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.