> For the complete documentation index, see [llms.txt](https://docs.amigo.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.amigo.ai/channels/voicemail.md).

# 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.

Public Platform API callers configure ringless voicemail through use cases and channel setup. Direct voicemail send/list operations are managed by Amigo-operated channel infrastructure rather than exposed as workspace-scoped Platform API endpoints.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.