跳到导航

Reception API

从自有系统创建和管理客户的 Reception.ai 工作区。

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

经销商管理面板及 Reception API 仅向 Reception.ai 合作伙伴开放。如果 有意与我们合作,请联系销售团队。

身份验证

在经销商管理面板中创建 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 字段。

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,
)

分页

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

速率限制

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

请求限制
读取(GET)每分钟 600 次
写入(所有其他方法)每分钟 120 次

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

后续步骤

  • 快速入门:创建客户工作区,并将其接待员配置到电话号码上。
  • 配置与入驻:批量创建工作区,以及添加企业地点、员工、服务和接待员设置的示例。
  • 订阅与计费:更改客户套餐,并查看信用卡扣费情况。