Skip to main content

​
Calls

Calls are the core of Nedzo - connecting your AI agents with contacts via phone.

​
How Calls Work

1

Initiate

You send a POST request to /v1/call with the agent and phone number
2

Connect

Nedzo dials the phone number using your workspace’s caller ID
3

Conversation

The AI agent conducts the conversation based on its system prompt
4

Complete

When the call ends, Nedzo saves the transcript, recording, and outcome

​
Initiating a Call

curl -X POST https://api.nedzo.ai/v1/call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent-uuid",
    "phoneNumber": "+14155551234",
    "variables": {
      "customerName": "John",
      "appointmentTime": "3pm tomorrow"
    }
  }'

​
Variables

Variables let you personalize each call:
SourcePriorityDescription
RequestHighestVariables passed in the API call
ContactMediumData from the contact’s metadata
AgentLowestDefault values from agent config
Variables are merged in priority order, so request variables override contact data.

​
Call Outcomes

OutcomeDescription
completedCall connected and conversation happened
no_answerRecipient didn’t answer
busyLine was busy
failedTechnical failure
voicemailWent to voicemail

​
Conversation Data

After a call completes, you can access:
  • Transcript - Full text of the conversation
  • Recording URL - Audio recording (if enabled)
  • Summary - AI-generated call summary
  • Duration - Call length in seconds
  • Cost - Call cost in credits

​
Webhooks

Nedzo can send webhooks when calls complete. Configure webhook URLs in your dashboard to receive real-time notifications. 
{
  "type": "call.completed",
  "data": {
    "callId": "call-uuid",
    "agentId": "agent-uuid",
    "outcome": "completed",
    "duration": 145,
    "transcript": "...",
    "summary": "..."
  }
}

​
API Operations