---

name: agentphone version: 0.3.0 description: 使用 AgentPhone API 构建 AI 电话代理。当用户想要拨打电话、发送/接收短信、管理电话号码、创建语音代理、设置 webhooks 或查看用量时使用——任何与电话、号码或语音 AI 相关的事务。 risk: critical source: community homepage: https://agentphone.to docs: https://docs.agentphone.to metadata: {"api_base": "https://api.agentphone.to/v1"}

AgentPhone

AgentPhone 是一个面向 AI 代理的 API 优先电话平台。为你的代理提供电话号码、语音通话和短信功能——全部通过简单的 API 管理。

何时使用

• 当用户想要创建或管理 AI 电话代理、语音代理或电话自动化时使用
• 当用户需要购买、分配、释放或检查与代理工作流绑定的电话号码时使用
• 当用户想要通过 AgentPhone 拨打外呼电话、查看通话记录或发送和接收短信时使用
• 当用户配置 webhooks、托管语音模式或账户级别用量时使用
• 仅在用户明确表达意图后才执行花费金钱、发送消息、拨打电话或释放电话号码的操作

基础 URL： https://api.agentphone.to/v1

文档： docs.agentphone.to

控制台： agentphone.to

---

工作原理

AgentPhone 允许你创建能够拨打和接听电话及短信的 AI 代理。以下是完整的生命周期：

1. 在 agentphone.to 注册并获取 API 密钥
2. 创建一个 Agent——这是处理通话和消息的 AI 角色
3. 购买一个电话号码并将其绑定到代理
4. 配置 Webhook（用于自定义逻辑）或使用托管模式（内置 LLM 处理对话）
5. 你的代理现在可以拨打外呼电话、接听来电以及发送/接收短信

Account
└── Agent (AI persona — owns numbers, handles calls/SMS)
    ├── Phone Number (attached to agent)
    │   ├── Call (inbound/outbound voice)
    │   │   └── Transcript (call recording text)
    │   └── Message (SMS)
    │       └── Conversation (threaded SMS exchange)
    └── Webhook (per-agent event delivery)
Webhook (project-level event delivery)

语音模式

代理以两种模式之一运行：

• hosted——内置 LLM 使用代理的 system_prompt 自主处理对话。无需服务器。这是最简单的入门方式——只需设置提示词即可拨打电话。
• webhook（默认）——来电/短信事件被转发到你的 webhook URL 进行自定义处理。当你需要完全控制对话逻辑时使用此模式。

---

快速开始

第 1 步：获取 API 密钥

在 agentphone.to 注册。你的 API 密钥格式为 sk_live_abc123...。

第 2 步：创建代理

curl -X POST https://api.agentphone.to/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Bot",
    "description": "Handles customer support calls",
    "voiceMode": "hosted",
    "systemPrompt": "You are a friendly customer support agent. Help the caller with their questions.",
    "beginMessage": "Hi there! How can I help you today?"
  }'

响应：

{
  "id": "agent_abc123",
  "name": "Support Bot",
  "description": "Handles customer support calls",
  "voiceMode": "hosted",
  "systemPrompt": "You are a friendly customer support agent...",
  "beginMessage": "Hi there! How can I help you today?",
  "voice": "11labs-Brian",
  "phoneNumbers": [],
  "createdAt": "2025-01-15T10:30:00.000Z"
}

第 3 步：购买电话号码

curl -X POST https://api.agentphone.to/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "US",
    "areaCode": "415",
    "agentId": "agent_abc123"
  }'

响应：

{
  "id": "pn_xyz789",
  "phoneNumber": "+14155551234",
  "country": "US",
  "status": "active",
  "agentId": "agent_abc123",
  "createdAt": "2025-01-15T10:31:00.000Z"
}

你的代理现在有了电话号码，可以立即接听来电。

第 4 步：拨打外呼电话

curl -X POST https://api.agentphone.to/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent_abc123",
    "toNumber": "+14155559999",
    "systemPrompt": "Schedule a dentist appointment for next Tuesday at 2pm.",
    "initialGreeting": "Hi, I am calling to schedule an appointment."
  }'

响应：

{
  "id": "call_def456",
  "agentId": "agent_abc123",
  "fromNumber": "+14155551234",
  "toNumber": "+14155559999",
  "direction": "outbound",
  "status": "in-progress",
  "startedAt": "2025-01-15T10:32:00.000Z"
}

AI 将根据你的提示词自主完成整个对话。通话结束后可查看通话记录。

第 5 步：查看通话记录