Przejdź do nawigacji

Szybki start z API Reception

Utwórz obszar roboczy klienta, sprzedaj mu plan i przypisz jego recepcjonistę do numeru telefonu.

Ten przewodnik kompleksowo konfiguruje jednego klienta za pomocą API Reception: obszar roboczy w płatnym planie, profil firmy, na podstawie którego odpowiada recepcjonista, oraz numer telefonu, który do niego kieruje.

Wymagania wstępne

  • Klucz API z panelu administracyjnego resellera, ustawiony jako ELEVENLABS_API_KEY. Panel administracyjny jest dostępny tylko dla partnerów Reception.ai; aby nim zostać, skontaktuj się z naszym zespołem sprzedaży.
  • Karta przypisana do konta resellera. Subskrypcja obszaru roboczego ją obciąża.
  • SDK Python (pip install elevenlabs) lub SDK TypeScript (npm install @elevenlabs/elevenlabs-js).

Skonfiguruj klienta

1

Wybierz plan

Wyświetl plany, które sprzedajesz. Są posortowane od najtańszego, a pierwszy to okres próbny.

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
tiers = elevenlabs.reception.tiers.list()
for tier in tiers:
print(tier.tier_id, tier.display_name, tier.tier_economics.monthly_price_usd)
2

Utwórz obszar roboczy

Utwórz obszar roboczy klienta, zasubskrybuj mu płatny plan i zaproś właściciela firmy. Zaproszenia są wykonywane w miarę możliwości: wynik każdego znajduje się w member_results.

from elevenlabs import ProvisionResellerWorkspaceSubscription, TeamInviteRequest
workspace = elevenlabs.reception.workspaces.create(
business_name="Bright Smile Dental",
subscription=ProvisionResellerWorkspaceSubscription(
tier_id=tiers[1].tier_id,
billing_period="monthly_period",
),
members=[
TeamInviteRequest(email="owner@brightsmiledental.com", role="workspace_admin"),
],
)
workspace_id = workspace.workspace_id

Pomiń subscription, aby utworzyć obszar roboczy bez planu i przypisać go później.

3

Opisz firmę

Recepcjonista odpowiada na podstawie profilu firmy. Od teraz każde wywołanie dotyczy nowego obszaru roboczego, więc zawiera nagłówek xi-workspace-id. Dni w operating_hours są oznaczone od 0 (poniedziałek) do 6 (niedziela), a dzień bez wpisu jest dniem zamknięcia.

from elevenlabs import TimeRangeModel, WorkingHours
weekday = [TimeRangeModel(start_hour=8, start_minute=0, end_hour=17, end_minute=0)]
elevenlabs.reception.business_profile.update(
xi_workspace_id=workspace_id,
business_country="US",
business_description="Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
timezone="America/Los_Angeles",
operating_hours=WorkingHours(hours={str(day): weekday for day in range(5)}),
)
elevenlabs.reception.knowledge_sources.add_url(
xi_workspace_id=workspace_id,
url="https://brightsmiledental.com",
crawl_entire_site=True,
)

Usługi, personel, lokalizacje i święta dodaje się tak samo, za pomocą grup services, staff, locations i holidays.

4

Zakończ onboarding

Zakończenie onboardingu tworzy recepcjonistę obszaru roboczego na podstawie profilu firmy. Można je bezpiecznie ponawiać. Możesz też przekazać complete_onboarding=True podczas tworzenia obszaru roboczego, ale wtedy recepcjonista powstaje wyłącznie na podstawie nazwy firmy.

onboarding = elevenlabs.reception.workspaces.complete_onboarding(workspace_id)
receptionist_id = onboarding.customer_facing_agent_id
5

Przypisz recepcjoniście numer telefonu

W USA i Kanadzie numer z jednym z żądanych kierunkowych jest pobierany z puli lub kupowany, a w razie braku dostępności wybierany jest dowolny numer w kraju firmy.

assignment = elevenlabs.reception.phone_numbers.create(
xi_workspace_id=workspace_id,
customer_facing_agent_id=receptionist_id,
area_codes=["415", "628"],
)
print(assignment.phone_number)

Recepcjonista odbiera teraz połączenia na phone_number.

Co dalej