Skip to main content
Retell integration is coming soon. This page documents the planned implementation.

​
Overview

Retell is a voice AI platform for building conversational agents. Preclinical will support testing Retell agents via their HTTP and WebSocket APIs.

​
Planned Configuration

interface RetellConfig {
  provider: "retell";
  config: {
    api_key: string;           // Retell API key
    agent_id: string;          // Target agent ID

    // Optional
    voice_id?: string;         // Voice for responses
    language?: string;         // Language code
    timeout_ms?: number;       // Default: 120000
  };
}

​
Planned Setup

1

Get API Credentials

  1. Go to Retell Dashboard
  2. Navigate to API Keys
  3. Create or copy your API key
2

Get Agent ID

  1. In Retell Dashboard, go to Agents
  2. Select your agent
  3. Copy the Agent ID
3

Add Integration

{
  "name": "My Retell Agent",
  "provider": "retell",
  "config": {
    "api_key": "your-retell-api-key",
    "agent_id": "agent_xxxxx"
  }
}

​
Planned Features

Call API

Create and manage calls via Retell API

WebSocket Streaming

Real-time audio streaming for voice tests

Transcript Capture

Full conversation transcripts

Metrics

Latency, duration, and call quality metrics

​
Timeline

We’re actively working on Retell integration. Expected availability:
  • HTTP Chat Mode: Q1 2026
  • Voice Mode (WebSocket): Q2 2026

​
Stay Updated

Request Early Access

Contact us if you need Retell integration sooner

​
In the Meantime

If you’re using Retell and need testing now:
  1. OpenAI Mode: If your Retell agent uses an OpenAI-compatible backend, you can test that directly via the OpenAI integration
  2. API Testing: Use Retell’s API directly for basic testing, then use Preclinical for grading transcripts

​
Next Steps

Available Integrations

See currently supported providers

OpenAI Integration

Test OpenAI-compatible endpoints