LiveKit

​

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:

Field	Description	Example
Integration Name	Friendly name for this integration	Production LiveKit
Server URL	Your LiveKit WebSocket URL	wss://example.livekit.cloud
API Key	LiveKit API key	APIxxxxxxxxxxxxx
API Secret	LiveKit API secret	Keep 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

---

​

Webhook Events

The integration processes these LiveKit events:

Event	Description	Roark Action
room_started	Room created	Initialize call record
room_finished	Room ended	Finalize call, trigger evaluation
participant_joined	User joined	Update participant list
egress_ended	Recording ready	Process 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