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つのレベルで動作します。
ワークスペースのエンドポイントには、作成したワークスペースのIDを設定したxi-workspace-idヘッダーが必要です。このヘッダーがないリクエストや、別のリセラーに属するワークスペースへのリクエストは拒否されます。SDKでは、このヘッダーはPythonのxi_workspace_id引数、TypeScriptのxiWorkspaceIdフィールドに対応します。
ページネーション
workspaces.listとbilling.list_invoicesは、一度に1ページを返します。次のページを取得するには、レスポンスのnext_cursorをcursorとして渡し、has_moreがfalseになったら停止します。
レート制限
制限は、すべてのAPIキーを合わせてリセラー単位で適用されます。
上限を超えたリクエストは429を返します。時間を置いて再試行してください。
次のステップ
- クイックスタート:顧客のワークスペースを作成し、受付担当に電話番号を割り当てます。
- プロビジョニングとオンボーディング:ワークスペースの一括作成や、事業拠点、スタッフ、サービス、受付担当の設定を追加する例を紹介します。
- サブスクリプションと請求:顧客のプランを変更し、カードへの請求内容を確認します。