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

# Voicemail Detection

> Learn how to set up voicemail detection and personalize the messages your AI agents and workflows leave when reaching voicemail.

export const ArcadeEmbed = ({url, title}) => {
  return <div style={{
    position: "relative",
    paddingBottom: "calc(47.46527777777778% + 41px)",
    height: "0",
    width: "100%"
  }}>
      <iframe src={url} title={title} frameBorder="0" loading="lazy" allowFullScreen allow="clipboard-write" style={{
    position: "absolute",
    top: 0,
    left: 0,
    width: "100%",
    height: "100%",
    colorScheme: "light"
  }} />
    </div>;
};

<Info>
  **Never Miss an Opportunity**: Voicemail detection enables your AI agents and workflows to intelligently detect when a call reaches voicemail and leave personalized messages, ensuring your communication reaches your audience even when they can't answer.
</Info>

## Interactive Demo

See how to set up voicemail detection and custom messages for both simple agents and workflow agents:

<Tabs>
  <Tab title="Simple Agent Demo">
    <ArcadeEmbed url="https://demo.arcade.software/YqFxrN22WRh1mCBQV8iC?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Set Up Voicemail Message for AI Receptionist" />
  </Tab>

  <Tab title="Workflow Agent Demo">
    <ArcadeEmbed url="https://demo.arcade.software/HZcrNYmjhYKXANYKvSTa?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Set Up Voicemail Detection and Custom Voicemail Message in a Workflow" />
  </Tab>
</Tabs>

***

## Overview

Voicemail detection allows your AI agents to automatically detect when a call reaches voicemail. You can configure the agent to either hang up or leave a custom voicemail message, ensuring your communication reaches recipients even when they can't answer.

***

## Set Up Voicemail Detection for Simple Agents

Follow these steps to configure voicemail detection for your AI voice agent:

### Step 1: Navigate to Simple Agents

From your dashboard sidebar, click on **Simple Agents**.

<Frame>
  <img src="https://mintcdn.com/openmic-ea75a20d/IJQka_kByvoY1sol/images/agents/room-settings/voicemail-detection/simple/call-settings.png?fit=max&auto=format&n=IJQka_kByvoY1sol&q=85&s=51f97d57945f1d698ba75f885efa2702" alt="Simple Agents - Call Settings" width="1920" height="1080" data-path="images/agents/room-settings/voicemail-detection/simple/call-settings.png" />
</Frame>

***

### Step 2: Select Your Agent

Click on the agent you want to configure from the list.

***

### Step 3: Open Call Settings

Click on the **Call Settings** tab in the agent configuration.

***

### Step 4: Enable Voicemail Detection

1. Locate the **Voicemail Detection** section
2. Toggle the switch to **ON**
3. Click the **Configure** button

<Frame>
  <img src="https://mintcdn.com/openmic-ea75a20d/IJQka_kByvoY1sol/images/agents/room-settings/voicemail-detection/simple/voicemail-detection.png?fit=max&auto=format&n=IJQka_kByvoY1sol&q=85&s=482e825a8a0b5706fb559df9ecd49bde" alt="Enable Voicemail Detection" width="515" height="131" data-path="images/agents/room-settings/voicemail-detection/simple/voicemail-detection.png" />
</Frame>

<Note>
  When enabled, the agent will automatically detect voicemail and perform the action you configure.
</Note>

***

## Set Up Voicemail Detection for Workflows

Follow these steps to configure voicemail detection for your workflow agent:

### Step 1: Navigate to Workflow Agents

From your dashboard sidebar, click on **Workflow Agents**.

<Frame>
  <img src="https://mintcdn.com/openmic-ea75a20d/IJQka_kByvoY1sol/images/agents/room-settings/voicemail-detection/workflows/select-workflow.png?fit=max&auto=format&n=IJQka_kByvoY1sol&q=85&s=67933ba9400643adebcacc79b1205949" alt="Workflow Agents List" width="1920" height="1080" data-path="images/agents/room-settings/voicemail-detection/workflows/select-workflow.png" />
</Frame>

***

### Step 2: Select Your Workflow

Click on the workflow you want to configure from the list.

***

### Step 3: Open Global Settings

In the workflow editor, click the **Global Settings** button in the top right corner.

<Frame>
  <img src="https://mintcdn.com/openmic-ea75a20d/IJQka_kByvoY1sol/images/agents/room-settings/voicemail-detection/workflows/open-global-settings.png?fit=max&auto=format&n=IJQka_kByvoY1sol&q=85&s=c2f5142e1ff9e88bad7c38bfb3dcf26b" alt="Workflow Editor - Global Settings Button" width="1920" height="1080" data-path="images/agents/room-settings/voicemail-detection/workflows/open-global-settings.png" />
</Frame>

***

### Step 4: Enable Voicemail Detection

1. In the Global Settings panel, locate the **Call Settings** section
2. Find the **Voicemail Detection** option
3. Toggle the switch to **ON**
4. Click the **Configure** button

<Frame>
  <img src="https://mintcdn.com/openmic-ea75a20d/IJQka_kByvoY1sol/images/agents/room-settings/voicemail-detection/workflows/voicemail-detection.png?fit=max&auto=format&n=IJQka_kByvoY1sol&q=85&s=34484706059180dc6f12eee093a51110" alt="Voicemail Detection in Call Settings" width="447" height="256" data-path="images/agents/room-settings/voicemail-detection/workflows/voicemail-detection.png" />
</Frame>

***

### Step 5: Save the Workflow

Click the **Save** button in the top right corner to apply your changes.

***

## Configure Voicemail Detection

After enabling voicemail detection (for both Simple Agents and Workflows), you'll need to configure how it behaves:

<Frame>
  <img src="https://mintcdn.com/openmic-ea75a20d/IJQka_kByvoY1sol/images/agents/room-settings/voicemail-detection/configure.png?fit=max&auto=format&n=IJQka_kByvoY1sol&q=85&s=b13d3c9c74d7555024ad5994e99521d7" alt="Voicemail Detection Configuration" width="853" height="619" data-path="images/agents/room-settings/voicemail-detection/configure.png" />
</Frame>

### Action

Choose what happens when voicemail is detected:

<Tabs>
  <Tab title="Hang up if reaching voicemail">
    The agent will immediately end the call when voicemail is detected without leaving a message.

    **Best for:**

    * When you only want to reach live contacts
    * Compliance requirements that restrict automated voicemail messages
    * High-volume calling campaigns
  </Tab>

  <Tab title="Leave a message if reaching voicemail">
    The agent will deliver a custom voicemail message when voicemail is detected.

    **Best for:**

    * Ensuring your communication reaches the recipient
    * Appointment reminders and follow-ups
    * Customer service callbacks
    * Sales and lead nurturing
  </Tab>
</Tabs>

***

### Voicemail Message

If you selected "Leave a message if reaching voicemail", configure your message:

<Tabs>
  <Tab title="Prompt">
    Use dynamic, AI-generated messages based on the conversation context and agent's prompt instructions.

    **How it works:**

    * The AI composes the voicemail message on the fly
    * Can adapt based on conversation history
    * More natural and contextual

    **Example use case:** "Generate a voicemail explaining why I called based on the customer's recent support ticket."
  </Tab>

  <Tab title="Static Sentence">
    Use a fixed, pre-written message that will be delivered every time.

    **How it works:**

    * Type your exact message in the text field
    * The same message is used for every voicemail
    * Consistent and predictable

    **Example:**

    ```
    Hey, sorry we could not reach you directly. Please give us a callback if you can.
    ```
  </Tab>
</Tabs>

<Tip>
  Keep voicemail messages brief (20-30 seconds) and include a clear call-to-action with your callback number or next steps.
</Tip>

***

### Save Configuration

Click **Save** to apply your voicemail detection configuration.

<Note>
  For workflows, remember to also click **Save** on the workflow editor after configuring voicemail detection.
</Note>

***

## Best Practices

<AccordionGroup>
  <Accordion title="Keep Messages Concise" icon="clock">
    * Aim for 20-30 seconds maximum
    * State your name and company clearly
    * Provide a clear call-to-action
    * Include a callback number or next step
  </Accordion>

  <Accordion title="Test Your Configuration" icon="vial">
    * Call the agent yourself and let it go to voicemail
    * Test with different voicemail systems (mobile, landline)
    * Verify the message is complete and sounds natural
    * Check that the right action (hang up or leave message) is triggered
  </Accordion>

  <Accordion title="Use Appropriate Action" icon="check-circle">
    * **Hang up** for high-volume outbound campaigns where you only need live conversations
    * **Leave message** for important communications like appointment reminders, follow-ups, or customer service
  </Accordion>

  <Accordion title="Write Natural Messages" icon="message">
    * Use conversational language
    * Avoid complex terminology or long sentences
    * Read the message aloud to check if it sounds natural
    * Include specific information (reason for call, action needed)
  </Accordion>
</AccordionGroup>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How accurate is voicemail detection?">
    Voicemail detection is highly accurate across most phone systems and carriers. The system listens for voicemail indicators like beeps, greetings, and audio patterns. If you experience issues, test with different carriers and review your call logs.
  </Accordion>

  <Accordion title="Can I use variables in voicemail messages?">
    When using the **Prompt** option, the AI can incorporate context from the conversation. With **Static Sentence**, the message is fixed and cannot include dynamic variables.
  </Accordion>

  <Accordion title="What happens if detection fails?">
    If the system cannot confidently detect voicemail, it will continue with the normal call flow. You can review detection performance in your call logs and analytics.
  </Accordion>

  <Accordion title="Can I update my voicemail message later?">
    Yes, you can update your voicemail configuration at any time. Changes will apply to all new calls immediately.
  </Accordion>
</AccordionGroup>

***

## Need Help?

If you encounter issues or have questions about voicemail detection:

* Review your call logs to see detection performance
* Test with different phone numbers and carriers
* Contact support for assistance with configuration
* Check that voicemail detection is enabled in Call Settings

<Info>
  For technical support, contact our support team.
</Info>
