Skip to main content

​
LiveKit Setup

LiveKit handles real-time audio between the browser, voice agent, and phone calls.

​
Setup Steps

  1. Create an account at LiveKit Cloud
  2. Create a new project
  3. Copy your API Key, API Secret, and WebSocket URL
  4. Add credentials via the Arkenos Dashboard at API Keys > LiveKit
LiveKit credentials are stored encrypted in the database and shared across all services automatically. The agent fetches them from the backend on startup — no .env files needed for LiveKit.

​
How It Works

  • Browser sessions: The frontend generates a LiveKit access token and connects via WebRTC
  • Agent dispatch: When a room is created, LiveKit dispatches the arkenos-agent worker
  • Phone calls: Twilio SIP trunks route calls through LiveKit’s SIP bridge (see Telephony Setup)

​
Verify Your Setup

After adding credentials, verify everything works:
  1. Start all three services (frontend, backend, agent)
  2. Go to the Preview page in the dashboard
  3. Select an agent and click Start Preview
  4. You should hear the agent greet you within a few seconds
If the call immediately disconnects, check:
  • LiveKit credentials are configured at API Keys and the Test Connection button shows success
  • The LIVEKIT_URL format is correct (wss:// prefix)
  • The agent terminal shows Worker registered on startup
  • The agent terminal shows Injected N keys from backend dashboard on startup

​
Documentation