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.

No-code from VAPI
Forwarding VAPI respone

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

Get Started

Key Concepts

Guides

Integrations

Advanced

​Overview

Overview