Voice Agent API

View as Markdown

The Voice Agent API provides real-time spoken conversation over one WebSocket connection. Stream microphone audio to an agent and receive live transcripts, text, synthesized speech, and function calls.

Use the Voice Agent API for customer support, scheduling assistants, voice interfaces, language practice, kiosks, and ordering systems.

Key features

  • Bidirectional audio streaming over WebSocket
  • Automatic turn detection
  • Barge-in, so a user can interrupt a response in progress
  • Transcription for user and agent speech
  • Streamed audio responses with transcripts
  • Synthesized speech at 16 kHz with ten available voices
  • Built-in gemma-4 model, or your own OpenAI or Anthropic key
  • Function calling for integrations with your application
  • Managed conversation history, trimmed automatically as it approaches the model's context limit

Concepts

ConceptDescription
SessionThe active configuration, grouped into listen (input audio and transcription), think (model, instructions, and tools), and speak (output audio and voice).
ConversationOrdered history accumulated during the WebSocket session.
ItemA user or agent message, function call, or function result in the conversation.
ResponseOne agent turn, including its streamed output, status, and usage.

How it works

  1. Connect to the Voice Agent WebSocket endpoint.
  2. Receive session.created and send session.update as the first client event.
  3. Stream Base64-encoded input audio in JSON events.
  4. Handle turn, transcription, response, and audio events.
  5. Execute requested functions and return their results to the conversation.

For protocol details and examples, see Live sessions.

Resources

AI Services are part of the Zoom Build platform. To quickly get started, visit Zoom.ai . You can explore pricing plans, try interactive demos, and set up your account.