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

# Leaping

> Sync Leaping AI agents and analyze voice conversations

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

## Overview

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

***

## Prerequisites

Before setting up the integration, ensure you have:

* A Leaping AI account with active agents
* A Leaping API key (found in your Leaping dashboard)
* At least one configured agent in Leaping

***

## Setup Instructions

### Step 1: Create Integration

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

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

### Step 4: Activate Integration

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

***

## What Gets Synced

Leaping integrations sync comprehensive data:

* **Calls** — Conversation transcripts, metadata, and call events
* **Agents** — Agent configurations and endpoints
* **Prompts** — System prompts configured for each agent
* **Tools** — Tool definitions available to agents
* **Call Metadata** — Duration, status, properties, and events

***

## How Sync Works

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

| Phase            | What Happens                                                                     |
| :--------------- | :------------------------------------------------------------------------------- |
| **Agent Sync**   | Fetches agents and endpoints, updates configurations, syncs prompts and tools    |
| **Health Check** | Verifies API connectivity and agent availability                                 |
| **Call Sync**    | Fetches calls since last sync for each agent, processes transcripts and metadata |

Calls with status `completed`, `transferred`, or `dropped` 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.

***

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