Skip to main content

Play remote audio

IMPORTANT!

If you hadn't yet read the intro part of this section, please click here to read it first.

Description

This module provides the developer access to the Cloudonix Play Verb. Activating this module will instruct your currently running voice application to play a remote mp3 file, hosted on a CDN or your own HTTP server.

Workflow

This module may be executed at any point of a scenario - however, pay attention to where the output is used in your CXML response.

Module Example

Parameters

ParameterDescription
ConnectionThe Voice Application Connection to be used for the query.
Remote Audio FileA URL to the MP3 file to play. You may specify multiple URLs, they will be played in sequance.
Next ActionSee Below.
ActionThe voice application to execute. Available for Attached or Detached Voice Applications.
EndpointThe voice application remote HTTP endpoint. Available for Custom Voice Application Endpoint only.
Additional DataAn array of key=value pairs, to be passed to the new Voice Application as part of the request data.

Next Action Targets

No Next Action

Voice application will continue in execution with the CXML directive following the play directive.

This Voice Application

Voice application control is returned to the current voice application, with potential additional data.

Attached or Detached Voice Application

Voice application control is passed to the voice application that was previously built with Make.com.

Custom Voice Application Endpoint

Voice application control is passed to the URL designated in the Endpoint parameter.

Advanced Mode

ParameterDescription
Loop AudioHow many times to play the audio file. (Default: 1)
Auto AnswerYou may play a remote file, before the call is answered (SIP 183 Progress). If this parameter is set to false, playback will not answer the call and perform an early media playback. (Default: true)
Playback Status URLA remote URL endpoint to report the status of the playback operation.
Status Callback HTTP MethodWhat HTTP method should be used to report the status. (Default: POST)