Skip to main content
Room nameThe text content of the <Conference> element is the room name. All callers placed into the same room name are bridged together. Room names are case-sensitive.

Attributes

endConferenceOnExit removes everyone, and stayAlone is no defence.When a participant with endConferenceOnExit="true" exits, the platform kicks every remaining member unconditionally. It does not check stayAlone on those members.stayAlone governs only the becoming-alone case - “if false and this member is now alone, disconnect them”. It has no interaction with another member’s exit. The two attribute names imply a negotiation between them; there is none.Legs removed this way also get no hangup attribution, so they report as NORMAL_CLEARING / 4000 / Callee - a platform teardown that looks like the participant hanging up. See Hangup causes.
Record conferences with per-leg session recording, and track them with callbackUrl.Per-leg recording gives you the recording file and its details. Use it rather than record="true" or POST /Conference/{room}/Record/, which answers 200 {"message":"async api spawned"} without a recording_id or url.Use callbackUrl for conference events rather than action, which is fetched only for conferences hosted on a remote media server.Place <Record> as a self-closing sibling before <Conference>:
recordSession="true" captures the whole leg, including anything bridged into it, and survives a transfer. Output is stereo MP3 at 8 kHz, one party per channel. With redirect="false" the action URL must return an empty <Response></Response>.

Conference action callback

The action request is separate from the participant events sent to callbackUrl. Vobiz invokes action after the call leg exits <Conference>, then executes the Vobiz XML returned by your endpoint. The request includes call, conference, and member identifiers. When record="true", it can also include: Return valid Vobiz XML from the action endpoint when the call should continue:
Action response

Examples

Basic conference room

Minimal conference - all defaults

Moderator-controlled conference

The moderator (endConferenceOnExit="true") holds all participants in music until they arrive, then ends the call for everyone when they leave.
Moderator joins last; ends conference on exit

Recorded conference with participant limit

The account-level room limit remains authoritative. Enforce any lower participant limit in your application.
Record the session and cap at 10 participants

Muted listener (broadcast mode)

Caller joins as a silent listener