Configuration

Settings

Saved in .local/credentials.json, outside git. Every secret, key and token is never shown again after saving. Saving a change restarts the agent worker, which ends a call in progress.

Settings section

LiveKit, 1 of 1 savedModels, 3 of 3 savedWhatsApp, 0 of 1 saved

Agent server

Speech-to-speech server running — last seen 1s ago. It can book through channelflow.

LiveKit

Needed for live calls on the demo page. From your LiveKit Cloud project: Settings → API keys.

saved

Project URL

Looks like wss://your-project.livekit.cloud

API key

Starts with API…

API secret

A secret is saved. Leave empty to keep it — unless the URL or API key changes, which needs its own secret.

Google · Gemini API

Speech-to-speech on Gemini Live: once a key is saved, the drawer offers its models, with every setting Google's Live API takes. From Google AI Studio (aistudio.google.com): Get API key.

saved

API key

A key is saved. Leave empty to keep it.

Usage tier

The free tier bills nothing, and Google may use and have people read what callers say: set up billing in AI Studio before a real guest calls.

OpensGemini 3.8 Live, Gemini 3.8 Live Extended Thinking, Gemini 3.1 Flash Live Preview, Gemini 2.5 Flash Live Preview

Alibaba Cloud Model Studio · Qwen

Qwen ears, and speech-to-speech on Qwen. From the Model Studio console: API Keys, in the region the key belongs to.

saved

API key

A key is saved. Leave empty to keep it.

Region

A key works only in its own region. Singapore is the one nearest to Bali.

Workspace ID (optional)

With it, calls go to the workspace's own domain, which Alibaba recommends. Save it empty to use the region's shared domain.

OpensQwen-Audio 3.0 ASR Flash Streaming, Qwen3-ASR Flash Realtime, Qwen3-ASR Flash Realtime (2026-02-10), Qwen3-ASR Flash Realtime (2025-10-27), Qwen3.8-Omni Flash Realtime and 5 more

MiniMax

MiniMax voices as the mouth, with its voice list, previews, voice design and cloning. From platform.minimax.io: Account → API Keys.

saved

API key

A key is saved. Leave empty to keep it.

API host

MiniMax's docs name the global host; LiveKit's MiniMax plugin defaults to US-West.

OpensSpeech 2.8 HD, Speech 2.8 Turbo, Speech 2.6 HD, Speech 2.6 Turbo, Speech-02 HD and 3 more

Every model provider has a key saved.

WhatsApp Web test line

Links a WhatsApp account the way WhatsApp Web does, and the agent answers its calls — to test a real call before the Cloud API route. Unofficial: WhatsApp's terms forbid automated clients, so link a test number, never the business number.

not running

Its process is not running. On the laptop it starts with the web app: pnpm dev from the repo root; on staging it is the live-agent-wa-web container.

WhatsApp calls

Phase 2: real calls to the business number. Meta's own Cloud API credentials, not YCloud's — LiveKit's connector needs Meta directly. From the Meta Developer Console: WhatsApp → API Setup, and App settings → Basic.

not set

Phone number ID

Digits only — Meta's ID for the business number, not the number itself.

Access token

Not saved yet. A permanent system-user token, so it does not expire mid-call.

App secret

Not saved yet. Without it every webhook is turned away: it is what proves a call is Meta's.

Verify token

Not saved yet. Any string you choose; Meta asks for it once, when the webhook is set up.

Cloud API version

23.0, 24.0, 25.0 or 26.0 — the versions LiveKit's connector works with. Meta's webhook subscription must be on the same one.

Callers answered (optional)

Phone numbers separated by commas — while a number is being tested, so a call nobody expected cannot spend the models' money. Save it empty and anyone may call.

Callback URL for the Meta console, subscribed to the calls field: /api/whatsapp/calls