Telnyx voice API users can now receive webhooks when the dominant speaker changes in a conference call.
Dominant speaker webhooks are automatically sent on conferences set up using the Call Control REST API. These webhooks have event_type: "conference.floor.changed"
. An example webhook is contained in the API reference documentation for creating a conference with Call Control. The call_leg_id
contained in this webhook is the leg that has been identified as the dominant (or "floor") speaker.
Dominant speaker detection can also be enabled for conferences set up using TeXML. Users should specify statusCallbackEvent = "speaker"
as an attribute of the <Conference>
noun. An example callback is shown in the API reference documentation for the <Conference>
noun. The CallSid
contained in this callback corresponds to the caller that has been identified as the dominant speaker.