Vai alla navigazione

Provisioning e onboarding

Esempi per creare workspace dei clienti e inserire le informazioni che la loro receptionist deve conoscere.

Questi esempi si basano sulla guida rapida. Usano lo stesso cliente Bright Smile Dental e ogni chiamata al workspace include il suo ID in xi-workspace-id.

Provisioning dei workspace

Provisioning con una richiesta

Quando non hai ancora i dettagli dell’attività, crea il workspace, attiva l’abbonamento, invita il titolare e completa l’onboarding con una sola chiamata. La receptionist viene creata basandosi solo sul nome dell’attività, quindi completa il profilo aziendale in seguito. Passa una idempotency_key affinché un nuovo tentativo dopo un timeout non possa creare un secondo workspace.

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)

L’onboarding durante la creazione viene eseguito in modalità best-effort: se non riesce, onboarding_completed_at_unix è null e puoi ritentarlo con complete_onboarding.

Provisioning dei clienti dal tuo CRM

Deriva ogni idempotency_key dal tuo ID cliente, così rieseguendo l’importazione verranno restituiti i workspace già creati anziché crearne di nuovi. La stessa chiave con un body diverso viene rifiutata con 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

Completa l’onboarding dei workspace ancora in configurazione

workspaces.list mostra quali workspace non hanno completato l’onboarding. Puoi riprovare complete_onboarding in sicurezza, quindi puoi eseguirlo a intervalli programmati.

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

Descrivi l’attività

Aggiungi sedi, personale, servizi e chiusure dell’attività prima di completare l’onboarding, così la receptionist verrà creata a partire da queste informazioni. Puoi anche aggiungerli o modificarli in qualsiasi momento successivo.

Finché l’onboarding non è completo, la procedura guidata di configurazione che il titolare dell’attività vede quando accede può sostituire o rimuovere questi dati. Completa l’onboarding prima che il titolare acceda.

Aggiungi una sede

Ogni sede ha i propri orari. I giorni vanno da 0 (lunedì) a 6 (domenica) e un giorno senza voce è considerato chiuso.

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

Aggiungi un membro del personale

Un membro del personale presso una sede segue gli orari di quella sede, a meno che non gli assegni i propri working_hours. customer_facing_name è il nome che sentono i chiamanti; name rimane l’etichetta interna.

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

Aggiungi servizi

Un servizio ha una o più variants, ciascuna con durata e prezzo propri; la prima è quella predefinita. Imposta any_staff_member su false per limitare chi può erogarlo.

Quando il prezzo dipende dal lavoro da svolgere, usa pricing_mode="quote" e aggiungi intake_questions. La receptionist le pone e raccoglie una richiesta di preventivo anziché indicare un prezzo.

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

Chiudi per festività

Una chiusura copre intere giornate, da start_date a end_date. Usa time_off_type="location" per l’attività oppure "staff" con l’ID del membro del personale in resource_id per l’assenza di una persona.

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

Carica un documento

Fornisci alla receptionist un documento da usare per rispondere, come una FAQ o un listino prezzi. Usa knowledge_sources.add_url per un sito web, come nella guida rapida.

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

Configura la receptionist

Queste chiamate richiedono l’ID della receptionist: customer_facing_agent_id da complete_onboarding oppure agent_id da receptionists.list.

Imposta il saluto, le lingue e le informazioni da raccogliere

Vengono modificate solo le impostazioni che invii.

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

Trasferisci chiamate e aggiungi regole

Una regola di trasferimento passa la chiamata a una persona quando viene soddisfatta la relativa condition. I trasferimenti dipendono dal piano: prima controlla is_transfer_allowed sulla receptionist. Una regola indica alla receptionist come comportarsi; una regola strict viene sempre seguita, mentre una suggestion è una linea guida.

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

Invita il team

Invita persone in qualsiasi momento dopo la creazione del workspace. Un invito in attesa occupa un posto, quindi un invito viene rifiutato quando membri e inviti raggiungono la dimensione del team prevista dal piano.

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