> ## 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.

# ElevenLabs

> Sync ElevenLabs conversational AI agents and run voice and chat simulations

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

## Overview

The ElevenLabs integration syncs your conversational AI agents and their calls into Roark. Agents, prompts, phone numbers, and tools are imported automatically, and calls are pulled on a recurring schedule so every conversation is analyzed.

A single ElevenLabs integration unlocks all three of Roark's capabilities for connected agents:

* **Live call monitoring** — pull conversation audio, transcripts, and metadata on a recurring schedule.
* **Voice simulations** — drive synthesized voice conversations against synced agents over phone or WebRTC.
* **Chat simulations** — drive [text-based simulations](/documentation/simulation-testing/chat-simulations) against synced agents over the ElevenLabs Conversational AI WebSocket. Roark auto-creates a chat endpoint for each agent on integration setup, so once you've connected ElevenLabs you can use any synced agent in a chat run plan immediately.

***

## Prerequisites

Before setting up the integration, ensure you have:

* An ElevenLabs account with active conversational AI agents
* An ElevenLabs API key (found in your ElevenLabs dashboard)
* Agents with **voice recording enabled** (agents with Zero Retention Mode or recording disabled cannot sync calls)

***

## Setup Instructions

### Step 1: Create Integration

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

| Field                | Description                        |
| :------------------- | :--------------------------------- |
| **Integration Name** | Friendly name for this integration |
| **API Key**          | Your ElevenLabs API key            |

The system will validate your API key and fetch available agents.

### 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

<Note>
  Historical sync runs as a backfill job during initial setup. Ongoing calls are synced automatically on a recurring schedule.
</Note>

### Step 3: Select Agents

Choose which ElevenLabs agents to monitor:

* **All Agents** — Sync calls from every agent in your account
* **Selected Agents** — Choose specific agents to monitor

The agent selector shows each agent's name and ID. Agents with Zero Retention Mode enabled or voice recording disabled will be flagged as unavailable for call sync.

### Step 4: Activate Integration

Review your settings and click **Create Integration** to begin syncing.

***

## What Gets Synced

ElevenLabs integrations sync comprehensive data:

* **Calls** — Conversation audio, transcripts, and metadata
* **Agents** — Agent configurations and settings
* **Prompts** — System prompts configured for each agent
* **Phone Numbers** — Phone number endpoints assigned to agents
* **Tools** — Tool definitions available to agents
* **Call Metadata** — Duration, direction (inbound/outbound), interface type (phone/web), termination reason

***

## How Sync Works

ElevenLabs uses **pull-based synchronization** — Roark periodically fetches new calls from the ElevenLabs API rather than receiving webhooks.

| Phase            | What Happens                                                                                          |
| :--------------- | :---------------------------------------------------------------------------------------------------- |
| **Agent Sync**   | Fetches all agents, updates names and configurations, syncs prompts, phone numbers, and tools         |
| **Health Check** | Verifies each agent's recording and privacy settings are compatible                                   |
| **Call Sync**    | Fetches conversations since last sync, downloads audio, parses tool invocations, creates call records |

Calls must be at least 10 seconds long and have a successful status to be synced.

***

## Agent Privacy Settings

ElevenLabs agents have privacy controls that affect what Roark can sync:

* **Zero Retention Mode** enabled → Call recordings unavailable, calls cannot be synced
* **Record Voice** disabled → Same as above

During health checks, Roark flags agents with these settings so you know which agents can and cannot sync call data.

***

## 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.

***

## 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>