> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Reception API

Reception API 让 Reception.ai 经销商能通过代码完成在经销商管理面板中手动执行的操作：为每位客户创建工作区、为其销售你的套餐、设置接待员，并跟踪信用卡扣费情况。所有端点均位于 `https://api.elevenlabs.io/v1/reception` 下，并在 Python 和 TypeScript SDK 中以 `reception` 提供。

> **Note**
>
> 经销商管理面板及 Reception API 仅向 Reception.ai 合作伙伴开放。如果
> 有意与我们合作，请[联系销售团队](https://www.reception.ai/contact-sales)。

## 身份验证

在经销商管理面板中创建 API 密钥。只有在那里创建的密钥才能调用 Reception API；其他 ElevenLabs API 密钥都会因 `not_a_reseller_api_key` 而被拒绝。该密钥只显示一次，请存储在密钥管理器中。

在 `xi-api-key` 标头中发送密钥，或设置 `ELEVENLABS_API_KEY` 让 SDK 自动读取。

## 经销商和工作区端点

API 在两个层级上运行。

| 层级  | 操作对象                            | SDK 分组                                                                                                                                                |
| --- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| 经销商 | 经销商账户                           | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| 工作区 | 单个客户工作区，在 `xi-workspace-id` 中指定 | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

工作区端点需要 `xi-workspace-id` 标头，设为你创建的工作区 ID。未提供该标头的请求，或针对属于其他经销商的工作区的请求，都会被拒绝。在 SDK 中，该标头在 Python 里是 `xi_workspace_id` 参数，在 TypeScript 中是 `xiWorkspaceId` 字段。

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
    print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)

staff = elevenlabs.reception.staff.list(
    xi_workspace_id=workspaces.workspaces[0].workspace_id,
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const { workspaces } = await elevenlabs.reception.workspaces.list({ pageSize: 50 });
for (const workspace of workspaces) {
  console.log(workspace.workspaceId, workspace.businessName, workspace.billingTier);
}

const staff = await elevenlabs.reception.staff.list({
  xiWorkspaceId: workspaces[0].workspaceId,
});
```

```bash
elevenlabs reception workspaces list --page-size 50
```

## 分页

`workspaces.list` 和 `billing.list_invoices` 每次返回一页。将响应中的 `next_cursor` 作为 `cursor` 传入以获取下一页，并在 `has_more` 为 `false` 时停止。

## 速率限制

限制按经销商计算，覆盖其所有 API 密钥：

| 请求         | 限制        |
| ---------- | --------- |
| 读取（`GET`）  | 每分钟 600 次 |
| 写入（所有其他方法） | 每分钟 120 次 |

超过限制的请求会返回 `429`。请等待后重试。

## 后续步骤

* [快速入门](/docs/zh/reception-ai/reception-api/quickstart)：创建客户工作区，并将其接待员配置到电话号码上。
* [配置与入驻](/docs/zh/reception-ai/reception-api/provisioning-and-onboarding)：批量创建工作区，以及添加企业地点、员工、服务和接待员设置的示例。
* [订阅与计费](/docs/zh/reception-ai/reception-api/subscriptions-and-billing)：更改客户套餐，并查看信用卡扣费情况。