Skip to main content

​
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:

​
Call Payload Configuration

To sync calls with Roark, you must include two fields in your Bland AI send call payload:
FieldTypeDescription
persona_idstringThe agent/persona ID. Roark uses this to match calls to agents and determine which calls to sync based on your selected agents.
recordbooleanMust be set to true so the call is recorded and Roark can access the audio for analysis.
Calls without record: true will not have audio available and cannot be synced into Roark. Calls without a persona_id will not be matched to any agent.

​
Setup Instructions

​
Step 1: Create Integration

  1. Navigate to Settings → Integrations in your Roark dashboard
  2. Click Add Integration and select Bland AI
  3. Enter your configuration:
FieldDescription
Integration NameFriendly name for this integration
API KeyYour Bland AI API key
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
Roark syncs calls based on the 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.
PhaseWhat Happens
Agent SyncFetches all agents, updates names and configurations
Call SyncFetches conversations since last sync, downloads recordings, parses transcripts and tool invocations, creates call records
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
View sync statistics including total calls synced, last sync timestamp, and job history.

​
Agent Management

Synced agents appear in:
  • Simulation agent selection — Use for testing
  • Agent performance reports — Track metrics per agent
  • Comparison dashboards — Analyze across agents
Agent data updates automatically when modified in Bland AI.

​
Next Steps

Run Simulations

Test synced agents with simulations

View Call History

Browse and analyze synced calls

Metric Policies

Automate metric collection on calls

Integration Overview

Explore other integrations