Skip to main content

Outbound: Tavus tells you when someone enters or leaves the conversation, so your own view of who is present can follow along.

conversation.joined fires when the PAL or a person arrives; conversation.left when they go. properties.role says which, and the other two properties follow from it.

A one-on-one conversation gets these too, and the same person keeps the same id if they drop and reconnect, so you can key your own state on it.

​
message_type
string

conversation for conversation-layer app messages.

Example:

"conversation"

​
event_type
enum<string>
Available options:
conversation.joined,
conversation.left
Example:

"conversation.joined"

​
timestamp
number

Unix timestamp (seconds since epoch) indicating when this event was created. Use this to build timestamped transcripts or reconstruct the timeline of a conversation.

Example:

1746000000.123

​
seq
integer

Monotonic per event; a higher seq was emitted later. Use with turn_idx as in Event ordering and turn tracking.

Example:

9

​
conversation_id
string

The unique identifier for the conversation.

Example:

"c69de076e8cf7494"

​
properties
object