> 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は2つのレベルで動作します。

| レベル     | 操作対象                              | SDKグループ                                                                                                                                     |
| ------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| リセラー    | リセラーアカウント                         | `workspaces`、`tiers`、`subscriptions`、`billing`                                                                                              |
| ワークスペース | `xi-workspace-id`で指定された顧客のワークスペース | `business_profile`、`receptionists`、`phone_numbers`、`services`、`staff`、`locations`、`holidays`、`products`、`assets`、`knowledge_sources`、`team` |

ワークスペースのエンドポイントには、作成したワークスペースのIDを設定した`xi-workspace-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`は、一度に1ページを返します。次のページを取得するには、レスポンスの`next_cursor`を`cursor`として渡し、`has_more`が`false`になったら停止します。

## レート制限

制限は、すべてのAPIキーを合わせてリセラー単位で適用されます。

| リクエスト             | 上限        |
| ----------------- | --------- |
| 読み取り（`GET`）       | 1分あたり600件 |
| 書き込み（その他すべてのメソッド） | 1分あたり120件 |

上限を超えたリクエストは`429`を返します。時間を置いて再試行してください。

## 次のステップ

* [クイックスタート](/docs/ja/reception-ai/reception-api/quickstart)：顧客のワークスペースを作成し、受付担当に電話番号を割り当てます。
* [プロビジョニングとオンボーディング](/docs/ja/reception-ai/reception-api/provisioning-and-onboarding)：ワークスペースの一括作成や、事業拠点、スタッフ、サービス、受付担当の設定を追加する例を紹介します。
* [サブスクリプションと請求](/docs/ja/reception-ai/reception-api/subscriptions-and-billing)：顧客のプランを変更し、カードへの請求内容を確認します。