Przejdź do nawigacji

API Reception

Twórz i zarządzaj obszarami roboczymi Reception.ai swoich klientów z własnych systemów.

API Reception pozwala resellerowi Reception.ai robić w kodzie to, co panel administracyjny resellera pozwala zrobić ręcznie: utworzyć obszar roboczy dla każdego klienta, sprzedać mu jeden z twoich planów, skonfigurować jego recepcjonistę i śledzić obciążenia twojej karty. Wszystkie endpointy znajdują się pod https://api.elevenlabs.io/v1/reception i są dostępne w SDK Python i TypeScript jako reception.

Panel administracyjny resellera, a wraz z nim API Reception, jest dostępny tylko dla partnerów Reception.ai. Jeśli interesuje cię współpraca z nami, skontaktuj się z naszym zespołem sprzedaży.

Uwierzytelnianie

Utwórz klucz API w panelu administracyjnym resellera. Tylko klucze utworzone tam mogą wywoływać API Reception; każdy inny klucz API ElevenLabs zostanie odrzucony z not_a_reseller_api_key. Klucz jest wyświetlany tylko raz, więc zapisz go w menedżerze sekretów.

Wyślij klucz w nagłówku xi-api-key albo ustaw ELEVENLABS_API_KEY, aby SDK odczytało go automatycznie.

Endpointy resellera i obszaru roboczego

API działa na dwóch poziomach.

PoziomDotyczyGrupy SDK
ResellerTwojego konta reselleraworkspaces, tiers, subscriptions, billing
Obszar roboczyObszaru roboczego jednego klienta, wskazanego w xi-workspace-idbusiness_profile, receptionists, phone_numbers, services, staff, locations, holidays, products, assets, knowledge_sources, team

Endpointy obszaru roboczego wymagają nagłówka xi-workspace-id ustawionego na ID utworzonego przez ciebie obszaru roboczego. Żądanie bez niego lub dotyczące obszaru należącego do innego resellera zostanie odrzucone. W SDK nagłówek to argument xi_workspace_id w Pythonie oraz pole xiWorkspaceId w 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,
)

Stronicowanie

workspaces.list i billing.list_invoices zwracają po jednej stronie wyników. Przekaż next_cursor z odpowiedzi jako cursor, aby pobrać kolejną stronę, i zakończ, gdy has_more ma wartość false.

Limity żądań

Limity obowiązują na resellera, dla wszystkich jego kluczy API:

ŻądaniaLimit
Odczyty (GET)600 na minutę
Zapisy (wszystkie pozostałe metody)120 na minutę

Żądanie ponad limit zwraca 429. Poczekaj i spróbuj ponownie.

Co dalej

  • Szybki start: utwórz obszar roboczy klienta i przypisz jego recepcjonistę do numeru telefonu.
  • Provisioning i onboarding: przykłady masowego tworzenia obszarów roboczych oraz dodawania lokalizacji, personelu, usług i ustawień recepcjonisty firmy.
  • Subskrypcje i rozliczenia: zmień plan klienta i sprawdź obciążenia twojej karty.