Real-time monitoring

Terminate the active conversation immediately.

1
// End the active conversation
2
ws.send(JSON.stringify({
3
  command_type: "end_call"
4
}));

Transfer the call to a specified phone number.

1
// Transfer to a phone number
2
ws.send(JSON.stringify({
3
  command_type: "transfer_to_number",
4
  parameters: {
5
    phone_number: "+1234567890"
6
  }
7
}));

Inject context or instructions into the active conversation so the agent can use the new information in its responses.

1
// Send a contextual update to the agent
2
ws.send(JSON.stringify({
3
  command_type: "contextual_update",
4
  parameters: {
5
    contextual_update: "<your update text>"
6
  }
7
}));

Switch from AI agent to human operator mode for chat conversations.

1
// Enable human takeover
2
ws.send(JSON.stringify({
3
  command_type: "enable_human_takeover"
4
}));

Send a message to the user as a human operator in chat conversations.

1
// Send a message as a human operator
2
ws.send(JSON.stringify({
3
  command_type: "send_human_message",
4
  parameters: {
5
    text: "How can I help you?"
6
  }
7
}));

Return control from human operator back to the AI agent.

1
// Disable human takeover and return to AI
2
ws.send(JSON.stringify({
3
  command_type: "disable_human_takeover"
4
}));

Monitoring events are sent asynchronously to the conversation and may not arrive in the same order as the core conversation events. When processing events, do not rely on event order to reconstruct exact conversation timing.

The monitoring endpoint streams only text events and metadata. Raw audio data is not included in monitoring events.

Only approximately the last 100 events are cached and available when connecting to an active conversation. Earlier events cannot be retrieved.

VAD scores, turn probability metrics, and ping events cannot be monitored when custom event selection is enabled.

You must connect after the conversation has started. The monitoring endpoint cannot be used before conversation initiation.

API keys must have ElevenLabs Agents Write scope, and you must have EDITOR workspace access to monitor conversations.