Category: Inbound & Outbound | Node Type: Voice
Version: 1.0 | Last Updated: Nov 2025
Overview
The Play Node allows you to play an audio file during an active call.
It is typically used for:
Welcome messages
Informational prompts
Compliance announcements
On-hold audio or waiting messages
Pre-routing instructions
This node plays an audio file from a URL and supports looping the audio multiple times.
How It Works
When the flow reaches the Play Node:
The system fetches the audio file from the provided URL.
The audio is played to the caller.
If Loop Count is greater than 1, the file will repeat until the loop count is completed.
The node will continue playing until the audio finishes or the configured Timeout is reached.
After playback finishes, the flow moves to the next node.
The Play Node does not answer the call by itself.
If used before an Answer Node, audio will not be heard unless your routing setup intentionally allows early-media behavior.
Node Settings
Setting | Type | Required | Default | Description |
Audio File URL | Text (URL) | Yes | None | A publicly accessible |
Loop Count | Number | Yes | 1 | Number of times the audio file should repeat. |
Timeout (seconds) | Number | Yes | 30 | Maximum time to wait for playback to finish before continuing the flow. |
Notes
The caller hears the configured audio normally.
Playback result is logged (start time, end time, duration).
The flow moves to the next node in sequence.
If playback fails (e.g., unreachable file), the system logs an error and continues the flow automatically.
Troubleshooting & Tips
If no audio plays, confirm the URL is public and accessible from the internet.
Large audio files may cause delays; keep files short and optimized.
If ringback is still heard, check whether the Play Node is placed after the Answer Node.
Use high-quality audio for greetings and compliance messages for the best caller experience.
When creating looping audio, you can use a shorter audio file and increase the Loop Count.


