TwiML™ Voice: <Connect>

<Connect> is a TwiML verb that instructs Twilio to connect a phone call to Autopilot or a Programmable Video Room. The phone call can be over PSTN or SIP.

Connect Nouns

The nouns that you can nest inside of <Connect> are:

Autopilot

Autopilot assistants are represented in TwiML through a new noun, <Autopilot>. The <Autopilot> noun allows you to connect to a named Autopilot intelligent assistant.

To connect a Programmable Voice call to Autopilot, use the <Autopilot> noun with the AssistantSid for the Autopilot assistant:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Connect>
    <Autopilot>UAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</Autopilot>
  </Connect>
</Response>

Room

Programmable Video Rooms are represented in TwiML through a new noun, <Room>. The <Room> noun allows you to connect to a named video conference Room and talk with other participants who have also connected to that Room.

To connect a Programmable Voice call to a Room, use the <Room> noun with the UniqueName for the Room:

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

To connect a Programmable Voice call to a Room, use the <Room> noun with the UniqueName for the Room.

You may choose the name of the Room. It is namespaced to your account only.

ルームに接続する

When an incoming phone call is made to a Twilio Phone Number, a developer can connect the call to a Twilio Video Room.

Room and Connect Usage

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

Setting the participantIdentity

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

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

Stream

MediaStreams are represented in TwiML with the noun <Stream>.

To connect a Programmable Voice call to a bi-directional Media Stream, use the <Stream> noun with the url attribute set to a secure websocket server (wss):

<?xml version="1.0" encoding="UTF-8"?>
<Response>
   <Connect>
       <Stream url="wss://mystream.ngrok.io/audiostream" />
   </Connect>
</Response>

VirtualAgent

The <VirtualAgent> noun will connect a Programmable Voice call to a Google Dialogflow Essentials (ES) agent. The Dialogflow ES agent provides callers with conversational experiences through Interactive Voice Response (IVR).

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Connect>
    <VirtualAgent connectorName="project" />
  </Connect>
</Response>