Skip to main content

Conference Member Join

The Conference Member Join event is fired whenever a caller joins a conference that specified a callbackUrl.

The response may be either empty or a BXML document. Only the following verbs are valid for conferences:

Audio verbs will be heard by all members of the conference. Recordings capture audio from all members who are not muted or on hold, as well as any audio verbs that are played into the conference.

Request Parameters#

PropertyDescription
eventTypeThe event type, value is conferenceMemberJoin.
eventTimeThe approximate UTC date and time when the event was generated by the Bandwidth server, in ISO 8601 format. This may not be exactly the time of event execution.
conferenceIdThe ID of the conference.
nameThe custom name used to reference this conference. This the name that you included inside the body of the <Conference> tag.
callIdThe callId of the member that left the conference.
fromThe provided identifier string of the caller used in the from field of the original call.
toThe to number of the call that left the conference, in E.164 format (e.g. +15555555555).
tag(optional) The tag that was set at conference creation. If no tag was specified, this field will not be present.

Expected Response#

HTTP/1.1 200
Content-Type: application/xml; charset=utf-8
<Response>
<!-- BXML verbs to execute in the conference -->
</Response>

Examples#

Conference Member Joined#

POST http://yourUrl.example/conferenceMemberJoin
Content-Type: application/json
{
"conferenceId" : "conf-59082d52-4a2ab5be-ce26-43ed-af94-431b8a19d4e3",
"name" : "thisConference",
"eventType" : "conferenceMemberJoin",
"eventTime" : "2019-07-31T13:16:01.324Z",
"callId" : "c-95ac8d6e-1a31c52e-b38f-4198-93c1-51633ec68f8d",
"to" : "+15551112345",
"from" : "+15559998765",
"tag" : "conferenceTag"
}