room_url to open the Tavus-hosted room page, to test a PAL or share a call link.
Use conversation_url to join the call programmatically with an SDK.
Both fields come back from POST /v2/conversations.
Use room_url for the hosted room
The hosted room opens in any browser without an SDK. It supports all Tavus conversation features, including Magic Canvas cards, screen sharing, and captions. Use it to test a PAL quickly or send a call link to a participant. After the call ends, the page shows that the call has ended. The API returnsroom_url for any call in a Daily room, including your own room passed as properties.daily_room.
It does not return room_url when the conversation joins an external meeting through meeting_url or uses LiveKit.
Add a call to your website
The hosted room is for testing and sharing links, not for embedding in your site. To put a conversation on your website, use one of these instead:- Embed renders a conversation inline in your page.
- Widget adds a floating conversation launcher.
- The CVI UI component library gives you React components for your own layout.
Use conversation_url with an SDK
conversation_url is the call URL, such as https://tavus.daily.co/c123456.
If you pass properties.daily_room, it points to your own Daily room.
This field is unchanged. Your existing integrations keep working.
For example, join with daily-js.
Replace the example URL with conversation_url from your response:
Join a private room
For a private room created with
require_auth: true, use the meeting_token from the response.
For room_url, append it as ?t=<meeting_token>.
For conversation_url, pass it when you join: call.join({ url: conversation_url, token: meeting_token });.