名称： pamela-calls
描述： 使用 Pamela 语音 API 进行 AI 驱动的电话呼叫。创建外呼电话，注册自定义工具以在通话中执行操作，处理 Webhook，并构建 React UI。适用于用户希望拨打电话、集成语音 AI、构建 IVR 系统、导航电话菜单或自动化电话任务的场景。

Pamela 语音 API 技能

使用原生电话树导航功能，进行 AI 驱动的电话呼叫。

快速跳转： 安装 · 快速开始 · 使用场景 · SDK 参考

前提条件

• API 订阅（访问 API 所必需）
• 开发者账户中的 API 密钥
• Node.js 18+（适用于 JS/React）或 Python 3.8+（适用于 Python）

安装

JavaScript/TypeScript:

npm install @thisispamela/sdk

Python:

pip install thisispamela

React:

npm install @thisispamela/react @thisispamela/sdk

CLI:

npm install -g @thisispamela/cli

获取 API 密钥

1. 在 developer.thisispamela.com 注册 API 订阅。
2. 进入 API 设置面板。
3. 通过 Stripe 设置账单。
4. 点击“创建 API 密钥”。
5. 立即保存 - 完整的密钥（以 pk_live_ 开头）仅显示一次。

快速开始

注意： 电话号码必须使用 E.164 格式（例如：+1234567890）。

JavaScript

import { PamelaClient } from '@thisispamela/sdk';

const client = new PamelaClient({ apiKey: 'pk_live_...' });

const call = await client.createCall({
  to: '+1234567890',
  task: '给药店打电话，确认我的处方药是否已备好',
  voice: 'female',
  agent_name: 'Pamela',
});

const status = await client.getCall(call.id);
console.log(status.transcript);

Python

from pamela import PamelaClient

client = PamelaClient(api_key="pk_live_...")

call = client.create_call(
    to="+1234567890",
    task="给药店打电话，确认我的处方药是否已备好",
    voice="female",
    agent_name="Pamela",
)

status = client.get_call(call["id"])
print(status["transcript"])

CLI

export PAMELA_API_KEY="pk_live_..."

thisispamela create-call \
  --to "+1234567890" \
  --task "给药店打电话，确认我的处方药是否已备好"

使用场景

核心功能

• 电话树导航 - 自动导航 IVR 菜单，处理等待和转接。
• 自定义工具 - 注册 AI 在通话过程中可以调用的工具。
• 实时转录 - 通话过程中通过 Webhook 更新转录文本。
• React 组件 - 用于显示通话状态和转录文本的预构建 UI。

SDK 参考

详细的 SDK 文档：

• JavaScript SDK - 完整的 JS/TS 参考
• Python SDK - 完整的 Python 参考
• React 组件 - 组件库指南

Webhooks

Pamela 会发送通话生命周期事件的 Webhook：

• call.queued - 通话已创建并排队
• call.started - 通话已接通
• call.completed - 通话成功完成
• call.failed - 通话失败
• call.transcript_update - 新的转录条目

使用 X-Pamela-Signature 请求头验证 Webhook 签名。

计费

• API 使用费：$0.10/分钟
• 每次通话最低计费 1 分钟
• 仅对已接通的通话计费
• 需要 API 订阅

故障排除

"无效的 API 密钥"
- 确认密钥以 pk_live_ 开头。
- 在 API 设置面板中检查密钥是否处于激活状态。

"403 禁止访问"
- 需要 API 订阅。
- 在 developer.thisispamela.com 检查订阅状态。

"无效的电话号码"
- 使用包含国家代码的 E.164 格式：+1234567890

资源

• 文档：https://docs.thisispamela.com/
• 演示：https://demo.thisispamela.com/
• API：https://api.thisispamela.com
• 支持：support@thisispamela.com