Katexs
Quickstart: talk in the browser

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. 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. 2

    Open the agent

    In Voice agents, open the agent you want to test.

  3. 3

    Start a test call

    Click the test call button and allow microphone access when the browser asks.

  4. 4

    Talk

    Speak normally. You can interrupt the agent mid-sentence.

  5. 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. 1

    The dashboard sends your signed-in session to Katexs and asks for a call token for one agent.

  2. 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. 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. 4

    The browser starts the voice session with that token. When it expires it cannot be reused.

ResponseMeaning
401 unauthenticatedYour session expired. Sign in again.
404 not_foundThe agent doesn't exist or isn't in a workspace you can access.
409 not_syncedSave the agent first.
4xx call blockedThe workspace is suspended, out of credits or over its spend cap.
503 not_configuredVoice 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