Overview
The Bland AI integration syncs your voice agents and their calls into Roark. Agents and calls are pulled on a recurring schedule so every conversation is analyzed and evaluated automatically.Prerequisites
Before setting up the integration, ensure you have:- A Bland AI account with active agents
- A Bland AI API key (found in your Bland AI dashboard)
- Call recording enabled in your Bland AI send call payload (see Call Payload Configuration below)
Call Payload Configuration
To sync calls with Roark, you must include two fields in your Bland AI send call payload:Setup Instructions
Step 1: Create Integration
- Navigate to Agents in your Roark dashboard
- Click Connect Agent in the top right, choose Existing Platform, and select Bland AI
- Enter your configuration:
The system will validate your API key and fetch available agents.
Step 2: Select Agents
Choose which Bland AI agents to monitor:- All Agents — Sync calls from every agent in your account
- Selected Agents — Choose specific agents to monitor
persona_id field in your call payload. Only calls matching your selected agents will be synced.
Step 3: Activate Integration
Review your settings and click Create Integration to begin syncing.What Gets Synced
Bland AI integrations sync the following data:- Calls — Conversation audio, transcripts, and metadata
- Agents — Agent/persona configurations
- Transcripts — Full conversation transcripts with speaker labels
- Tool Calls — Function/tool invocations during conversations
- Call Metadata — Duration, status, participant information
How Sync Works
Bland AI uses pull-based synchronization — Roark periodically fetches new calls from the Bland AI API rather than receiving webhooks.
Roark matches incoming calls to agents using the
persona_id included in your send call payload. Only calls with record: true and a valid persona_id are synced.
Monitoring Integration Health
Track your integration status in the Roark dashboard:- Syncing — Actively importing calls
- Active — Running on schedule, pulling new calls periodically
- Paused — Sync temporarily halted
- Error — Configuration or connection issues
Agent Management
Synced agents appear in:- Simulation agent selection — Use for testing
- Agent performance reports — Track metrics per agent
- Comparison dashboards — Analyze across agents
Next Steps
Run Simulations
Test synced agents with simulations
View Call History
Browse and analyze synced calls
Collectors
Automate metric collection on calls
Integration Overview
Explore other integrations