Reception API
Skapa och hantera dina kunders Reception.ai-arbetsytor från dina egna system.
Reception API låter en Reception.ai-återförsäljare göra i kod det som återförsäljarens administratörspanel gör manuellt: skapa en arbetsyta för varje kund, sälja en av dina planer till den, konfigurera dess receptionist och följa vad som debiteras på ditt kort. Varje endpoint finns under https://api.elevenlabs.io/v1/reception och är tillgänglig som reception i Python- och TypeScript-SDK:erna.
Återförsäljarens administratörspanel, och därmed Reception API, är endast öppen för Reception.ai-partner. Om du är intresserad av att samarbeta med oss kan du kontakta vårt säljteam.
Autentisering
Skapa en API-nyckel i återförsäljarens administratörspanel. Endast nycklar som skapas där kan anropa Reception API; alla andra ElevenLabs API-nycklar avvisas med not_a_reseller_api_key. Nyckeln visas bara en gång, så spara den i en hemlighetshanterare.
Skicka nyckeln i headern xi-api-key, eller ange ELEVENLABS_API_KEY och låt SDK:t läsa den.
Endpoints för återförsäljare och arbetsytor
API:t fungerar på två nivåer.
Endpoints för arbetsytor kräver headern xi-workspace-id, angiven som ID:t för en arbetsyta som du har skapat. En begäran utan den, eller för en arbetsyta som tillhör en annan återförsäljare, avvisas. I SDK:erna är headern argumentet xi_workspace_id i Python och fältet xiWorkspaceId i TypeScript.
Sidindelning
workspaces.list och billing.list_invoices returnerar en sida i taget. Skicka next_cursor från ett svar som cursor för att hämta nästa sida, och sluta när has_more är false.
Hastighetsbegränsningar
Gränserna gäller per återförsäljare, för alla dess API-nycklar:
En begäran som överskrider gränsen returnerar 429. Vänta och försök igen.
Nästa steg
- Snabbstart: skapa en kunds arbetsyta och koppla dess receptionist till ett telefonnummer.
- Provisionering och introduktion: exempel på att skapa arbetsytor i bulk och lägga till ett företags platser, personal, tjänster och receptionistinställningar.
- Prenumerationer och fakturering: ändra en kunds plan och se vad som debiteras på ditt kort.