---
updatedAt: 2026-02-25T15:12:50.000Z
agentTools:
  projectIndex: https://developers.newo.ai/llms.txt
---

# CallDefineVoiceMail

The CallDefineVoiceMail action automatically detects whether an inbound voice call has reached a voicemail system, a spam caller, or a call screening system. When the AI Employee begins a phone conversation, this action analyzes the caller's responses to classify the call and take appropriate action — such as leaving a voicemail message, hanging up on spam, or handling a gatekeeper prompt.

**Triggering events:**

* `conversation_started` — Checks the caller's phone number against the blocked numbers list.
* `user_message_transcription_finished` — Analyzes the conversation after the first user message is transcribed.

## How it works

1. When a call starts, the action checks the caller's phone number against the blocked numbers list. If the number is blocked, the call is terminated immediately.
2. After the first user message is transcribed, the action retrieves the conversation history and analyzes it using structured generation.
3. The analysis classifies the call as one of:
   * **Voicemail** — Detected phrases like "leave a message," "after the tone," or "not available."
   * **Spam** — Caller ignores topics, interrupts repeatedly, or uses repetitive sentences.
   * **Call screening** — Gatekeeper systems, iOS call screening prompts, or busy announcements.
   * **Human** — Legitimate caller, no action taken.
4. If voicemail or spam is detected, the action marks the persona attributes accordingly and can initiate a voicemail-specific response or hang up.

## Configuration

| **Attribute**                                                           | **Description**                                                                                                   |
| ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `project_attributes_setting_check_spam_or_voicemail`                    | Set to `"True"` to enable voicemail and spam detection.                                                           |
| `project_attributes_setting_voice_integration_service`                  | The voice integration in use: `"NEWO Voice Integration"`.                                                         |
| `project_attributes_setting_voice_stop_call_timeout`                    | Seconds to wait before disconnecting after detection. Default: `6`.                                               |
| `project_attributes_setting_blocked_phone_numbers`                      | JSON array of phone numbers to block on inbound calls.                                                            |
| `project_representative_agent_voicemail_detection_behavior_instruction` | Custom instruction for how the agent should behave when voicemail is detected (e.g., leave a message or hang up). |

## Persona attributes set

The action writes the following persona attributes during detection:

| **Attribute**               | **Description**                                                      |
| --------------------------- | -------------------------------------------------------------------- |
| `voicemail_checked`         | Set to `"true"` after the voicemail check completes.                 |
| `voicemail_detected`        | Set to `"true"` if a voicemail system was detected.                  |
| `screening_system_handled`  | Set to `"true"` if a gatekeeper or screening system was encountered. |
| `busy_announcement_handled` | Set to `"true"` if a busy announcement was detected.                 |

## Example

Enable voicemail and spam detection for your project by setting the following attributes in the Builder:

```
project_attributes_setting_check_spam_or_voicemail = "True"
project_attributes_setting_voice_stop_call_timeout = "6"
```

To block specific phone numbers from reaching the AI Employee:

```json
project_attributes_setting_blocked_phone_numbers = ["+15551234567", "+15559876543"]
```

To customize what the agent says when it detects a voicemail system:

```
project_representative_agent_voicemail_detection_behavior_instruction = "Leave a brief message with the business name, reason for calling, and a callback number."
```