Your First Agent

curl -X POST https://api.oneinbox.ai/v1/agents \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Bot",
    "language": "en",
    "first_message": "Hi {{lead_name}}, this is Aria from Acme. I'\''m reaching out about our product — do you have two minutes?",
    "silence_timeout_seconds": 10,
    "max_duration_seconds": 300,
    "enable_recording": true,
    "voicemail_detection": true,
    "voicemail_message": "Hi {{lead_name}}, this is Aria from Acme. Please call us back at 555-0100 — we'\''d love to chat."
  }'

{
  "id": "agt_abc123",
  "llm_id": "llm_xyz789"
}

curl -X PATCH https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "system_prompt": "You are Aria, a friendly sales rep for Acme Corp. Your goal is to introduce our product, qualify the lead, and book a 30-minute demo if they are interested.\n\nGuidelines:\n- Keep replies short — one or two sentences\n- If they ask what Acme does: we help teams automate customer outreach with AI voice agents\n- Qualify by asking: their company size, current tool, and biggest pain point\n- If they want a demo, use the book_demo tool\n- If they want to talk to a human, use transfer_to_human\n- If they are not interested, thank them and use end_call",
    "temperature": 0.6
  }'

# 1. Capture lead info
curl -X POST https://api.oneinbox.ai/v1/tools \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "capture_lead",
    "type": "extract_information",
    "description": "Extract lead qualification data once the caller has answered the qualifying questions.",
    "extraction_schema": {
      "fields": [
        { "name": "company_name", "type": "string", "required": true, "description": "Name of their company" },
        { "name": "team_size", "type": "string", "description": "Number of people in their team" },
        { "name": "pain_point", "type": "string", "description": "Their main challenge or pain point" }
      ]
    }
  }'

# 2. Book a demo
curl -X POST https://api.oneinbox.ai/v1/tools \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "book_demo",
    "type": "schedule_calendar_event",
    "description": "Book a 30-minute demo when the caller agrees to a meeting.",
    "calendar_config": {
      "calendar_id": "primary",
      "duration_minutes": 30,
      "timezone": "America/New_York"
    }
  }'

# 3. Transfer to human
curl -X POST https://api.oneinbox.ai/v1/tools \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "transfer_to_human",
    "type": "transfer_call",
    "description": "Transfer to a human agent when the caller asks to speak to a person.",
    "transfer_to": "+15105550100"
  }'

# 4. End call cleanly
curl -X POST https://api.oneinbox.ai/v1/tools \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "end_call",
    "type": "end_call",
    "description": "End the call after the task is done or the caller says goodbye."
  }'

curl -X PATCH https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_ids": ["<capture_lead_id>", "<book_demo_id>", "<transfer_id>", "<end_call_id>"]
  }'

curl -X POST https://api.oneinbox.ai/v1/phone-numbers \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+15739693824",
    "friendly_name": "Sales Line",
    "provider": "twilio",
    "agent_id": "<agent_id>",
    "credential_id": "<crd_abc123>"
  }'

curl -X POST https://api.oneinbox.ai/v1/calls \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "<agent_id>",
    "to_number": "+919876543210",
    "from_number": "+15739693824",
    "variables": {
      "lead_name": "Priya"
    }
  }'

{
  "id": "call_abc123",
  "status": "initiated"
}

# 1. Stop the call (if not already ended by the agent)
curl -X POST https://api.oneinbox.ai/v1/calls/<call_id>/stop \
  -H "Authorization: Bearer <api_key>"

# 2. Wait 2–3 seconds, then fetch
curl https://api.oneinbox.ai/v1/calls/<call_id> \
  -H "Authorization: Bearer <api_key>"

{
  "id": "call_abc123",
  "status": "completed",
  "duration_seconds": 124,
  "analysis": {
    "outcome": "Appointment Booked",
    "summary": "Priya agreed to a 30-minute demo on Thursday. She runs a team of 12 and is currently using spreadsheets."
  },
  "messages": [
    { "role": "agent", "content": "Hi Priya, this is Aria from Acme..." },
    { "role": "user", "content": "Yes, I've been looking for something like this..." }
  ],
  "recording_url": "https://storage.oneinbox.ai/recordings/call_abc123.mp3"
}