Reception API
Erstellen und verwalten Sie die Reception.ai-Workspaces Ihrer Kunden über Ihre eigenen Systeme.
Mit der Reception API kann ein Reception.ai-Reseller per Code erledigen, was im Reseller-Admin-Panel manuell möglich ist: für jeden Kunden einen Workspace erstellen, ihm einen Ihrer Pläne verkaufen, seine Rezeption einrichten und nachverfolgen, was Ihrer Karte belastet wird. Jeder Endpunkt befindet sich unter https://api.elevenlabs.io/v1/reception und ist in den Python- und TypeScript-SDKs als reception verfügbar.
Das Reseller-Admin-Panel und damit die Reception API stehen nur Reception.ai-Partnern offen. Wenn Sie an einer Partnerschaft mit uns interessiert sind, kontaktieren Sie unser Vertriebsteam.
Authentifizierung
Erstellen Sie im Reseller-Admin-Panel einen API-Key. Nur dort erstellte Keys können die Reception API aufrufen; jeder andere ElevenLabs-API-Key wird mit not_a_reseller_api_key abgelehnt. Der Key wird nur einmal angezeigt. Speichern Sie ihn daher in einem Secret Manager.
Senden Sie den Key im Header xi-api-key oder setzen Sie ELEVENLABS_API_KEY, damit das SDK ihn ausliest.
Reseller- und Workspace-Endpunkte
Die API arbeitet auf zwei Ebenen.
Workspace-Endpunkte benötigen den Header xi-workspace-id, der auf die ID eines von Ihnen erstellten Workspace gesetzt ist. Eine Anfrage ohne diesen Header oder für einen Workspace eines anderen Resellers wird abgelehnt. In den SDKs lautet der Header in Python als Argument xi_workspace_id und in TypeScript als Feld xiWorkspaceId.
Paginierung
workspaces.list und billing.list_invoices geben jeweils eine Seite zurück. Übergeben Sie den next_cursor aus einer Antwort als cursor, um die nächste Seite abzurufen, und stoppen Sie, wenn has_more auf false gesetzt ist.
Ratenlimits
Die Limits gelten pro Reseller über alle API-Keys hinweg:
Eine Anfrage über dem Limit gibt 429 zurück. Warten Sie und wiederholen Sie sie.
Nächste Schritte
- Schnellstart: Erstellen Sie den Workspace eines Kunden und weisen Sie seiner Rezeption eine Telefonnummer zu.
- Bereitstellung und Onboarding: Beispiele zum Erstellen von Workspaces in großen Mengen sowie zum Hinzufügen von Standorten, Mitarbeitenden, Services und Rezeptionseinstellungen eines Unternehmens.
- Abonnements und Abrechnung: Ändern Sie den Plan eines Kunden und sehen Sie, was Ihrer Karte belastet wird.