Hoppa till navigering

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.

NivåGällerSDK-grupper
ÅterförsäljareDitt återförsäljarkontoworkspaces, tiers, subscriptions, billing
ArbetsytaEn kunds arbetsyta, angiven i xi-workspace-idbusiness_profile, receptionists, phone_numbers, services, staff, locations, holidays, products, assets, knowledge_sources, team

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.

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

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:

BegärandenGräns
Läsningar (GET)600 per minut
Skrivningar (alla andra metoder)120 per minut

En begäran som överskrider gränsen returnerar 429. Vänta och försök igen.

Nästa steg