ナビゲーションにスキップ

プロビジョニングとオンボーディング

顧客ワークスペースを作成し、受付担当に必要な情報を設定する例を紹介します。

以下の例は、クイックスタートの続きです。同じBright Smile Dentalという顧客を使用し、ワークスペースへの各呼び出しでは、そのIDをxi-workspace-idに設定します。

ワークスペースをプロビジョニングする

1回のリクエストでプロビジョニングする

事業の詳細情報がまだない場合は、1回の呼び出しでワークスペースの作成、サブスクリプションへの加入、オーナーの招待、オンボーディングの完了まで実行します。受付担当は事業名だけを基に作成されるため、その後で事業プロフィールを入力してください。タイムアウト後の再試行で2つ目のワークスペースが作成されないよう、idempotency_keyを渡します。

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_completed_at_unixはnullになり、complete_onboardingで再試行できます。

CRMから顧客をプロビジョニングする

各idempotency_keyを独自の顧客IDから生成します。これにより、インポートを再実行しても新しいワークスペースは作成されず、作成済みのワークスペースが返されます。同じキーを異なる本文で使用すると、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

設定中のワークスペースのオンボーディングを完了する

workspaces.listを使用すると、オンボーディングが完了していないワークスペースを確認できます。complete_onboardingは安全に再試行できるため、スケジュールに沿って実行できます。

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

事業情報を設定する

オンボーディングを完了する前に、事業の拠点、スタッフ、サービス、休業日を追加してください。受付担当はこれらの情報を基に作成されます。オンボーディング完了後も、いつでも追加または変更できます。

オンボーディングが完了するまでは、事業オーナーがサインインしたときに表示される設定ウィザードによって、 このデータが置き換えられたり削除されたりする可能性があります。オーナーがサインインする前にオンボーディングを完了してください。

拠点を追加する

拠点ごとに営業時間を設定できます。曜日は0(月曜日)から6(日曜日)で表し、エントリがない曜日は休業日となります。

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

スタッフを追加する

拠点に所属するスタッフは、独自のworking_hoursを指定しない限り、その拠点の営業時間に従います。customer_facing_nameは発信者に案内される名前で、nameは内部用のラベルです。

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

サービスを追加する

サービスには1つ以上のvariantsがあり、それぞれに所要時間と価格を設定します。最初のものがデフォルトになります。対応可能なスタッフを限定するには、any_staff_memberをfalseに設定します。

作業内容によって価格が変わる場合は、pricing_mode="quote"を使用してintake_questionsを追加します。受付担当は質問を行い、価格を伝える代わりに見積もり依頼を受け付けます。

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

祝日に休業する

休業期間は、start_dateからend_dateまでの終日を対象とします。事業全体の休業にはtime_off_type="location"を使用します。特定のスタッフを休みにする場合は"staff"を使用し、そのスタッフのIDをresource_idに設定します。

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

ドキュメントをアップロードする

FAQや価格表など、受付担当が回答に使用するドキュメントを追加します。ウェブサイトには、クイックスタートと同様にknowledge_sources.add_urlを使用します。

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

受付担当を設定する

これらの呼び出しには、受付担当のIDが必要です。complete_onboardingのcustomer_facing_agent_id、またはreceptionists.listのagent_idを使用します。

あいさつ、言語、収集する情報を設定する

送信した設定だけが変更されます。

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

通話を転送してルールを追加する

転送ルールは、conditionを満たした場合に通話を担当者へ転送します。転送の可否はプランによって異なるため、まず受付担当のis_transfer_allowedを確認してください。ルールは受付担当の動作を指定します。strictルールには常に従い、suggestionはガイドラインとして扱います。

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

チームを招待する

ワークスペースの作成後は、いつでもメンバーを招待できます。保留中の招待もシートを使用するため、メンバーと招待の合計がプランのチーム人数に達すると、新しい招待は拒否されます。

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