ナビゲーションにスキップ

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は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フィールドに対応します。

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は、一度に1ページを返します。次のページを取得するには、レスポンスのnext_cursorをcursorとして渡し、has_moreがfalseになったら停止します。

レート制限

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

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

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

次のステップ