Stream with Record

You can use the <Record> and <Stream> elements together to simultaneously record a call and stream its audio to a WebSocket in real-time. This is useful for applications that require both persistent storage of the call audio and live processing, such as real-time transcription and analysis. Make <Record/> self-closing and place it before <Stream> as a sibling element. This starts full-session recording before live audio processing begins. Set recordSession="true" so recording continues while later XML elements execute, and set redirect="false" so the recording callback does not interrupt the streaming flow.

Stream with Record XML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Play>https://yourcdn.com/play.wav</Play>
  <Record action="https://your-domain.com/record_action/" method="POST"
          recordSession="true" redirect="false"
          maxLength="3600" playBeep="true"/>
  <Stream bidirectional="true" keepCallAlive="true">wss://your-server.com/ws</Stream>
  <Play>https://yourcdn.com/play.wav</Play>
</Response>

Initial Record event parameters

The action URL receives the initial Record event near the start of recording. Use its RecordingID to correlate this event with the completed RecordStop callback. Other recording fields may be absent or incomplete at this stage.

Parameter	Type	Description
From	string	The calling party number.
RecordingID	string	The unique ID for the recording.
To	string	The called party number.
CallUUID	string	The unique ID for the call.
Event	string	The event type (Record).

Stream with Record & Callback URL XML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Play>https://yourcdn.com/play.wav</Play>
  <Record action="https://your-domain.com/record_action/" method="POST"
          callbackUrl="https://your-domain.com/record_callback/" callbackMethod="POST"
          recordSession="true" redirect="false"
          maxLength="3600" playBeep="true"/>
  <Stream bidirectional="true" keepCallAlive="true">wss://your-server.com/ws</Stream>
  <Play>https://yourcdn.com/play.wav</Play>
</Response>

RecordStop event callback parameters

A RecordStop event is posted to callbackUrl after recording stops. Use this event for final duration and the ready RecordFile or RecordUrl at media.vobiz.ai.

Parameter	Type	Description
From	string	The calling party number.
RecordingID	string	The unique ID for the recording.
RecordFile	string	The URL of the recorded file.
RecordingEndMs	string	The timestamp when the recording ended.
BillRate	string	The billing rate for the call.
To	string	The called party number.
RecordingDurationMs	string	The duration of the recording in milliseconds.
CallUUID	string	The unique ID for the call.
ALegRequestUUID	string	The request UUID for the A leg of the call.
SessionStart	string	The timestamp when the session started.
Direction	string	The direction of the call (inbound or outbound).
RecordUrl	string	The URL of the recorded file.
RecordingDuration	string	The duration of the recording in seconds.
ALegUUID	string	The unique ID for the A leg of the call.
CallStatus	string	The status of the call.
ParentAuthID	string	The parent authentication ID.
RequestUUID	string	The unique ID for the request.
Event	string	The event type (RecordStop).
RecordingStartMs	string	The timestamp when the recording started.

​Stream with Record XML

​Initial Record event parameters

​Stream with Record & Callback URL XML

​RecordStop event callback parameters

Stream with Record XML

Initial Record event parameters

Stream with Record & Callback URL XML

RecordStop event callback parameters