Documentation Index
Fetch the complete documentation index at: https://docs.cekura.ai/llms.txt
Use this file to discover all available pages before exploring further.
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.
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
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/
-
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"]
}
