Skip to main content
The <MultiPartyCall> element creates or joins a multi-party call (MPC) with advanced features like participant roles, coach mode for supervisors, and individual hold/mute controls.
For simple conference bridges without roles, see Conference.

Basic Usage


Participant Roles


MPC-Level Attributes

These settings apply to the entire multi-party call:

Hold Music

Callbacks


Participant-Level Attributes

These settings apply to individual participants:

Entry/Exit Sounds

Actions

AI Agent Stream Attributes

When role is set to ai-agent, use these attributes to connect an AI agent via WebSocket streaming.

Examples

Supervisor Coach Mode

Supervisors with coachMode="true" can hear everyone but only agents hear them (customers cannot): Supervisor joining:
Agent joining:
Customer joining:

MPC Recording

Recording Events

  • MPCRecordingInitiated
  • MPCRecordingPaused
  • MPCRecordingResumed
  • MPCRecordingCompleted
  • MPCRecordingFailed

On Exit Action

Continue call flow after leaving MPC:

Custom Hold Music

Hold music URLs must return XML with Play, Speak, or Wait elements.

Status Callback Events

Configure which events to receive with statusCallbackEvents:

Status Callback Parameters

On Exit Parameters


Conference vs Multi-party Call