Custom caller tone - Vobiz

Set dialMusic to a URL when you want Vobiz to request custom XML instructions while it connects a Dial destination. The endpoint must return a valid <Response> containing <Play>, <Speak>, and/or <Wait>.

Dial XML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial
      callerId="+14155550100"
      timeout="30"
      dialMusic="https://example.com/dial-music">
    <Number>+14155550101</Number>
  </Dial>
</Response>

Response from dialMusic

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Speak>Your call is being connected.</Speak>
  <Wait length="2"/>
</Response>

Vobiz requests the dialMusic endpoint with POST. Return XML instructions rather than a direct MP3 or WAV response.

Omit dialMusic or set it to real to use the ordinary ringback path.

The destination carrier and the timing of answer or early media can affect what the A-leg hears before the bridge connects.

Next steps