Hoppa till navigering

Provisionering och introduktion

Exempel på hur du skapar kundarbetsytor och fyller i vad deras receptionist känner till.

De här exemplen bygger vidare på snabbstarten. De använder samma kund, Bright Smile Dental, och varje arbetsyteanrop har dess ID i xi-workspace-id.

Provisionera arbetsytor

Provisionera i en begäran

När du ännu inte har företagsuppgifterna kan du skapa arbetsytan, teckna en prenumeration, bjuda in ägaren och slutföra introduktionen i ett enda anrop. Receptionisten skapas enbart utifrån företagsnamnet, så fyll i företagsprofilen efteråt. Skicka en idempotency_key så att ett nytt försök efter en timeout inte kan skapa en andra arbetsyta.

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)

Introduktion vid skapandet görs efter bästa förmåga: om den misslyckas är onboarding_completed_at_unix null och du kan försöka igen med complete_onboarding.

Provisionera kunder från ditt CRM

Härled varje idempotency_key från ditt eget kund-ID, så att en ny importkörning returnerar de arbetsytor som redan skapats i stället för att skapa nya. Samma nyckel med en annan body avvisas med 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

Slutför introduktionen för arbetsytor som fortfarande konfigureras

workspaces.list visar vilka arbetsytor som inte har slutfört introduktionen. complete_onboarding kan utan problem köras igen, så du kan köra detta enligt ett schema.

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

Beskriv företaget

Lägg till företagets platser, personal, tjänster och stängningsdagar innan du slutför introduktionen, så att receptionisten skapas utifrån dem. Du kan också lägga till eller ändra dem när som helst efteråt.

Tills introduktionen är slutförd kan installationsguiden som företagsägaren ser när hen loggar in ersätta eller ta bort dessa data. Slutför introduktionen innan ägaren loggar in.

Lägg till en plats

Varje plats har sina egna öppettider. Dagarna går från 0 (måndag) till 6 (söndag), och en dag utan post är stängd.

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

Lägg till en personalmedlem

En personalmedlem på en plats följer platsens öppettider om du inte ger personen egna working_hours. customer_facing_name är vad de som ringer hör; name förblir den interna etiketten.

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

Lägg till tjänster

En tjänst har en eller flera variants, var och en med sin egen längd och sitt eget pris; den första är standard. Ange any_staff_member som false för att begränsa vem som kan utföra den.

När priset beror på jobbet använder du pricing_mode="quote" och lägger till intake_questions. Receptionisten ställer dem och tar emot en offertförfrågan i stället för att ange ett pris.

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

Stäng för en helgdag

En stängning omfattar hela dagar, från start_date till end_date. Använd time_off_type="location" för företaget, eller "staff" med personalmedlemmens ID i resource_id för en persons ledighet.

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

Ladda upp ett dokument

Ge receptionisten ett dokument att svara utifrån, till exempel vanliga frågor och svar eller en prislista. Använd knowledge_sources.add_url för en webbplats, som i snabbstarten.

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

Konfigurera receptionisten

Dessa anrop behöver receptionistens ID: customer_facing_agent_id från complete_onboarding, eller agent_id från receptionists.list.

Ange hälsning, språk och vad som ska samlas in

Endast inställningarna du skickar ändras.

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

Vidarekoppla samtal och lägg till regler

En vidarekopplingsregel kopplar samtalet till en person när dess condition uppfylls. Vidarekopplingar beror på planen: kontrollera först is_transfer_allowed på receptionisten. En regel talar om för receptionisten hur den ska agera; en strict-regel följs alltid, medan en suggestion är en riktlinje.

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

Bjud in teamet

Bjud in personer när som helst efter att arbetsytan har skapats. En väntande inbjudan tar upp en plats, så en inbjudan avvisas när medlemmar och inbjudningar når planens teamstorlek.

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