Observability

Overview

Learn how to monitor, analyze, and optimize your VAPI-based voice agents using Cekura’s observability tools. This guide will walk you through setting up and configuring your VAPI integration.

Auto-fetch
No-code VAPI Integration
Forwarding VAPI respone

Auto-fetch is the simplest way to get VAPI calls into Cekura. When enabled, Cekura pulls your call data from VAPI 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 VAPI as the voice provider.

Add VAPI credentials

In the Agent Settings page:

Select VAPI as the voice integration provider
Add your VAPI API key
Enter your VAPI Assistant ID

Enable auto-fetch

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

Test your integration

Make a test call from VAPI. 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 VAPI agent with Cekura’s observability suite:

Get your Cekura API Key

Navigate to the API keys section in your Cekura dashboard settings. If you don’t have an API key yet, create a new one. Copy the API key value as you’ll need it to authenticate your requests to Cekura’s observability API.

Add Cekura credentials to VAPI

In your VAPI dashboard, navigate to integrations in your account settings and add custom integration with the following details:

Auth type: Bearer token
Credential name: Cekura API key
Token: Your Cekura API key
Header name: X-CEKURA-API-KEY
Include bearer prefix: No

Configure Server URL in VAPI

In your VAPI dashboard, navigate to your agent settings and configure the Server URL and authorization header you created in the previous step. This URL is used for all communication between your application and VAPI, including context retrieval, function calls, and end-of-call reporting.Set the Server URL to:

https://api.cekura.ai/observability/v1/vapi/observe/?agent_id=YOUR_AGENT_ID

Get your Assistant ID

Each VAPI agent has a unique Assistant ID that identifies your specific implementation. Copy your Assistant ID from the VAPI dashboard:

Add credentials to Cekura

In your Cekura Agent Settings page:

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

Test your integration

Make a test call from VAPI (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 VAPI response to Cekura’s observability suite:

Configure forwarding endpoint

Set up a forwarding mechanism to send the VAPI 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 VAPI webhook response to Cekura with the following request body structure:

{
  "agent": <agent_id_in_cekura>,
  "voice_recording_url": vapi_response["stereoRecordingUrl"],
  "transcript_type": "vapi",
  "transcript_json": vapi_response["messages"],
  "call_id": vapi_response["id"],
  "call_ended_reason": vapi_response["endedReason"]
}

Get Started

Key Concepts

Guides

Integrations

Advanced

Overview

​Overview

Overview