Skip to main content
Tavus sends conversation.started_speaking and conversation.stopped_speaking with properties.role set to "pal" or "user". For PAL turns, Tavus also sends a legacy duplicate app-message with the same payload except properties.role is "replica" instead of "pal". New integrations should handle "pal"; keep accepting "replica" until you drop legacy support. On conversation.stopped_speaking, properties also includes duration (seconds) and interrupted (whether the speaker was cut off).

Outbound: Tavus notifies you when the PAL or the user starts or stops speaking, using one event stream and a properties.role field instead of separate user- versus PAL-only events.

conversation.started_speaking fires when either party begins speaking; conversation.stopped_speaking when either stops.

For PAL turns, Tavus sends duplicate app-messages with the same payload except properties.role: "pal" (new integrations) and "replica" (legacy).

​
message_type
string

conversation for conversation-layer app messages.

Example:

"conversation"

​
event_type
enum<string>

conversation.started_speaking or conversation.stopped_speaking.

Available options:
conversation.started_speaking,
conversation.stopped_speaking
Example:

"conversation.started_speaking"

​
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:

42

​
inference_id
string

Identifier for correlating this speaking span with conversation.utterance, conversation.tool_call, and other events from the same turn.

Example:

"83294d9f-8306-491b-a284-791f56c8383f"

​
turn_idx
integer

Turn index; increments when conversation.respond is processed. Groups utterances, tool calls, and speaking-state events for the same turn. See Event ordering and turn tracking.

Example:

3

​
properties
object

Always includes role ("pal" or "user") identifying who started or stopped speaking. Legacy duplicate PAL events use "replica" instead of "pal".

On conversation.stopped_speaking only, also includes interrupted (whether the speaker was cut off mid-speech before finishing naturally) and duration (how long they spoke, in seconds; may be null if the start time could not be determined).