Skip to main content
See the Conversational Flow layer to configure the wake_phrase and sleep_phrase that trigger these events.

Outbound: Tavus notifies you when a PAL configured with a wake_phrase and sleep_phrase wakes up or goes back to sleep.

system.wake_phrase_detected fires when the PAL hears its wake_phrase and starts responding; system.sleep_phrase_detected fires when it hears its sleep_phrase and returns to the silent state. Configure both phrases on the Conversational Flow layer.

Both events carry only the envelope. properties is omitted, and the detected phrase text is not included so user speech is never echoed back. Use them to drive UI state, such as a "listening" indicator.

message_type
string

system for system-layer app messages.

Example:

"system"

event_type
enum<string>

system.wake_phrase_detected or system.sleep_phrase_detected.

Available options:
system.wake_phrase_detected,
system.sleep_phrase_detected
Example:

"system.wake_phrase_detected"

conversation_id
string

The unique identifier for the conversation.

Example:

"c69de076e8cf7494"

timestamp
number

Unix timestamp (seconds since epoch) indicating when this event was created. Use this to 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 event with conversation.utterance and other events from the same turn.

Example:

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

turn_idx
integer

Turn index; increments when conversation.respond is processed. See Event ordering and turn tracking.

Example:

3