Openclaw Skill

AI phone agent for any business — answers inbound calls 24/7, captures leads, books appointments, and returns structured call data with transcripts, summaries, and sentiment. Provision a phone agent in seconds via API, then query calls, leads, and analytics. Use to add phone handling to any agent workflow.

AgentIzzy Phone Agent

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.

Setup

1. Register for a free API key (instant, no approval needed):

   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.

2. Set environment variable:

   bash

   export AGENTIZZY_API_KEY="aiz_your_key_here"
   

Provision a Phone Agent

Set up a new AI phone agent for a business:

bash

bash scripts/setup.sh "Business Name" "vertical" "phone" "website_url"

Arguments:

• name (required): Business name — Izzy uses this in greetings
• vertical (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 transfers
• website (optional): Business website URL — Izzy scrapes it to learn services, FAQs, hours

Example:

bash

bash scripts/setup.sh "Sunrise Dental" "dental" "[phone]" "https://www.sunrisedental.com"

Returns:

json

{
  "id": "agent-aik-1234567890-1713000000000",
  "bizCode": "A3K7X2",
  "name": "Sunrise Dental",
  "vertical": "dental",
  "demo_phone": "[phone]",
  "demo_code": "A3K7X2",
  "status": "active"
}

After provisioning, callers can reach the agent by calling the demo line ([phone]) 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.

Get Call History

Retrieve recent calls with AI summaries and sentiment:

bash

bash scripts/calls.sh "agent_id" [limit] [since]

Arguments:

• agent_id (required): The id returned from setup
• limit (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

bash scripts/calls.sh "agent-aik-1234567890-1713000000000" 10 "2026-04-01"

Returns:

json

{
  "calls": [
    {
      "id": "call-uuid",
      "caller_number": "[phone]",
      "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 transcript
• ai_summary: 1-2 sentence summary generated by AI after the call
• sentiment: positive, neutral, or negative
• tag: new_lead, general, missed, or spam
• duration_seconds: Call length
• recording_url: Link to call recording (when available)

Dependencies: Requires curl.

Get Captured Leads

Retrieve leads captured during calls:

bash

bash scripts/leads.sh "agent_id" [limit]

Arguments:

• agent_id (required): The id returned from setup
• limit (optional): Number of leads to return (default: 50, max: 100)

Example:

bash

bash scripts/leads.sh "agent-aik-1234567890-1713000000000" 20

Returns:

json

{
  "leads": [
    {
      "id": "lead-uuid",
      "first_name": "Sarah",
      "last_name": "Chen",
      "phone": "[phone]",
      "email": "[e-mail]",
      "notes": "Interested in teeth whitening, prefers morning appointments",
      "status": "new",
      "created_at": "2026-04-13T14:32:00Z"
    }
  ]
}

Dependencies: Requires curl.

Quick API Access (curl only)

For environments without the scripts, call the API directly:

bash

# 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"

Webhook Events

Configure a webhook URL to receive real-time events:

bash

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, duration
• lead.captured — new lead extracted from a call
• sms.received — inbound SMS to the business line

Dedicated Phone Numbers (Pro/Enterprise)

Search for available numbers:

bash

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):

bash

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": "[phone]"}'

Pricing

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:

bash

curl -s https://api.agentizzy.com/api/v1/billing/usage \
  -H "Authorization: Bearer $AGENTIZZY_API_KEY"

Upgrade to a paid plan:

bash

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.

Rate Limits

• API: 60 requests/minute per API key
• Provisioning: limited by plan (1 / 10 / unlimited agents)
• Call minutes: limited by plan (30 / 100 included / pay-per-use per month)
• Call/Lead queries: 100 results per request (paginate with limit and offset)

Use When

• You need to add phone call handling to an agent workflow
• You want AI-powered lead capture from inbound calls
• You need structured call data (transcripts, summaries, sentiment) for downstream processing
• You are building a multi-channel agent that handles phone, chat, and email
• You want to monitor call activity and lead flow programmatically

NOT For

• Outbound calling or cold calls (V1 is inbound only)
• Real-time call transcription streaming (transcripts available after call ends)
• Direct Twilio/telephony configuration — AgentIzzy manages the phone infrastructure
• SMS-only workflows without phone calls

External Endpoints

• api.agentizzy.com — AgentIzzy Agent API (HTTPS only, agentizzy.com domain)

Security & Privacy

• All API requests are authenticated via Bearer token over HTTPS
• API keys are SHA-256 hashed at rest — AgentIzzy never stores plaintext keys
• Call recordings and transcripts are stored in Cloudflare infrastructure (US)
• Lead data (names, phone numbers, emails) is captured during calls and stored per-agent
• Agents can only access data for phone agents they provisioned (ownership verified per request)
• Webhook payloads are sent via HTTPS POST — use HTTPS endpoints only
• For compliance requirements, contact [e-mail]