Przejdź do nawigacji

Provisioning i onboarding

Przykłady tworzenia obszarów roboczych klientów i uzupełniania wiedzy ich recepcjonisty.

Te przykłady bazują na szybkim starcie. Korzystają z tego samego klienta Bright Smile Dental, a każde wywołanie obszaru roboczego przekazuje jego ID w xi-workspace-id.

Tworzenie obszarów roboczych

Utwórz w jednym żądaniu

Gdy nie masz jeszcze danych firmy, utwórz obszar roboczy, zasubskrybuj go, zaproś właściciela i zakończ onboarding w jednym wywołaniu. Recepcjonista powstaje wyłącznie na podstawie nazwy firmy, więc później uzupełnij profil firmy. Przekaż idempotency_key, aby ponowienie po przekroczeniu limitu czasu nie utworzyło drugiego obszaru roboczego.

from elevenlabs import ElevenLabs, ProvisionResellerWorkspaceSubscription, TeamInviteRequest
elevenlabs = ElevenLabs()
workspace = elevenlabs.reception.workspaces.create(
business_name="Bright Smile Dental",
subscription=ProvisionResellerWorkspaceSubscription(
tier_id="smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
),
members=[
TeamInviteRequest(email="owner@brightsmiledental.com", role="workspace_admin"),
TeamInviteRequest(email="frontdesk@brightsmiledental.com"),
],
complete_onboarding=True,
idempotency_key="provision-crm-10482",
)
for result in workspace.member_results:
if result.outcome == "failed":
print("Invite failed:", result.email, result.error_status)
if workspace.onboarding_completed_at_unix is None:
elevenlabs.reception.workspaces.complete_onboarding(workspace.workspace_id)

Onboarding podczas tworzenia jest wykonywany w miarę możliwości: jeśli się nie powiedzie, onboarding_completed_at_unix ma wartość null i możesz ponowić go przez complete_onboarding.

Twórz klientów z CRM

Wyprowadź każdy idempotency_key z własnego ID klienta, aby ponowne uruchomienie importu zwracało już utworzone obszary robocze zamiast tworzyć nowe. Ten sam klucz z innym body zostanie odrzucony z idempotency_key_reused.

customers = [
{"crm_id": "10482", "name": "Bright Smile Dental", "owner": "owner@brightsmiledental.com"},
{"crm_id": "10483", "name": "Harbor Physio", "owner": "hello@harborphysio.com"},
]
workspace_ids = {}
for customer in customers:
workspace = elevenlabs.reception.workspaces.create(
business_name=customer["name"],
subscription=ProvisionResellerWorkspaceSubscription(
tier_id="smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
),
members=[TeamInviteRequest(email=customer["owner"], role="workspace_admin")],
idempotency_key=f"provision-crm-{customer['crm_id']}",
)
workspace_ids[customer["crm_id"]] = workspace.workspace_id

Zakończ onboarding obszarów roboczych nadal w konfiguracji

workspaces.list pokazuje, które obszary robocze nie zakończyły onboardingu. complete_onboarding można bezpiecznie ponawiać, więc możesz uruchamiać to według harmonogramu.

cursor = None
while True:
page = elevenlabs.reception.workspaces.list(cursor=cursor, page_size=100)
for workspace in page.workspaces:
if workspace.onboarding_completed_at_unix is None:
elevenlabs.reception.workspaces.complete_onboarding(workspace.workspace_id)
if not page.has_more:
break
cursor = page.next_cursor

Opisz firmę

Dodaj lokalizacje, personel, usługi i dni zamknięcia firmy przed zakończeniem onboardingu, aby recepcjonista powstał na ich podstawie. Możesz też dodawać je lub zmieniać w dowolnym momencie później.

Dopóki onboarding nie zostanie zakończony, kreator konfiguracji widoczny dla właściciela firmy po zalogowaniu może zastąpić lub usunąć te dane. Zakończ onboarding, zanim właściciel się zaloguje.

Dodaj lokalizację

Każda lokalizacja ma własne godziny pracy. Dni są oznaczone od 0 (poniedziałek) do 6 (niedziela), a dzień bez wpisu jest dniem zamknięcia.

from elevenlabs import TimeRangeModel, WorkingHours
workspace_id = "8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7"
weekday = [TimeRangeModel(start_hour=8, start_minute=0, end_hour=17, end_minute=0)]
saturday = [TimeRangeModel(start_hour=9, start_minute=0, end_hour=13, end_minute=0)]
location = elevenlabs.reception.locations.create(
xi_workspace_id=workspace_id,
name="Mission Street",
address="2140 Mission St, San Francisco, CA 94110",
notes="Free parking behind the building.",
operating_hours=WorkingHours(hours={**{str(day): weekday for day in range(5)}, "5": saturday}),
)

Dodaj członka personelu

Członek personelu w lokalizacji pracuje w jej godzinach, chyba że ustawisz mu własne working_hours. customer_facing_name to nazwa słyszana przez dzwoniących; name pozostaje etykietą wewnętrzną.

hygienist = elevenlabs.reception.staff.create(
xi_workspace_id=workspace_id,
name="Maria Lopez (hygienist)",
customer_facing_name="Maria",
description="Dental hygienist. Speaks English and Spanish.",
email="maria@brightsmiledental.com",
location_id=location.id,
working_hours=WorkingHours(
hours={str(day): [TimeRangeModel(start_hour=9, start_minute=0, end_hour=15, end_minute=0)] for day in range(4)},
),
)

Dodaj usługi

Usługa ma co najmniej jeden variants, każdy z własnym czasem trwania i ceną; pierwszy jest domyślny. Ustaw any_staff_member na false, aby ograniczyć osoby, które mogą ją świadczyć.

Gdy cena zależy od zakresu pracy, użyj pricing_mode="quote" i dodaj intake_questions. Recepcjonista zada je i przyjmie prośbę o wycenę zamiast podawać cenę.

from elevenlabs import ReceptionIntakeQuestion, ReceptionServiceVariant
elevenlabs.reception.services.create(
xi_workspace_id=workspace_id,
name="Cleaning",
description="Routine cleaning and polish.",
variants=[
ReceptionServiceVariant(duration_minutes=45, price=120),
ReceptionServiceVariant(duration_minutes=60, price=160),
],
any_staff_member=False,
staff_ids=[hygienist.id],
buffer_minutes=10,
)
elevenlabs.reception.services.create(
xi_workspace_id=workspace_id,
name="Invisalign consultation",
pricing_mode="quote",
variants=[ReceptionServiceVariant(duration_minutes=30)],
intake_questions=[
ReceptionIntakeQuestion(label="Have you worn braces or aligners before?", kind="choice", options=["Yes", "No"]),
ReceptionIntakeQuestion(label="What would you like to fix?", required=True),
],
)

Zamknij na święto

Zamknięcie obejmuje całe dni, od start_date do end_date. Użyj time_off_type="location" dla firmy albo "staff" z ID członka personelu w resource_id dla urlopu jednej osoby.

from elevenlabs import DateModel
elevenlabs.reception.holidays.create(
xi_workspace_id=workspace_id,
name="Winter break",
start_date=DateModel(year=2026, month=12, day=24),
end_date=DateModel(year=2026, month=12, day=26),
time_off_type="location",
location_id=location.id,
)

Prześlij dokument

Dodaj dokument, na podstawie którego recepcjonista będzie odpowiadać, na przykład FAQ lub cennik. Dla strony internetowej użyj knowledge_sources.add_url, jak w szybkim starcie.

with open("new-patient-faq.pdf", "rb") as file:
elevenlabs.reception.knowledge_sources.upload(xi_workspace_id=workspace_id, file=file)

Skonfiguruj recepcjonistę

Te wywołania wymagają ID recepcjonisty: customer_facing_agent_id z complete_onboarding albo agent_id z receptionists.list.

Ustaw powitanie, języki i zbierane dane

Zmieniają się tylko ustawienia, które wyślesz.

from elevenlabs import ReceptionCustomerFacingConfigPatch
receptionist_id = elevenlabs.reception.receptionists.list(xi_workspace_id=workspace_id)[0].agent_id
elevenlabs.reception.receptionists.update(
receptionist_id,
xi_workspace_id=workspace_id,
config=ReceptionCustomerFacingConfigPatch(
first_message="Thanks for calling Bright Smile Dental, how can I help?",
additional_languages=["es"],
tone_traits=["warm", "concise"],
details_to_collect=["full name", "date of birth", "insurance provider"],
additional_instructions="Never give medical advice. Offer the next available appointment instead.",
),
)

Przekazuj połączenia i dodawaj reguły

Reguła przekierowania przekazuje połączenie do osoby, gdy jej condition zostanie spełniony. Przekierowania zależą od planu: najpierw sprawdź is_transfer_allowed recepcjonisty. Reguła mówi recepcjoniście, jak ma działać; reguła strict jest zawsze przestrzegana, a suggestion to wskazówka.

elevenlabs.reception.receptionists.transfer_rules.create(
receptionist_id,
xi_workspace_id=workspace_id,
label="Front desk",
phone_number="+14155550142",
condition="The caller has a dental emergency or asks to speak to a person.",
)
elevenlabs.reception.receptionists.rules.create(
receptionist_id,
xi_workspace_id=workspace_id,
title="New patients",
description="Ask new patients to arrive 15 minutes early to fill in forms.",
)

Zaproś zespół

Możesz zapraszać osoby w dowolnym momencie po utworzeniu obszaru roboczego. Oczekujące zaproszenie zajmuje miejsce, więc zaproszenie zostanie odrzucone, gdy liczba członków i zaproszeń osiągnie limit zespołu w planie.

elevenlabs.reception.team.invites.create(
xi_workspace_id=workspace_id,
email="office.manager@brightsmiledental.com",
role="workspace_admin",
)