Observability

Overview

This guide walks you through setting up and monitoring your Retell-based voice agents using Cekura’s observability suite. Learn how to configure your integration and access powerful monitoring tools.

Auto-fetch
No-code Retell Integration
Forwarding Retell response

With auto-fetch enabled, Cekura automatically pulls your call data from Retell’s API every 30 seconds—no webhook configuration required.

Create or select an agent

In your Cekura dashboard, create a new agent or select an existing one with Retell as the voice provider.

Add credentials to Cekura

In your Cekura Agent Settings page:

Select Retell as the voice integration provider
Add your Retell API key
Enter your Retell agent ID

Auto-fetch requires your Retell API key to have the History.Read scope to retrieve call history. If the key lacks this scope, Cekura will receive a 403 error from Retell and automatically disable auto-fetch to prevent a recurring error loop.

Enable auto-fetch

Toggle on Auto-fetch Production Calls in the voice integration settings.

Test your integration

Make a test call from Retell. Within 30 seconds, your call should appear in the Cekura observability Calls section.

Auto-fetch is ideal for getting started quickly or when you can’t configure webhooks. For real-time call data, use the webhook-based setup in the other tabs.

Follow these steps to connect your Retell agent with Cekura’s observability suite:

Configure webhook URL in Retell

In your Retell dashboard, add the observability webhook URL:

https://api.cekura.ai/observability/v1/retell/observe/

You can configure the webhook at either level:

Setting Webhook at Agent level: Navigate to your agent settings and add the webhook URL for a specific agent.
Setting Webhook at Workspace level: Navigate to your workspace settings and add the webhook URL for all agents in the workspace.

Verify Retell API key

Go to the API keys section in your Retell dashboard. Create/ensure you have at least one API key configured with the webhook tag set.

Add credentials to Cekura

In your Cekura Agent Settings page:

Add the API key from Retell with the tag webhook
Copy and add your agent ID from Retell

Test your integration

Make a test call from Retell (phone number based or webcall). Your calls should now appear in the Cekura observability Calls section.

If you already have an existing webhook setup and want to forward the Retell response to Cekura’s observability suite:

Configure forwarding endpoint

Set up a forwarding mechanism to send the Retell webhook response to Cekura’s observability endpoint:

POST https://api.cekura.ai/observability/v1/observe/

Add authentication headers

Include your Cekura API key in the request headers:

X-CEKURA-API-KEY: <your_cekura_api_key>
Content-Type: application/json

Forward the request body

Forward the Retell webhook response to Cekura with the following request body structure:

{
  "agent": <agent_id_in_cekura>,
  "voice_recording_url": retell_response["recording_multi_channel_url"],
  "transcript_type": "retell",
  "transcript_json": retell_response["transcript_with_tool_calls"],
  "call_id": retell_response["call_id"],
  "call_ended_reason": retell_response["disconnection_reason"]
}

Get Started

Key Concepts

Guides

Integrations

Advanced

Overview

​Overview

Overview