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> |
Describes an Autopilot assistant. Connects the active caller to an Autopilot assistant. See the Autopilot doumentation for a walkthrough of how to use Autopilot to build intelligent assistants and conversational IVRs. |
<Room> |
A nested XML element that describes a Programmable Video Room to connect to with some attributes. |
<Stream> |
Begins a bi-directional MediaStream for the active call. |
<VirtualAgent> |
Connects a Programmable Voice call to a Dialogflow Essentials (ES) agent. |
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. Note that only Group Rooms support PSTN Participants.
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.
Ensure, your room type is group
. Connecting voice calls to a Peer-to-Peer Room is not possible.
ルームに接続する
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>
If you don't set the participantIdentity
, then Twilio will set a unique value as the Participant identity.
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>
ヘルプが必要ですか?
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.