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
- 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.
- After the first user message is transcribed, the action retrieves the conversation history and analyzes it using structured generation.
- 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.
- 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:
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."Updated 1 day ago