Zur Navigation springen

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.

EbeneWirkt aufSDK-Gruppen
ResellerIhr Reseller-Kontoworkspaces, tiers, subscriptions, billing
WorkspaceWorkspace eines Kunden, angegeben in xi-workspace-idbusiness_profile, receptionists, phone_numbers, services, staff, locations, holidays, products, assets, knowledge_sources, team

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.

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

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:

AnfragenLimit
Lesevorgänge (GET)600 pro Minute
Schreibvorgänge (alle anderen Methoden)120 pro Minute

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.