Conferences

Conferences let you connect multiple participants in a single call. Using the Conference API, you can manage ongoing conferences, control individual members, and record conversations. Conferences are suited for traditional “meeting” use cases. For advanced contact center or sales dialer scenarios requiring more control, consider Multiparty Calls.

The Conference Object

Attribute	Type	Description
`conference_name`	`string`	Name used to identify the conference.
`conference_run_time`	`string`	Time in seconds since the conference was initiated.
`conference_member_count`	`string`	Number of members currently active in the conference.
`members`	`array`	Array of member objects in the conference.

Member Attributes

Each member in the members array has the following attributes:

Attribute	Type	Description
`member_id`	`string`	Unique ID of the member within the conference.
`muted`	`boolean`	`true` if the member is currently muted.
`deaf`	`boolean`	`true` if the member cannot hear conference audio.
`from`	`string`	Source of the call — PSTN number or SIP endpoint.
`to`	`string`	Conference bridge number — Plivo number or application URL.
`caller_name`	`string`	Name of the caller (SIP calls only).
`direction`	`string`	Direction of the call — `inbound` or `outbound`.
`call_uuid`	`string`	Unique identifier of the call.
`join_time`	`string`	Time in seconds since the member joined.

Example Conference Object

{
  "conference_name": "My Conf Room",
  "conference_run_time": "590",
  "conference_member_count": "1",
  "members": [
    {
      "muted": false,
      "member_id": "17",
      "deaf": false,
      "from": "1456789903",
      "to": "1677889900",
      "caller_name": "John",
      "direction": "inbound",
      "call_uuid": "acfbf0b5-12e0-4d74-85f7-fce15f8f07ec",
      "join_time": "590"
    }
  ]
}

Retrieve a Conference

Get details of a specific conference by name.

GET https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/

Arguments

No arguments required.

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.get(conference_name='My Conf Room')
print(response)

Response

{
  "conference_name": "My Conf Room",
  "conference_run_time": "590",
  "conference_member_count": "1",
  "members": [
    {
      "muted": false,
      "member_id": "17",
      "deaf": false,
      "from": "1456789903",
      "to": "1677889900",
      "caller_name": "John",
      "direction": "inbound",
      "call_uuid": "acfbf0b5-12e0-4d74-85f7-fce15f8f07ec",
      "join_time": "590"
    }
  ],
  "api_id": "816e903e-58c4-11e1-86da-adf28403fe48"
}

List All Conferences

Retrieve names of all ongoing conferences in your account.

GET https://api.plivo.com/v1/Account/{auth_id}/Conference/

Arguments

No arguments required.

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.list()
print(response)

Response

{
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48",
  "conferences": [
    "My Conf Room",
    "Sales Meeting",
    "Support Call"
  ]
}

Hang Up a Conference

Terminate a conference and disconnect all members.

DELETE https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.delete(conference_name='My Conf Room')
print(response)

Response

{
  "message": "conference hung up",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}

Hang Up All Conferences

Terminate all ongoing conferences in your account.

DELETE https://api.plivo.com/v1/Account/{auth_id}/Conference/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.delete_all()
print(response)

Response

{
  "message": "all conferences hung up",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}

Member Operations

Control individual members within a conference. The member_id parameter can be:

A specific member ID (e.g., 10)
A comma-separated list (e.g., 10,11,12)
The string all to affect all members

Kick a Member

Disconnect a member from the conference.

POST https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Kick/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_kick(conference_name='My Conf Room', member_id='10')
print(response)

Response

{
  "message": "kicked",
  "member_id": "10",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}

Mute / Unmute a Member

Mute
Unmute

Mute a member so other participants cannot hear them.

POST https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Mute/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_mute(conference_name='My Conf Room', member_id='10')
print(response)

Response

{
  "message": "muted",
  "member_id": "10",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}

Unmute a previously muted member.

DELETE https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Mute/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_unmute(conference_name='My Conf Room', member_id='10')
print(response)

Response

{
  "message": "unmuted",
  "member_id": "10",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}

Deaf / Undeaf a Member

Deaf
Undeaf

Make a member deaf so they cannot hear conference audio.

POST https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Deaf/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_deaf(conference_name='My Conf Room', member_id='10')
print(response)

Response

{
  "message": "deaf",
  "member_id": "10",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}

Restore hearing to a deaf member.

DELETE https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Deaf/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_undeaf(conference_name='My Conf Room', member_id='10')
print(response)

Response

{
  "message": "undeaf",
  "member_id": "10",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}

Play Audio to a Member

Start Playing
Stop Playing

Play an audio file to specific members.

POST https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Play/

Parameter	Required	Description
`url`	Yes	URL of the `.mp3` or `.wav` file to play.

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_play(
    conference_name='My Conf Room',
    member_id='10',
    url='https://s3.amazonaws.com/plivocloud/music.mp3')
print(response)

Response

{
  "message": "play queued into conference",
  "api_id": "4e44bd4e-f830-11e6-b886-067c5485c240",
  "member_id": "10"
}

Stop playing audio to members.

DELETE https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Play/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_play_stop(conference_name='My Conf Room', member_id='10')
print(response)

Speak Text to a Member

Start Speaking
Stop Speaking

Speak text to specific members using text-to-speech.

POST https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Speak/

Parameter	Required	Description
`text`	Yes	Text to speak.
`voice`	No	Voice type. Values: `MAN`, `WOMAN`. Default: `WOMAN`.
`language`	No	Language code. Default: `en-US`.

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_speak(
    conference_name='My Conf Room',
    member_id='10',
    text='Hello, welcome to the conference')
print(response)

Response

{
  "message": "speak queued into conference",
  "api_id": "4e44bd4e-f830-11e6-b886-067c5485c240",
  "member_id": "10"
}

Stop speaking text to members.

DELETE https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Speak/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.member_speak_stop(conference_name='My Conf Room', member_id='10')
print(response)

Record a Conference

Start Recording
Stop Recording

Start recording an ongoing conference.

POST https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Record/

Arguments

Parameter	Description
`file_format`	Recording format. Values: `mp3`, `wav`. Default: `mp3`.
`transcription_type`	Set to `auto` for automated transcription.
`transcription_url`	URL to receive transcription results.
`callback_url`	URL invoked when recording ends.
`callback_method`	HTTP verb for `callback_url`. Default: `POST`.

Callback URL parameters

Parameter	Description
`api_id`	API ID returned by the record API.
`record_url`	URL where the recorded file can be accessed.
`recording_id`	Recording ID associated with the file.
`conference_name`	Name of the recorded conference.
`recording_duration`	Duration in seconds.
`recording_duration_ms`	Duration in milliseconds.
`recording_start_ms`	Start time (epoch ms).
`recording_end_ms`	End time (epoch ms).

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.record(conference_name='My Conf Room')
print(response)

Response

{
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48",
  "message": "conference recording started",
  "recording_id": "93bc7c6a-3b2b-11e3",
  "url": "https://media.plivo.com/v1/Account/<Auth_ID>/Recording/93bc7c6a-3b2b-11e3.mp3"
}

Stop recording a conference.

DELETE https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Record/

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.conferences.record_stop(conference_name='My Conf Room')
print(response)

Response

HTTP Status Code: 204

Conference XML Element - Create conferences using XML
Multiparty Calls - Advanced call control for contact centers
Recordings - Manage conference recordings

Getting Started

Concepts

API Reference

XML Reference

SDKs

Troubleshooting

Voice Tutorials

Migration Guides

The Conference Object

Member Attributes

Example Conference Object

Retrieve a Conference

Arguments

Response

List All Conferences

Arguments

Response

Hang Up a Conference

Response

Hang Up All Conferences

Response

Member Operations

Kick a Member

Response

Mute / Unmute a Member

Response

Response

Deaf / Undeaf a Member

Response

Response

Play Audio to a Member

Response

Speak Text to a Member

Response

Record a Conference

Arguments

Response

Response

Getting Started

Concepts

API Reference

XML Reference

SDKs

Troubleshooting

Voice Tutorials

Migration Guides

​The Conference Object

​Member Attributes

​Example Conference Object

​Retrieve a Conference

​Arguments

​Response

​List All Conferences

​Arguments

​Response

​Hang Up a Conference

​Response

​Hang Up All Conferences

​Response

​Member Operations

​Kick a Member

​Response

​Mute / Unmute a Member

​Response

​Response

​Deaf / Undeaf a Member

​Response

​Response

​Play Audio to a Member

​Response

​Speak Text to a Member

​Response

​Record a Conference

​Arguments

​Response

​Response

​Related

The Conference Object

Member Attributes

Example Conference Object

Retrieve a Conference

Arguments

Response

List All Conferences

Arguments

Response

Hang Up a Conference

Response

Hang Up All Conferences

Response

Member Operations

Kick a Member

Response

Mute / Unmute a Member

Response

Response

Deaf / Undeaf a Member

Response

Response

Play Audio to a Member

Response

Speak Text to a Member

Response

Record a Conference

Arguments

Response

Response

Related