​
Overview

The LiveKit integration enables real-time monitoring of voice communications built on the LiveKit platform. Stream call data directly to Roark for analysis, evaluation, and quality monitoring.

​
Prerequisites

Before setting up the integration, ensure you have:
  • A LiveKit Cloud account or self-hosted LiveKit server
  • LiveKit API credentials (API Key and Secret)
  • Admin access to configure webhooks in LiveKit

​
Setup Instructions

​
Step 1: Create Integration

  1. Navigate to Settings → Integrations in your Roark dashboard
  2. Click Add Integration and select LiveKit
  3. Enter the following configuration:
FieldDescriptionExample
Integration NameFriendly name for this integrationProduction LiveKit
Server URLYour LiveKit WebSocket URLwss://example.livekit.cloud
API KeyLiveKit API keyAPIxxxxxxxxxxxxx
API SecretLiveKit API secretKeep this secure

​
Step 2: Configure Webhook

After creating the integration, Roark provides a webhook URL:
  1. Copy the webhook URL from the integration settings
  2. Navigate to your LiveKit dashboard
  3. Go to Settings → Webhooks
  4. Add the Roark webhook URL
  5. Select the following events:
    • room_started
    • room_finished
    • participant_joined
    • egress_ended

​
Step 3: Select Evaluators

Choose which evaluators to apply to LiveKit calls:
  • All Evaluators - Apply every available evaluator
  • Selected Evaluators - Choose specific evaluators for this integration

​
Step 4: Activate Integration

Toggle the integration status to Active to begin receiving call data.

​
What Gets Synced

LiveKit integrations sync the following data:
  • Call Events - Room creation, participant joining, call completion
  • Recording Files - MP4 recordings from egress events
  • Call Metadata - Duration, participant count, room configuration
  • Transcripts - When speech-to-text is enabled
LiveKit does not sync agent configurations or prompts, as it’s a real-time communication platform rather than an AI agent provider.

​
Webhook Events

The integration processes these LiveKit events:
EventDescriptionRoark Action
room_startedRoom createdInitialize call record
room_finishedRoom endedFinalize call, trigger evaluation
participant_joinedUser joinedUpdate participant list
egress_endedRecording readyProcess recording file

​
Monitoring Integration Health

Check your integration status in the Roark dashboard:
  • Active 🟢 - Receiving and processing events
  • Inactive 🔴 - Integration paused
  • Error ⚠️ - Configuration or connection issues
View recent webhook deliveries and any error messages in the integration details.

​
Next Steps

Configure Evaluators

Set up evaluation criteria

View Live Calls

Monitor calls in real-time

Custom Integrations

Build your own integration

Integration Overview

Learn about all integrations