> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bland AI

> Sync Bland AI agents and analyze voice AI conversations

<Badge color="green">Live monitoring</Badge> <Badge color="green">Voice simulations</Badge> <Badge color="gray" stroke>Chat simulations</Badge>

## 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](https://app.bland.ai))
* Call recording enabled in your Bland AI send call payload (see [Call Payload Configuration](#call-payload-configuration) below)

***

## Call Payload Configuration

To sync calls with Roark, you must include two fields in your Bland AI send call payload:

| Field            | Type      | Description                                                                                                                     |
| :--------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------ |
| **`persona_id`** | `string`  | The agent/persona ID. Roark uses this to match calls to agents and determine which calls to sync based on your selected agents. |
| **`record`**     | `boolean` | Must be set to `true` so the call is recorded and Roark can access the audio for analysis.                                      |

<Warning>
  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.
</Warning>

***

## Setup Instructions

### Step 1: Create Integration

1. Navigate to **Agents** in your Roark dashboard
2. Click **Connect Agent** in the top right, choose **Existing Platform**, and select **Bland AI**
3. Enter your configuration:

| Field                | Description                        |
| :------------------- | :--------------------------------- |
| **Integration Name** | Friendly name for this integration |
| **API Key**          | Your 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.

| Phase          | What Happens                                                                                                               |
| :------------- | :------------------------------------------------------------------------------------------------------------------------- |
| **Agent Sync** | Fetches all agents, updates names and configurations                                                                       |
| **Call Sync**  | Fetches 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

<CardGroup cols={2}>
  <Card title="Run Simulations" icon="play" href="/documentation/simulation-testing/running-simulations">
    Test synced agents with simulations
  </Card>

  <Card title="View Call History" icon="chart-line" href="/documentation/observability/live-monitoring">
    Browse and analyze synced calls
  </Card>

  <Card title="Collectors" icon="shield" href="/documentation/metrics/metric-collectors">
    Automate metric collection on calls
  </Card>

  <Card title="Integration Overview" icon="plug" href="/documentation/integrations/overview">
    Explore other integrations
  </Card>
</CardGroup>