This page is a draft under review. It documents a deliberately controlled pattern for running more than one PAL in a single session. Reach out to your Tavus account team before using it in production.
Overview
This guide covers a specific, human-directed setup: one shared room, one PAL awake at a time, phrase-based handoffs between them. The pattern:- Create an anchor conversation the normal way. Tavus returns a
conversation_urlfor the room the first PAL joined. - Create a second conversation for the second PAL that points at the same room:
- For a Tavus-managed Daily room, pass the anchor’s
conversation_urlasproperties.daily_room. - For Google Meet, Zoom, or Microsoft Teams, pass the same
meeting_urlyou used on the anchor.
- For a Tavus-managed Daily room, pass the anchor’s
- Give each PAL distinct
wake_phraseandsleep_phrasevalues so only one is answering at a time. - Have the human participant join the shared URL.
- When the session ends, call End Conversation for every
conversation_idyou created.
What this guide does not cover
The following are outside the setup demonstrated here:- Autonomous interjections. PALs do not decide on their own to jump in. The human on the call directs turns with wake and sleep phrases.
- A single merged transcript across PALs. Each PAL’s conversation has its own transcript. Tavus does not currently provide a global, reliably-attributed multi-speaker transcript that combines what every PAL heard and said.
- Automatic choice of which PAL speaks next. There is no built-in arbitration between two awake PALs in the same room. If both are awake and both hear a prompt they consider theirs, they can both respond. The wake and sleep phrases are what keep only one active at a time.
Prerequisites
- Two PALs configured with the Conversational Flow layer, each with its own distinctive
wake_phraseandsleep_phrase. Phrases with two or more distinctive words work best. - For Google Meet, Zoom, or Microsoft Teams: each PAL must have a conferencing layer with
usernameconfigured, matching the requirements for a single-PAL meeting join.
Create the anchor conversation
Create the first conversation with the first PAL. Nothing special is required; Tavus returns the room’s URL.cURL
conversation_id and conversation_url. You will reuse the URL on the next request and end both conversations later.
For Google Meet / Zoom / Teams, create the anchor the same way you would for a single-PAL join: pass meeting_url on the first conversation (see Join a meeting via API). Keep the same meeting_url to reuse on the second conversation.
Add the second PAL to the same room
Create a second conversation for the second PAL. Point it at the same room the anchor is in. Tavus-managed Daily room — setproperties.daily_room to the anchor’s conversation_url:
cURL
meeting_url you used on the anchor conversation:
cURL
Count every participant in
max_participants on each conversation. Two PALs plus one human is three participants, so set max_participants: 3 on both conversations. The Participant Limits page has more detail; faces count as participants.Configure wake and sleep phrases
On each PAL, set a distinctwake_phrase and sleep_phrase on the Conversational Flow layer. Only the awake PAL responds; the other PAL stays silent.
Example pairing:
Choose phrases that are unique enough not to over-trigger, and that do not overlap with each other.
A sleeping PAL continues to receive conversation context. While asleep it still hears everything said in the room and records it into its own transcript, so when the rep wakes it back up it has the full context of what happened while the other PAL was speaking. See Conversational Flow for how wake and sleep detection works.
Join the shared URL
The human participant joins the shared URL — the same URL both PALs are in. For a Tavus-managed Daily room, open the anchor’sconversation_url in a browser or pass it to the Daily SDK, exactly as you would for a single-PAL conversation. For Google Meet, Zoom, or Microsoft Teams, join the meeting the normal way.
A worked two-PAL, one-human example:
- The rep joins the shared URL. The CFO PAL is awake by default; the security PAL is asleep.
- The rep discusses pricing with the CFO PAL.
- The rep says
"Thanks Casey". The CFO PAL goes to sleep. - The rep says
"Hey Sam". The security PAL wakes up with the full transcript of the pricing discussion already in its context. - The rep discusses SOC 2 with the security PAL.
- The rep says
"Thanks Sam", then"Hey Casey"to return to the CFO PAL.
End every conversation
When the session is over, call End Conversation for eachconversation_id you created. Ending one conversation does not end the other; each PAL has its own conversation, its own usage, and its own concurrency slot.
cURL
Related docs
- Conversational Flow -
wake_phraseandsleep_phraseconfiguration. - Google Meet / Zoom / Teams -
meeting_urland the conferencing layer. - Participant Limits -
max_participantsbehavior. Faces count as participants. - End Conversation - how to clean up each conversation.
- Create Conversation - full request schema, including
properties.daily_roomandmeeting_url.

