配置与入驻
创建客户工作区并填充接待员所需信息的示例。
以下示例基于快速入门。它们使用同一位 Bright Smile Dental 客户,且每次工作区调用都会在 xi-workspace-id 中携带其 ID。
配置工作区
一次请求完成配置
如果暂时没有企业详情,可以通过一次调用创建工作区、为其订阅套餐、邀请所有者并完成入驻。接待员仅根据企业名称创建,因此请随后填写企业资料。传入 idempotency_key,确保超时后的重试不会创建第二个工作区。
创建时完成入驻为尽力而为:如果失败,onboarding_completed_at_unix 为 null,你可以通过 complete_onboarding 重试。
从 CRM 配置客户
从自己的客户 ID 派生每个 idempotency_key,这样再次运行导入时会返回已创建的工作区,而不是创建新工作区。使用相同密钥但不同请求体会因 idempotency_key_reused 而被拒绝。
完成仍在设置中的工作区入驻
workspaces.list 会显示哪些工作区尚未完成入驻。complete_onboarding 可安全重试,因此可以定期运行。
描述企业
在完成入驻前添加企业的地点、员工、服务和停业信息,让接待员据此创建。之后也可以随时添加或更改。
在完成入驻前,企业所有者登录时看到的设置向导可能会 替换或删除这些数据。请在所有者登录前完成入驻。
添加地点
每个地点都有各自的营业时间。日期从 0(周一)到 6(周日),没有条目的日期为停业。
添加员工
地点的员工默认遵循该地点的营业时间,除非为其设置专属 working_hours。customer_facing_name 是来电者听到的名称;name 保留为内部标签。
添加服务
一项服务包含一个或多个 variants,每个变体都有自己的时长和价格;第一个为默认变体。将 any_staff_member 设为 false 可限制可提供该服务的人员。
当价格取决于具体工作时,使用 pricing_mode="quote" 并添加 intake_questions。接待员会询问这些问题并接受报价请求,而非直接报价。
节假日停业
停业覆盖从 start_date 到 end_date 的整天。企业停业使用 time_off_type="location";个人休假则使用 "staff",并在 resource_id 中填入员工 ID。
上传文档
为接待员提供用于回答问题的文档,例如常见问题或价目表。网站请使用 knowledge_sources.add_url,如快速入门所示。
设置接待员
这些调用需要接待员 ID:来自 complete_onboarding 的 customer_facing_agent_id,或来自 receptionists.list 的 agent_id。
设置问候语、语言和收集内容
只有发送的设置会发生更改。
转接来电并添加规则
当满足 condition 时,转接规则会将来电转给相应人员。转接取决于套餐:请先检查接待员的 is_transfer_allowed。规则会告诉接待员应如何处理;strict 规则必须始终遵循,suggestion 则仅作为指引。
邀请团队成员
工作区创建后可随时邀请成员。待处理邀请会占用席位,因此当成员和邀请数达到套餐的团队人数上限后,邀请将被拒绝。