LiveKit

Stream meeting audio to your LiveKit agent and play its responses back into the meeting.

Connect a LiveKit agent to a Recall.ai meeting bot. Recall.ai sends meeting audio to LiveKit and plays the agent's audio and optional video back into the meeting.

For a working implementation with an avatar and meeting tools, see the LiveKit sample app.

Setup

1. Get your LiveKit project credentials

Select the project your agent uses in the LiveKit dashboard. Copy its WebSocket URL, and create an API key and secret under Settings → API keys.

2. Add your credentials to Recall.ai

Open Agents → LiveKit in the Recall region where you create bots:

Select the workspace used by your Recall API key, then save the LiveKit project URL, API key, and secret. Use the same LiveKit project as your agent worker.

3. Start your agent worker

Run your LiveKit worker with a registered dispatch name. Use that exact name for agent_name below. In the sample app, this is LIVEKIT_AGENT_NAME in .env.

Quickstart

Call Create Bot with your meeting URL and agent name. The variant setting below selects web_4_core on Zoom, Google Meet, Microsoft Teams, and Webex. See bot sizing guidance.

{
  "meeting_url": "MEETING_URL",
  "variant": {
    "zoom": "web_4_core",
    "google_meet": "web_4_core",
    "microsoft_teams": "web_4_core",
    "webex": "web_4_core"
  },
  "output_media": {
    "camera": {
      "kind": "livekit",
      "config": {
        "agent_name": "meeting-agent"
      }
    }
  }
}

Once the bot joins the meeting, it connects to your LiveKit agent.

To add chat messages, screensharing, and a leave action, see Add meeting tools.

Additional configurations

The output_media.camera.config object supports:

FieldRequiredDescription
agent_nameYesYour worker's registered dispatch name.
roomNoLiveKit room name. Defaults to a unique room for this output session.

FAQ

Do I need to configure LiveKit in each Recall.ai workspace?

Yes. Add the credentials in each Recall.ai workspace and region where you create bots using LiveKit.

Why does the bot join but my agent does not respond?

Confirm that your worker is running, its LiveKit project matches the credentials saved in Recall.ai, and agent_name exactly matches the worker's registered dispatch name.

For recording the agent's voice, see Recording meeting agents. For response controls, see the Meeting agents FAQ.


Did this page help you?