Wipple CPaaS
Menu
Functions / Play

Play

{
  "verb": "play",
  "url": "https://example.com/example.mp3",
  "timeoutSecs": 10,
  "seekOffset": 8000,
  "actionHook": "/play/action"
}

Parameters

urlstring | arrayrequired

A single URL or an array of URLs (will play in sequence) to a WAV or MP3 file.


actionHookstring

Webhook that is called when the play Function completes.


earlyMediabooleandefault: false

If true and the call has not yet been answered, play the audio without answering the call.


loopnumberdefault: 1

Number of times to play the URL(s).


seekOffsetnumber

Number of samples to seek into the URL.


timeoutSecsnumber

Number of seconds to play the URL.


actionHook properties

The actionHook that is invoked when the play command completes will include the following properties:

property name description
playback_seconds the number of seconds played
playback_milliseconds the number of milliseconds played
playback_last_offset_pos the last offset position in samples