Skip to main content
Use the official Vatel SDKs to connect your applications to voice agents over the REST API and WebSockets. Each SDK gives you a client for API calls and a way to run real-time voice sessions: send audio, receive events and agent audio, and handle tool calls.
You need an organization API key (from the Vatel dashboard) and an agent ID for the agent you want to run. Session tokens are short-lived JWTs obtained via the API and used to open the WebSocket connection.

​
Choose your language

Python

REST and WebSocket with async support. Python 3.9+.

JavaScript / TypeScript

Node.js and browser. REST client and WebSocket session.

Go

Single client for REST and WebSocket. Go 1.21+.

WebSockets

Real-time voice sessions. Send audio, receive events, and handle tool calls.

API Reference

Full request/response details and all endpoints.

​
How it works

1

Get credentials and agent ID

Use your organization API key and the agent UUID from the dashboard (or from the REST API).
2

Obtain a session token

Call the session-token endpoint with your API key and agent ID. The token authorizes one WebSocket connection for that agent.
3

Connect and run the session

Open the WebSocket with the token, then send input audio (e.g. from a microphone) and handle incoming events: agent audio, transcripts, tool calls, and session lifecycle.

​
API reference

For full request/response details and all endpoints, see the API reference:

Session token

Get a short-lived JWT for the WebSocket connection.

Connection

WebSocket URL, message types, and flow.

​
Next steps

Next.js example

Full Session WebSocket demo in Next.js: server-side token, real-time voice, and event display.