跳到导航

配置与入驻

创建客户工作区并填充接待员所需信息的示例。

以下示例基于快速入门。它们使用同一位 Bright Smile Dental 客户,且每次工作区调用都会在 xi-workspace-id 中携带其 ID。

配置工作区

一次请求完成配置

如果暂时没有企业详情,可以通过一次调用创建工作区、为其订阅套餐、邀请所有者并完成入驻。接待员仅根据企业名称创建,因此请随后填写企业资料。传入 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 配置客户

从自己的客户 ID 派生每个 idempotency_key,这样再次运行导入时会返回已创建的工作区,而不是创建新工作区。使用相同密钥但不同请求体会因 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)},
),
)

添加服务

一项服务包含一个或多个 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",并在 resource_id 中填入员工 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,
)

上传文档

为接待员提供用于回答问题的文档,例如常见问题或价目表。网站请使用 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",
)