Skip to main content

​
What is Auto Outbound Call?

Auto Outbound Call is an automated testing feature where Cekura automatically initiates outbound calls when you run evaluators. Unlike manual outbound testing where you write scripts to handle calls, this feature does everything automatically.

​
How It Works

1

Enable Auto Outbound

Toggle the Auto Outbound Call setting ON in your agent settings
2

Run Evaluators

Execute evaluators through the dashboard - no script needed
3

System Calls Automatically

Cekura uses your voice provider (Vapi, Retell, or ElevenLabs) to initiate calls
4

Review Results

Check test results and transcripts in your dashboard

​
Prerequisites

  • Outbound mode enabled: Agent’s inbound must be set to false
  • Voice provider configured: Valid API key and Assistant ID for your provider (Vapi, Retell, or ElevenLabs)
  • Agent contact_number set to your outbound caller ID: Cekura validates the caller ID (ANI) of every incoming outbound-test call against the agent’s contact_number field. If the provider dials from +15551234567, the agent’s contact_number must be exactly +15551234567 in E.164 format. Set this in Agent settings or via the Update Agent API.
  • Evaluators ready: Created evaluators with valid phone numbers
API Key Permissions: Ensure your API key has outbound call permissions enabled. For ElevenLabs, enable “Conversational AI” and “Phone Number” permissions at https://elevenlabs.io/app/settings/api-keys
Caller ID mismatch causes silent rejects. If the contact_number on your agent is empty or doesn’t match the from_number your voice provider uses to place the call, Cekura drops the incoming call without returning a SIP error. The symptom on the provider side is Busy, NoAnswer, or a generic failed dial — no audio, no descriptive error. Confirm contact_number matches the provider’s outbound caller ID before debugging anything further.

​
Enabling Auto Outbound Call

Navigate to your Agent settings -> Right sidebar -> Connection -> Select Telephony under VOICE -> Toggle ON Auto Outbound Call.
Enable Auto Outbound
Ensure your voice provider account has sufficient credits for making calls.

​
Advanced: Trigger URL Webhook

For advanced use cases, you can configure a Trigger URL to receive webhook notifications instead of automatic calls. This lets you add custom logic before the call is made.
Advanced Feature: When you configure a trigger URL, Cekura sends a webhook to your endpoint instead of automatically calling. You must handle the actual call initiation yourself.

​
When to Use

Use trigger URLs when you need to:
  • Add validation or business logic before calls
  • Schedule calls for specific times
  • Integrate with internal systems
  • Log or audit call requests

​
How It Works

1

Add Trigger URL

In your agent settings, enter your webhook URL in the Trigger URL field (below the Outbound Auto Call toggle).
Configure Trigger URL in UI
2

Receive Webhook

When evaluators run, Cekura sends a POST request to your URL with call details
3

Make the Call

Your system processes the webhook and initiates the call using your provider’s API

​
Webhook Payload

Cekura sends the following JSON payload to your trigger URL: 
{
  "from_number": "+1234567890",
  "to_number": "+14159976447",
  "dynamic_variables": {
    "customer_name": "John Doe",
    "policy_number": "POL123456"
  }
}
Fields:
  • from_number: Your agent’s contact number (the number making the call)
  • to_number: The evaluator’s phone number (where to call)
  • dynamic_variables: Optional test profile data for dynamic prompting
Your webhook endpoint must be publicly accessible (HTTPS), return a 200 or 201 status code, and respond within 30 seconds.
Dial window timing: Each outbound run has a dial window that opens when the run reaches pending status. The call must be placed before outbound_dial_window_closes_at (default 300 seconds after the window opens). Dials received after the deadline are dropped and the run returns status: timeout. The three dial-window fields (outbound_dial_window_opens_at, outbound_dial_window_seconds, outbound_dial_window_closes_at) are included in run responses so you can track the deadline.

​
Response Format

Your webhook should return: 
{
  "success": true,
  "call_id": "optional_provider_call_id"
}

​
Troubleshooting

Check that Auto Outbound Call is enabled, agent is in Outbound mode, and voice provider credentials are valid.
The provider dialed but Cekura never picked up. Two possible causes:
  1. Dialed too late — if the provider dialed after outbound_dial_window_closes_at (check the run response for this field; default is 300 seconds after the run reached pending), Cekura dropped the call. This can happen if the trigger URL webhook is slow to respond or if there’s a delay in your call logic.
  2. Caller-ID mismatch — Cekura rejects incoming outbound-test calls whose caller ID doesn’t match a configured contact_number on any agent in your project. Open the agent under test and confirm its contact_number is set to the exact E.164 number the provider dials from (the from_number in the trigger webhook payload). An empty or mismatched contact_number causes every outbound attempt to be silently dropped — your provider logs will show Busy / NoAnswer / no-pickup with no audio and no SIP error explaining why. After correcting contact_number, trigger a fresh run; the timed-out runs cannot be recovered.
Check API key permissions at your provider’s settings. For ElevenLabs, ensure “Conversational AI” and “Phone Number” permissions are enabled at https://elevenlabs.io/app/settings/api-keys. Verify phone number format is E.164 (+1XXXXXXXXXX).
Verify trigger URL is publicly accessible (HTTPS), returns 200/201 status, and no firewall is blocking requests.

​
Best Practices

  • Monitor credits: Track your provider account balance
  • Valid numbers: Use correct phone number format (+1XXXXXXXXXX)
  • Secure webhooks: Use HTTPS, validate requests, implement rate limiting

​
Next Steps