Create Conversation
With the Tavus Conversational Video Interface (CVI) you are able to create a conversation
with a replica in real time.
Conversations
A conversation
is a video call with a replica.
After creating a conversation
, a conversation_url
will be returned in the response. The conversation_url
can be used to join the conversation directly or can be embedded in a website. To embed the conversation_url
in a website, you can find instructions here.
Once a conversation is created, the replica will automatically join the call and will start participating.
By providing a callback_url
, you can receive webhooks with updates regarding the conversation state.
Authorizations
Body
The unique identifier for the replica that will join the conversation.
The unique identifier for the persona that the replica will use in the conversation.
A url that will receive webhooks with updates regarding the conversation state.
A name for the conversation.
Optional context that will be appended to any context provided in the persona, if one is provided.
An optional custom greeting that the replica will give once a participant joines the conversation.
Optional properties that can be used to customize the conversation.
Response
A unique identifier for the conversation.
The name of the conversation.
The status of the conversation. Possible values: active
, ended
.
A direct link to join the conversation. This link can be used to join the conversation directly or can be embedded in a website.
A unique identifier for the replica used to create this conversation.
A unique identifier for the persona used to create this conversation.
The date and time the conversation was created.