Menu

Expand
Rate this page:

TwiML™ Voice: <Room>

This Twiml Verb is not currently available when using Twilio Regions Ireland (IE1) or Australia (AU1). This is currently only supported with the default US1 region. A full list of unsupported products and features with Twilio Regions is documented here.

Programmable Video Rooms are represented in TwiML through the <Room> noun, which you can specify while using the <Connect> verb.

The <Room> noun allows you to connect to a named Programmable Video Room and talk with other participants who are connected to that Room.

Note that only Group Rooms support PSTN Participants.

To connect a Programmable Voice call to a Room, use the <Room> noun and provide the UniqueName for the Room you would like to connect to. If an in-progress Video Room with that unique name does not exist for your account, Twilio will move to the next set of TwiML instructions you have provided, or disconnect the call if the <Room> is the final TwiML instruction.

<Room> and <Connect> usage examples

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Connect>
    <Room>DailyStandup</Room>
  </Connect>
</Response>

Ensure, your room type is group. Connecting voice calls to a Peer-to-Peer Room is not possible.

Loading Code Sample...
        
        

        Connect a Programmable Voice call to a Room

        Set the Participant's identity

        You can set a unique identity on the incoming caller using an optional property called participantIdentity.

        If you don't set the participantIdentity, then Twilio will assign a unique string value to the Participant's identity.

        <?xml version="1.0" encoding="UTF-8"?>
        <Response>
          <Connect>
            <Room participantIdentity='alice'>DailyStandup</Room>
          </Connect>
        </Response>
        Loading Code Sample...
              
              

              Connect a Programmable Voice call to a Room with a unique participant identity

              Visit the Programmable Video documentation for more information about adding PSTN participants to Video Rooms.

              Rate this page:

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

              Loading Code Sample...
                    
                    
                    

                    Thank you for your feedback!

                    Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!

                    thanks-feedback-gif