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

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

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

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

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

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

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

### サービスを追加する

サービスには1つ以上の`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"`を使用し、そのスタッフのIDを`resource_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"
  }'
```

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

FAQや価格表など、受付担当が回答に使用するドキュメントを追加します。ウェブサイトには、[クイックスタート](/docs/ja/reception-ai/reception-api/quickstart)と同様に`knowledge_sources.add_url`を使用します。

```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" }'
```