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

# Provisionering och introduktion

De här exemplen bygger vidare på [snabbstarten](/docs/sv/reception-ai/reception-api/quickstart). De använder samma kund, Bright Smile Dental, och varje arbetsyteanrop har dess ID i `xi-workspace-id`.

## Provisionera arbetsytor

### Provisionera i en begäran

När du ännu inte har företagsuppgifterna kan du skapa arbetsytan, teckna en prenumeration, bjuda in ägaren och slutföra introduktionen i ett enda anrop. Receptionisten skapas enbart utifrån företagsnamnet, så fyll i företagsprofilen efteråt. Skicka en `idempotency_key` så att ett nytt försök efter en timeout inte kan skapa en andra arbetsyta.

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

Introduktion vid skapandet görs efter bästa förmåga: om den misslyckas är `onboarding_completed_at_unix` `null` och du kan försöka igen med `complete_onboarding`.

### Provisionera kunder från ditt CRM

Härled varje `idempotency_key` från ditt eget kund-ID, så att en ny importkörning returnerar de arbetsytor som redan skapats i stället för att skapa nya. Samma nyckel med en annan body avvisas med `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);
}
```

### Slutför introduktionen för arbetsytor som fortfarande konfigureras

`workspaces.list` visar vilka arbetsytor som inte har slutfört introduktionen. `complete_onboarding` kan utan problem köras igen, så du kan köra detta enligt ett schema.

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

## Beskriv företaget

Lägg till företagets platser, personal, tjänster och stängningsdagar innan du slutför introduktionen, så att receptionisten skapas utifrån dem. Du kan också lägga till eller ändra dem när som helst efteråt.

> **Warning**
>
> Tills introduktionen är slutförd kan installationsguiden som företagsägaren ser när hen loggar in
> ersätta eller ta bort dessa data. Slutför introduktionen innan ägaren loggar in.

### Lägg till en plats

Varje plats har sina egna öppettider. Dagarna går från `0` (måndag) till `6` (söndag), och en dag utan post är stängd.

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

### Lägg till en personalmedlem

En personalmedlem på en plats följer platsens öppettider om du inte ger personen egna `working_hours`. `customer_facing_name` är vad de som ringer hör; `name` förblir den interna etiketten.

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

### Lägg till tjänster

En tjänst har en eller flera `variants`, var och en med sin egen längd och sitt eget pris; den första är standard. Ange `any_staff_member` som `false` för att begränsa vem som kan utföra den.

När priset beror på jobbet använder du `pricing_mode="quote"` och lägger till `intake_questions`. Receptionisten ställer dem och tar emot en offertförfrågan i stället för att ange ett pris.

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

### Stäng för en helgdag

En stängning omfattar hela dagar, från `start_date` till `end_date`. Använd `time_off_type="location"` för företaget, eller `"staff"` med personalmedlemmens ID i `resource_id` för en persons ledighet.

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

### Ladda upp ett dokument

Ge receptionisten ett dokument att svara utifrån, till exempel vanliga frågor och svar eller en prislista. Använd `knowledge_sources.add_url` för en webbplats, som i [snabbstarten](/docs/sv/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"
```

## Konfigurera receptionisten

Dessa anrop behöver receptionistens ID: `customer_facing_agent_id` från `complete_onboarding`, eller `agent_id` från `receptionists.list`.

### Ange hälsning, språk och vad som ska samlas in

Endast inställningarna du skickar ändras.

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

### Vidarekoppla samtal och lägg till regler

En vidarekopplingsregel kopplar samtalet till en person när dess `condition` uppfylls. Vidarekopplingar beror på planen: kontrollera först `is_transfer_allowed` på receptionisten. En regel talar om för receptionisten hur den ska agera; en `strict`-regel följs alltid, medan en `suggestion` är en riktlinje.

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

## Bjud in teamet

Bjud in personer när som helst efter att arbetsytan har skapats. En väntande inbjudan tar upp en plats, så en inbjudan avvisas när medlemmar och inbjudningar når planens teamstorlek.

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