Naar navigatie springen

Provisioning en onboarding

Voorbeelden voor het maken van klantworkspaces en het invullen van wat hun receptionist weet.

Deze voorbeelden bouwen voort op de quickstart. Ze gebruiken dezelfde klant, Bright Smile Dental, en elke workspace-aanroep bevat de ID in xi-workspace-id.

Workspaces provisionen

Provisionen in één request

Als je de bedrijfsgegevens nog niet hebt, maak je de workspace, neem je een abonnement af, nodig je de eigenaar uit en rond je de onboarding af in één aanroep. De receptionist wordt alleen op basis van de bedrijfsnaam gemaakt, dus vul het bedrijfsprofiel daarna in. Geef een idempotency_key mee, zodat een nieuwe poging na een time-out geen tweede workspace kan maken.

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 tijdens het maken gebeurt op basis van best effort: als dit mislukt, is onboarding_completed_at_unix null en kun je het opnieuw proberen met complete_onboarding.

Klanten uit je CRM provisionen

Leid elke idempotency_key af van je eigen klant-ID, zodat het opnieuw uitvoeren van de import de al gemaakte workspaces retourneert in plaats van nieuwe te maken. Dezelfde sleutel met een andere body wordt afgewezen met 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

Onboarding afronden voor workspaces die nog worden ingesteld

workspaces.list toont welke workspaces de onboarding nog niet hebben afgerond. Je kunt complete_onboarding veilig opnieuw proberen, dus je kunt dit volgens een schema uitvoeren.

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

Beschrijf het bedrijf

Voeg de locaties, het personeel, de services en de sluitingen van het bedrijf toe voordat je de onboarding afrondt, zodat de receptionist hierop wordt gebaseerd. Je kunt ze daarna ook op elk moment toevoegen of wijzigen.

Tot de onboarding is afgerond, kan de installatiewizard die de bedrijfseigenaar ziet bij het inloggen deze gegevens vervangen of verwijderen. Rond de onboarding af voordat de eigenaar inlogt.

Een locatie toevoegen

Elke locatie heeft eigen openingstijden. Dagen lopen van 0 (maandag) tot 6 (zondag), en een dag zonder invoer is gesloten.

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

Een personeelslid toevoegen

Een personeelslid op een locatie volgt de openingstijden van die locatie, tenzij je eigen working_hours opgeeft. customer_facing_name is wat bellers horen; name blijft het interne label.

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

Services toevoegen

Een service heeft een of meer variants, elk met een eigen duur en prijs; de eerste is de standaard. Stel any_staff_member in op false om te beperken wie de service kan leveren.

Wanneer de prijs afhangt van het werk, gebruik je pricing_mode="quote" en voeg je intake_questions toe. De receptionist stelt deze vragen en neemt een offerteaanvraag aan in plaats van een prijs te noemen.

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

Sluiten voor een feestdag

Een sluiting geldt voor volledige dagen, van start_date tot end_date. Gebruik time_off_type="location" voor het bedrijf, of "staff" met de ID van het personeelslid in resource_id voor de vrije tijd van één persoon.

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

Een document uploaden

Geef de receptionist een document waaruit deze kan antwoorden, zoals een FAQ of een prijslijst. Gebruik knowledge_sources.add_url voor een website, zoals in de quickstart.

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

De receptionist instellen

Voor deze aanroepen heb je de ID van de receptionist nodig: customer_facing_agent_id van complete_onboarding, of agent_id van receptionists.list.

De begroeting, talen en op te vragen informatie instellen

Alleen de instellingen die je verstuurt, veranderen.

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

Gesprekken doorverbinden en regels toevoegen

Een doorverbindingsregel verbindt het gesprek door met een persoon wanneer aan de condition wordt voldaan. Doorverbinden hangt af van het abonnement: controleer eerst is_transfer_allowed op de receptionist. Een regel vertelt de receptionist hoe deze zich moet gedragen; een strict-regel wordt altijd gevolgd, een suggestion is een richtlijn.

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

Het team uitnodigen

Nodig mensen op elk moment uit nadat de workspace bestaat. Een openstaande uitnodiging neemt een plek in, dus een uitnodiging wordt geweigerd zodra leden en uitnodigingen samen de teamgrootte van het abonnement bereiken.

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