VAPI

​

Overview

The VAPI integration enables comprehensive monitoring of your VAPI voice assistants. Sync historical calls, monitor live conversations, and automatically evaluate assistant performance using Roark’s analytics platform.

---

​

Prerequisites

Before setting up the integration, ensure you have:

• A VAPI account with active assistants
• VAPI API key (found in your VAPI dashboard)
• At least one configured assistant in VAPI

---

​

Setup Instructions

​

Step 1: Create Integration

1. Navigate to Settings → Integrations in your Roark dashboard
2. Click Add Integration and select VAPI
3. Enter your configuration:

Field	Description
Integration Name	Friendly name for this integration
API Key	Your VAPI API key

The system will automatically validate your API key and fetch available assistants.

​

Step 2: Configure Historical Sync

Choose how far back to import existing calls:

• Default: Last 90 days of call history
• Custom: Select a specific date range
• Skip: Only sync new calls going forward

​

Step 3: Select Assistants

Choose which VAPI assistants to monitor:

• All Assistants - Sync calls from every assistant in your account
• Selected Assistants - Choose specific assistants to monitor

The assistant selector shows:

• Assistant name
• Assistant ID
• Last modified date

​

Step 4: Configure Evaluators

Select which evaluators to apply to VAPI calls:

• All Evaluators - Apply every available evaluator
• Selected Evaluators - Choose specific evaluators for this integration

​

Step 5: Activate Integration

Review your settings and click Create Integration to begin syncing.

---

​

What Gets Synced

VAPI integrations sync comprehensive data:

• Calls - Complete conversation data and metadata
• Assistants - Assistant configurations and phone numbers
• Prompts - System prompts and instructions
• Transcripts - Full conversation transcripts with speaker labels
• Tool Calls - Function/tool invocations during conversations
• Call Metadata - Duration, status, participant information

---

​

Webhook Configuration

Roark automatically configures webhooks with VAPI. The integration handles:

Event	Description	Roark Action
call_started	Call initiated	Create call record, begin monitoring
call_ended	Call completed	Process transcript, run evaluations

The webhook URL is automatically registered with VAPI using your API key.

---

​

Sync Management

​

Initial Sync

During setup, Roark imports historical calls based on your selected date range:

• Processes calls in batches
• Shows sync progress in dashboard
• Handles large volumes efficiently

​

Ongoing Sync

After initial setup:

• New calls sync automatically via webhooks
• Real-time processing of live calls
• Automatic retry on temporary failures

​

Resume Sync

If sync is interrupted:

1. Go to integration settings
2. Click Resume Sync
3. Choose to continue from last position or restart

---

​

Monitoring Integration Health

Track your integration status:

• Syncing 🔄 - Actively importing historical calls
• Active 🟢 - Receiving new calls via webhook
• Paused ⏸️ - Sync temporarily halted
• Error ⚠️ - Configuration or connection issues

View sync statistics:

• Total calls synced
• Last sync timestamp
• Sync progress percentage
• Recent webhook deliveries

---

​

Assistant Management

Synced assistants appear in:

• Simulation assistant selection - Use for testing
• Assistant performance reports - Track metrics per assistant
• Comparison dashboards - Analyze across assistants

Assistant data updates automatically when modified in VAPI.

---

​

Next Steps