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.
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.
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:
Żą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.