> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# 配置与入驻

以下示例基于[快速入门](/docs/zh/reception-ai/reception-api/quickstart)。它们使用同一位 Bright Smile Dental 客户，且每次工作区调用都会在 `xi-workspace-id` 中携带其 ID。

## 配置工作区

### 一次请求完成配置

如果暂时没有企业详情，可以通过一次调用创建工作区、为其订阅套餐、邀请所有者并完成入驻。接待员仅根据企业名称创建，因此请随后填写企业资料。传入 `idempotency_key`，确保超时后的重试不会创建第二个工作区。

```python
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)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const workspace = await elevenlabs.reception.workspaces.create({
  businessName: "Bright Smile Dental",
  subscription: { tierId: "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0" },
  members: [
    { email: "owner@brightsmiledental.com", role: "workspace_admin" },
    { email: "frontdesk@brightsmiledental.com" },
  ],
  completeOnboarding: true,
  idempotencyKey: "provision-crm-10482",
});

for (const result of workspace.memberResults ?? []) {
  if (result.outcome === "failed") {
    console.log("Invite failed:", result.email, result.errorStatus);
  }
}

if (workspace.onboardingCompletedAtUnix == null) {
  await elevenlabs.reception.workspaces.completeOnboarding(workspace.workspaceId);
}
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Bright Smile Dental",
    "subscription": { "tier_id": "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0" },
    "members": [
      { "email": "owner@brightsmiledental.com", "role": "workspace_admin" },
      { "email": "frontdesk@brightsmiledental.com" }
    ],
    "complete_onboarding": true,
    "idempotency_key": "provision-crm-10482"
  }'
```

创建时完成入驻为尽力而为：如果失败，`onboarding_completed_at_unix` 为 `null`，你可以通过 `complete_onboarding` 重试。

### 从 CRM 配置客户

从自己的客户 ID 派生每个 `idempotency_key`，这样再次运行导入时会返回已创建的工作区，而不是创建新工作区。使用相同密钥但不同请求体会因 `idempotency_key_reused` 而被拒绝。

```python
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
```

```typescript
const customers = [
  { crmId: "10482", name: "Bright Smile Dental", owner: "owner@brightsmiledental.com" },
  { crmId: "10483", name: "Harbor Physio", owner: "hello@harborphysio.com" },
];

const workspaceIds = new Map<string, string>();
for (const customer of customers) {
  const workspace = await elevenlabs.reception.workspaces.create({
    businessName: customer.name,
    subscription: { tierId: "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0" },
    members: [{ email: customer.owner, role: "workspace_admin" }],
    idempotencyKey: `provision-crm-${customer.crmId}`,
  });
  workspaceIds.set(customer.crmId, workspace.workspaceId);
}
```

### 完成仍在设置中的工作区入驻

`workspaces.list` 会显示哪些工作区尚未完成入驻。`complete_onboarding` 可安全重试，因此可以定期运行。

```python
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
```

```typescript
let cursor: string | undefined;
do {
  const page = await elevenlabs.reception.workspaces.list({ cursor, pageSize: 100 });
  for (const workspace of page.workspaces) {
    if (workspace.onboardingCompletedAtUnix == null) {
      await elevenlabs.reception.workspaces.completeOnboarding(workspace.workspaceId);
    }
  }
  cursor = page.hasMore ? page.nextCursor : undefined;
} while (cursor);
```

## 描述企业

在完成入驻前添加企业的地点、员工、服务和停业信息，让接待员据此创建。之后也可以随时添加或更改。

> **Warning**
>
> 在完成入驻前，企业所有者登录时看到的设置向导可能会
> 替换或删除这些数据。请在所有者登录前完成入驻。

### 添加地点

每个地点都有各自的营业时间。日期从 `0`（周一）到 `6`（周日），没有条目的日期为停业。

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

```typescript
const workspaceId = "8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7";

const weekday = [{ startHour: 8, startMinute: 0, endHour: 17, endMinute: 0 }];
const saturday = [{ startHour: 9, startMinute: 0, endHour: 13, endMinute: 0 }];

const location = await elevenlabs.reception.locations.create({
  xiWorkspaceId: workspaceId,
  name: "Mission Street",
  address: "2140 Mission St, San Francisco, CA 94110",
  notes: "Free parking behind the building.",
  operatingHours: {
    hours: { "0": weekday, "1": weekday, "2": weekday, "3": weekday, "4": weekday, "5": saturday },
  },
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/locations" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mission Street",
    "address": "2140 Mission St, San Francisco, CA 94110",
    "notes": "Free parking behind the building.",
    "operating_hours": {
      "hours": {
        "0": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "1": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "2": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "3": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "4": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "5": [{ "start_hour": 9, "start_minute": 0, "end_hour": 13, "end_minute": 0 }]
      }
    }
  }'
```

### 添加员工

地点的员工默认遵循该地点的营业时间，除非为其设置专属 `working_hours`。`customer_facing_name` 是来电者听到的名称；`name` 保留为内部标签。

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

```typescript
const shift = [{ startHour: 9, startMinute: 0, endHour: 15, endMinute: 0 }];

const hygienist = await elevenlabs.reception.staff.create({
  xiWorkspaceId: workspaceId,
  name: "Maria Lopez (hygienist)",
  customerFacingName: "Maria",
  description: "Dental hygienist. Speaks English and Spanish.",
  email: "maria@brightsmiledental.com",
  locationId: location.id,
  workingHours: { hours: { "0": shift, "1": shift, "2": shift, "3": shift } },
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/staff" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria Lopez (hygienist)",
    "customer_facing_name": "Maria",
    "description": "Dental hygienist. Speaks English and Spanish.",
    "email": "maria@brightsmiledental.com",
    "location_id": "6a1f0c3e9b2d4f7a8c5e1d0b3a9f6c2e"
  }'
```

### 添加服务

一项服务包含一个或多个 `variants`，每个变体都有自己的时长和价格；第一个为默认变体。将 `any_staff_member` 设为 `false` 可限制可提供该服务的人员。

当价格取决于具体工作时，使用 `pricing_mode="quote"` 并添加 `intake_questions`。接待员会询问这些问题并接受报价请求，而非直接报价。

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

```typescript
await elevenlabs.reception.services.create({
  xiWorkspaceId: workspaceId,
  name: "Cleaning",
  description: "Routine cleaning and polish.",
  variants: [
    { durationMinutes: 45, price: 120 },
    { durationMinutes: 60, price: 160 },
  ],
  anyStaffMember: false,
  staffIds: [hygienist.id],
  bufferMinutes: 10,
});

await elevenlabs.reception.services.create({
  xiWorkspaceId: workspaceId,
  name: "Invisalign consultation",
  pricingMode: "quote",
  variants: [{ durationMinutes: 30 }],
  intakeQuestions: [
    { label: "Have you worn braces or aligners before?", kind: "choice", options: ["Yes", "No"] },
    { label: "What would you like to fix?", required: true },
  ],
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/services" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Cleaning",
    "description": "Routine cleaning and polish.",
    "variants": [
      { "duration_minutes": 45, "price": 120 },
      { "duration_minutes": 60, "price": 160 }
    ],
    "any_staff_member": false,
    "staff_ids": ["3c9e2b7a1f4d4a6e9b0c5d8f2e1a7b4c"],
    "buffer_minutes": 10
  }'
```

### 节假日停业

停业覆盖从 `start_date` 到 `end_date` 的整天。企业停业使用 `time_off_type="location"`；个人休假则使用 `"staff"`，并在 `resource_id` 中填入员工 ID。

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

```typescript
await elevenlabs.reception.holidays.create({
  xiWorkspaceId: workspaceId,
  name: "Winter break",
  startDate: { year: 2026, month: 12, day: 24 },
  endDate: { year: 2026, month: 12, day: 26 },
  timeOffType: "location",
  locationId: location.id,
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/holidays" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Winter break",
    "start_date": { "year": 2026, "month": 12, "day": 24 },
    "end_date": { "year": 2026, "month": 12, "day": 26 },
    "time_off_type": "location",
    "location_id": "6a1f0c3e9b2d4f7a8c5e1d0b3a9f6c2e"
  }'
```

### 上传文档

为接待员提供用于回答问题的文档，例如常见问题或价目表。网站请使用 `knowledge_sources.add_url`，如[快速入门](/docs/zh/reception-ai/reception-api/quickstart)所示。

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

```typescript
import fs from "node:fs";

await elevenlabs.reception.knowledgeSources.upload({
  xiWorkspaceId: workspaceId,
  file: fs.createReadStream("new-patient-faq.pdf"),
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/knowledge-sources" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -F "file=@new-patient-faq.pdf"
```

## 设置接待员

这些调用需要接待员 ID：来自 `complete_onboarding` 的 `customer_facing_agent_id`，或来自 `receptionists.list` 的 `agent_id`。

### 设置问候语、语言和收集内容

只有发送的设置会发生更改。

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

```typescript
const [receptionist] = await elevenlabs.reception.receptionists.list({
  xiWorkspaceId: workspaceId,
});

await elevenlabs.reception.receptionists.update(receptionist.agentId, {
  xiWorkspaceId: workspaceId,
  config: {
    firstMessage: "Thanks for calling Bright Smile Dental, how can I help?",
    additionalLanguages: ["es"],
    toneTraits: ["warm", "concise"],
    detailsToCollect: ["full name", "date of birth", "insurance provider"],
    additionalInstructions:
      "Never give medical advice. Offer the next available appointment instead.",
  },
});
```

```bash
curl -X PATCH "https://api.elevenlabs.io/v1/reception/customer-facing-agents/agent_7101k5zvyjhmfg983brhmhkd98n6" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "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` 则仅作为指引。

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

```typescript
await elevenlabs.reception.receptionists.transferRules.create(receptionist.agentId, {
  xiWorkspaceId: workspaceId,
  label: "Front desk",
  phoneNumber: "+14155550142",
  condition: "The caller has a dental emergency or asks to speak to a person.",
});

await elevenlabs.reception.receptionists.rules.create(receptionist.agentId, {
  xiWorkspaceId: workspaceId,
  title: "New patients",
  description: "Ask new patients to arrive 15 minutes early to fill in forms.",
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/customer-facing-agents/agent_7101k5zvyjhmfg983brhmhkd98n6/transfer-rules" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Front desk",
    "phone_number": "+14155550142",
    "condition": "The caller has a dental emergency or asks to speak to a person."
  }'
```

## 邀请团队成员

工作区创建后可随时邀请成员。待处理邀请会占用席位，因此当成员和邀请数达到套餐的团队人数上限后，邀请将被拒绝。

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

```typescript
await elevenlabs.reception.team.invites.create({
  xiWorkspaceId: workspaceId,
  email: "office.manager@brightsmiledental.com",
  role: "workspace_admin",
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/team/invites" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{ "email": "office.manager@brightsmiledental.com", "role": "workspace_admin" }'
```