AI-powered inbound phone agent for any business. Answers calls 24/7, captures leads, books appointments, and returns structured call transcripts, summaries, and sentiment. Provision a dedicated phone agent in seconds, then query call history, leads, and analytics.
V1 is inbound only — callers reach Izzy, who handles the conversation, captures intent, and logs everything.
```bash
curl -s -X POST https://api.agentizzy.com/api/v1/register \
-H "Content-Type: application/json" \
-d '{"name": "My Agent", "agent_id": "my-agent"}'
```
Returns an api_key starting with aiz_ — save it, shown only once.
```bash
export AGENTIZZY_API_KEY="aiz_your_key_here"
```
Set up a new AI phone agent for a business:
bash scripts/setup.sh "Business Name" "vertical" "phone" "website_url"
Arguments:
name (required): Business name — Izzy uses this in greetingsvertical (optional): Industry vertical for specialized behavior. Options: storage, hvac, dental, legal, salon, plumbing, automotive, generic. Default: auto-detected from website.phone (optional): Business phone number for call transferswebsite (optional): Business website URL — Izzy scrapes it to learn services, FAQs, hoursExample:
bash scripts/setup.sh "Sunrise Dental" "dental" "+15551234567" "https://www.sunrisedental.com"
Returns:
{
"id": "agent-aik-1234567890-1713000000000",
"bizCode": "A3K7X2",
"name": "Sunrise Dental",
"vertical": "dental",
"demo_phone": "+16783299415",
"demo_code": "A3K7X2",
"status": "active"
}
After provisioning, callers can reach the agent by calling the demo line (+1 678-329-9415) and entering the demo_code. The id field is used for all subsequent API calls.
Dependencies: This script uses curl for HTTP requests and python3 for safe JSON escaping. Both must be available in your PATH.
Retrieve recent calls with AI summaries and sentiment:
bash scripts/calls.sh "agent_id" [limit] [since]
Arguments:
agent_id (required): The id returned from setuplimit (optional): Number of calls to return (default: 20, max: 100)since (optional): ISO date filter — only calls after this date (e.g., 2026-04-01)Example:
bash scripts/calls.sh "agent-aik-1234567890-1713000000000" 10 "2026-04-01"
Returns:
{
"calls": [
{
"id": "call-uuid",
"caller_number": "+15559876543",
"started_at": "2026-04-13T14:30:00Z",
"duration_seconds": 127,
"transcript": "Agent: Thank you for calling Sunrise Dental...",
"ai_summary": "Caller asked about teeth whitening pricing and booked a consultation for next Tuesday.",
"sentiment": "positive",
"tag": "new_lead"
}
]
}
Key fields:
transcript: Full call transcriptai_summary: 1-2 sentence summary generated by AI after the callsentiment: positive, neutral, or negativetag: new_lead, general, missed, or spamduration_seconds: Call lengthrecording_url: Link to call recording (when available)Dependencies: Requires curl.
Retrieve leads captured during calls:
bash scripts/leads.sh "agent_id" [limit]
Arguments:
agent_id (required): The id returned from setuplimit (optional): Number of leads to return (default: 50, max: 100)Example:
bash scripts/leads.sh "agent-aik-1234567890-1713000000000" 20
Returns:
{
"leads": [
{
"id": "lead-uuid",
"first_name": "Sarah",
"last_name": "Chen",
"phone": "+15559876543",
"email": "sarah@example.com",
"notes": "Interested in teeth whitening, prefers morning appointments",
"status": "new",
"created_at": "2026-04-13T14:32:00Z"
}
]
}
Dependencies: Requires curl.
For environments without the scripts, call the API directly:
# List your provisioned agents
curl -s https://api.agentizzy.com/api/v1/agents \
-H "Authorization: Bearer $AGENTIZZY_API_KEY"
# Get calls for an agent
curl -s "https://api.agentizzy.com/api/v1/agents/AGENT_ID/calls?limit=10" \
-H "Authorization: Bearer $AGENTIZZY_API_KEY"
# Get analytics
curl -s "https://api.agentizzy.com/api/v1/agents/AGENT_ID/stats?days=30" \
-H "Authorization: Bearer $AGENTIZZY_API_KEY"
Configure a webhook URL to receive real-time events:
curl -s -X POST "https://api.agentizzy.com/api/v1/agents/AGENT_ID/webhook" \
-H "Authorization: Bearer $AGENTIZZY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://your-endpoint.com/webhook"}'
Events fired:
call.completed — call finished, includes summary, sentiment, durationlead.captured — new lead extracted from a callsms.received — inbound SMS to the business lineSearch for available numbers:
curl -s -X POST "https://api.agentizzy.com/api/v1/agents/AGENT_ID/phone/search" \
-H "Authorization: Bearer $AGENTIZZY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"areaCode": "404"}'
Provision a dedicated number (callers reach the agent directly, no access code):
curl -s -X POST "https://api.agentizzy.com/api/v1/agents/AGENT_ID/phone/provision" \
-H "Authorization: Bearer $AGENTIZZY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phoneNumber": "+14045551234"}'
Usage-based pricing designed for autonomous agents:
| Plan | Price | Agents | Minutes | Phone Numbers | Overage |
|---|---|---|---|---|---|
| ------ | ------- | -------- | --------- | --------------- | --------- |
| Free | $0/mo | 1 | 30/mo | 0 (shared demo line) | blocked |
| Builder | $29/mo | 10 | 100 included | 3 dedicated | $0.20/min |
| Scale | $0/mo base | Unlimited | Pay-per-use | 10 dedicated | $0.15/min ($50/mo min) |
Check current usage and plan details:
curl -s https://api.agentizzy.com/api/v1/billing/usage \
-H "Authorization: Bearer $AGENTIZZY_API_KEY"
Upgrade to a paid plan:
curl -s -X POST https://api.agentizzy.com/api/v1/billing/checkout \
-H "Authorization: Bearer $AGENTIZZY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tier": "builder"}'
Returns a Stripe checkout URL — direct the account owner to complete payment. Plan upgrades take effect immediately.
limit and offset)api.agentizzy.com — AgentIzzy Agent API (HTTPS only, agentizzy.com domain)共 1 个版本