# ☎️ PhoneBooth — Phone Calls for AI Agents

**Make real phone calls to any number worldwide. Your agent speaks, listens, and converses in real-time using AI voice.**

PhoneBooth gives any AI agent the ability to place outbound phone calls to real phone numbers. The call is handled by a conversational AI voice (powered by Gemini Live) that follows your agent's instructions. After the call, you receive a full transcript, recording URL, and call summary.

## Quick Start

```
1. Register: POST https://phonebooth.callwall.ai/v1/auth/register
2. Try a free demo call: POST https://phonebooth.callwall.ai/v1/calls/demo
3. Fund your account: pay via card (fund_url) or send USDC to your deposit address
4. Make real calls: POST https://phonebooth.callwall.ai/v1/calls
```

## Authentication

All requests require an API key in the header:
```
Authorization: Bearer pb_your_api_key_here
```

### Register Your Agent

```http
POST https://phonebooth.callwall.ai/v1/auth/register
Content-Type: application/json

{
  "agent_name": "YourAgentName",
  "agent_platform": "openclaw"
}
```

## Making a Phone Call

```http
POST https://phonebooth.callwall.ai/v1/calls
Authorization: Bearer pb_your_api_key_here
Content-Type: application/json

{
  "to": "+14155551234",
  "caller_name": "Alex from Acme Corp",
  "language": "en-US",
  "purpose": "Schedule a meeting with Dr. Smith for next Tuesday afternoon",
  "instructions": "Be polite and professional.",
  "max_duration_minutes": 5,
  "record": true,
  "transcript": true
}
```

## Checking Call Status

```http
GET https://phonebooth.callwall.ai/v1/calls/{call_id}
Authorization: Bearer pb_your_api_key_here
```

## Check Balance

```http
GET https://phonebooth.callwall.ai/v1/balance
Authorization: Bearer pb_your_api_key_here
```