Skip to main content

Overview

To speak with an agent directly in a browser without dialing a phone number, see WebRTC browser calls. The Voice Calls API lets you place an AI voice call to any lead immediately, without creating or launching a campaign. This is ideal for:
  • GHL workflow actions, a workflow step that fires a call when a contact hits a stage
  • One-off outreach, dialing a single lead from an external system
  • Post-event triggers, calling someone who just filled in a form
Calls use Sendora’s managed voice service. Transcripts and recordings appear in the lead’s Unibox thread once the call ends.

Place a call

The response returns immediately with status: "dialing". The actual call result (transcript, recording, outcome) is available via GET /calls?id=CALL_ID once the call ends, typically within 30 to 90 seconds.

Prompt personalization

Override the agent’s system prompt for a single call with {{lead.*}} tokens resolved at dial time:

Voice override

Use a different managed voice for a specific call. Retrieve available voice IDs from GET /voices.

List call history

One endpoint lists calls and returns a single call (id). Filter by lead, agent, campaign, or outcome:
Available disposition values: answered, voicemail, no-answer, busy, failed.

Get transcript and recording

Test calls

The same endpoint starts a test call so you can try an agent before it talks to a lead. Send test: true, the agent_id, and a mode:
A test call needs no lead_id. Phone test calls dial a real number, so only use a number you control. Test calls can create call records and use credits, so do not retry them blindly after a timeout.

Webhooks

Subscribe to call.completed to be notified when any call ends:
See Webhooks for setup instructions.

Idempotency

Pass idempotency_key to safely retry on network failure without placing a duplicate call. Repeating a request with the same key returns the original call; no new call is placed and nothing is charged again: