Behavior
- Streams audio from the configured URL
- Optionally loops the audio a specified number of times
- Emits
AUDIO.COMPLETEwhen playback finishes orAUDIO.ERRORon failure
Configuration
| Parameter | Type | Default | Range | Description |
|---|---|---|---|---|
audioSource | enum | "url" | url | Audio source type |
audioUrl | string | "" | — | URL of the audio file to play |
loop | boolean | false | — | Enable looping playback |
loopCount | number | 1 | 1–10 | Number of times to loop (only applies when loop is true) |
Output handles
| Handle | Description |
|---|---|
| Complete | Audio finished playing — flow continues to the next node |
| Error | Playback failed (invalid URL, network error, unsupported format) |
Output variables
| Variable | Type | Description |
|---|---|---|
duration | number | Duration of the played audio in milliseconds |
Use cases
Hold music
Hold music
Enable
loop with loopCount: 5 to play background music while the caller waits in a queue.Legal disclaimer
Legal disclaimer
Play a pre-recorded compliance message before connecting to an agent. Use the
duration output variable to set a matching hangupDelay on the End Call node.Localized greetings
Localized greetings
Use a Switch node on the caller’s language, then route to different Play Audio nodes with region-specific audio URLs.