Quickstart
Quickstart: talk in the browser
Test a voice agent from your browser with a secure, short-lived session, before you connect a phone number.
Overview
You don't need a phone number to try an agent. Every saved voice agent has a test call button in the dashboard that opens a live voice session in your browser using your microphone.
Steps
- 1
Save your agent
The agent must be saved at least once so it exists in the voice engine. Unsaved agents return "Save the assistant first so it syncs to the voice engine."
- 2
Open the agent
In Voice agents, open the agent you want to test.
- 3
Start a test call
Click the test call button and allow microphone access when the browser asks.
- 4
Talk
Speak normally. You can interrupt the agent mid-sentence.
- 5
End and review
Hang up. The session appears in Calls like any other call, with its transcript and cost.
How the browser session is secured
Your browser never sees a Katexs or provider secret key. When you start a test call:
- 1
The dashboard sends your signed-in session to Katexs and asks for a call token for one agent.
- 2
Katexs checks that you are a member of the agent's workspace and that the workspace can place calls (not suspended, has credits, under its monthly spend cap).
- 3
Katexs signs a short-lived token that only works for that one agent, and returns it with the workspace's maximum call length.
- 4
The browser starts the voice session with that token. When it expires it cannot be reused.
| Response | Meaning |
|---|---|
401 unauthenticated | Your session expired. Sign in again. |
404 not_found | The agent doesn't exist or isn't in a workspace you can access. |
409 not_synced | Save the agent first. |
4xx call blocked | The workspace is suspended, out of credits or over its spend cap. |
503 not_configured | Voice calling isn't configured on this deployment. Contact support. |
Note
Test calls are real calls: they use the same models and voices as phone calls and are charged at your workspace's per-minute rate.
Warning
Embedding a voice button on your own website (the browser call outside the dashboard) is in Preview. Contact support@katexs.com for early access. Until then, use a phone number or the website chat widget for public visitors.
Last updated November 2026 · Found a problem? Email support@katexs.com
