Test & Preview Agent

Before letting your customers interact with your AI agent, you can generate a Preview Session to speak with it directly. This uses a temporary LiveKit session connected to your agent's LLM and selected voice model.

1. Generate a Preview Session

To start a test session, make a request to the /vozzo-react-web-agent-session endpoint with your agent's UUID.

Code
 
curl -X POST https://backend.vozzo.ai/agent/vozzo-react-web-agent-session/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }'

JavaScript
 
const response = await fetch(
  "https://backend.vozzo.ai/agent/vozzo-react-web-agent-session/",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      agent_uuid: "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    }),
  },
);
const data = await response.json();

Response

You will receive securely generated WebSocket URLs and tokens for the session. These credentials expire automatically after a short period.

Code
 
{
  "success": true,
  "data": {
    "api_key": "livekit_api_key_...",
    "api_secret": "livekit_api_secret_...",
    "ws_url": "wss://vozzo-cluster-...livekit.cloud",
    "token": "eyJhbGciOiJIUzI...5c",
    "session_id": "test-session-9823",
    "agent_name": "Support Bot"
  }
}

2. Using the Preview URL

Typically, you will use the returned ws_url and token to connect via the LiveKit SDK in your frontend application.

If you just want a quick standalone UI test without writing frontend code, you can open the temporary test viewer generated in your Vozzo Platform Dashboard under your agent's Test tab.