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
- Navigate to Settings → Integrations in your Roark dashboard
- Click Add Integration and select VAPI
- 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.
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
Historical sync runs once during initial setup. Future calls are synced automatically via webhooks.
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
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:
- Go to integration settings
- Click Resume Sync
- 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
