Outbound Voice Calling

Sayvy AI connects to tier-1 telecommunications carriers via Twilio and SIP trunks to deliver high-fidelity, low-latency audio to mobile and landline phones globally.

Triggering an Outbound Call

curl -X POST https://api.sayvy.ai/api/v1/telephony/calls \
  -H "Authorization: Bearer sayvy_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "ag_8f3b0e2a9",
    "to_number": "+14155550192",
    "from_number": "+14155550100",
    "record_audio": true,
    "max_duration_seconds": 1800
  }'

Call Status Workflow

Calls transition through the following states:

queued: Dispatched to carrier queue.
ringing: The recipient’s handset is ringing.
in-progress: The call was answered; speech audio stream initialized.
completed: Normal termination after hang-up.
busy / failed / no-answer: Destination unreachable or rejected.

Each event triggers a webhook payload if configured.