Reception API
Maak en beheer de Reception.ai-workspaces van je klanten vanuit je eigen systemen.
Met de Reception API kan een Reception.ai-reseller in code doen wat het reselleradminpaneel handmatig doet: een workspace maken voor elke klant, deze een van je abonnementen verkopen, de receptionist instellen en bijhouden wat er van je kaart wordt afgeschreven. Elk endpoint staat onder https://api.elevenlabs.io/v1/reception en is beschikbaar in de Python- en TypeScript-SDK’s als reception.
Het reselleradminpaneel, en daarmee de Reception API, is alleen beschikbaar voor Reception.ai-partners. Als je geïnteresseerd bent in een samenwerking met ons, neem dan contact op met ons salesteam.
Authenticatie
Maak een API-sleutel in het reselleradminpaneel. Alleen sleutels die daar zijn gemaakt, kunnen de Reception API aanroepen; elke andere ElevenLabs API-sleutel wordt afgewezen met not_a_reseller_api_key. De sleutel wordt één keer getoond, dus sla deze op in een secret manager.
Stuur de sleutel mee in de header xi-api-key, of stel ELEVENLABS_API_KEY in en laat de SDK deze uitlezen.
Endpoints voor resellers en workspaces
De API werkt op twee niveaus.
Workspace-endpoints vereisen de header xi-workspace-id, ingesteld op de ID van een workspace die je hebt gemaakt. Een request zonder deze header, of voor een workspace die bij een andere reseller hoort, wordt afgewezen. In de SDK’s is de header het argument xi_workspace_id in Python en het veld xiWorkspaceId in TypeScript.
Paginering
workspaces.list en billing.list_invoices retourneren één pagina tegelijk. Geef de next_cursor uit een response door als cursor om de volgende pagina op te halen, en stop wanneer has_more false is.
Ratelimieten
Limieten gelden per reseller, voor alle API-sleutels samen:
Een request boven de limiet retourneert 429. Wacht en probeer het opnieuw.
Volgende stappen
- Quickstart: maak de workspace van een klant en koppel de receptionist aan een telefoonnummer.
- Provisioning en onboarding: voorbeelden voor het in bulk maken van workspaces en het toevoegen van locaties, personeel, services en receptionistinstellingen van een bedrijf.
- Abonnementen en facturering: wijzig het abonnement van een klant en bekijk wat er van je kaart wordt afgeschreven.