Observability

Monitor and analyze your Retell-based voice agents

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

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

1. Create or select an agent

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

2. Add credentials to Cekura

   In your Cekura Agent Settings page:

   1. Select Retell as the voice integration provider
   2. Add your Retell API key
   3. Enter your Retell agent ID
3. Enable auto-fetch

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

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

No-code Retell Integration

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

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

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

   
3. Add credentials to Cekura

   In your Cekura Agent Settings page:

   1. Add the API key from Retell with the tag webhook

   2. Copy and add your agent ID from Retell

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

Forwarding Retell response

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

1. 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/
   
2. Add authentication headers

   Include your Cekura API key in the request headers:

   X-CEKURA-API-KEY: <your_cekura_api_key>
   Content-Type: application/json
   
3. 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"]
   }