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

# Quickstart voor de Reception API

Deze handleiding provisiont één klant van begin tot eind met de [Reception API](/docs/nl/reception-ai/reception-api/overview): een workspace met een betaald abonnement, een bedrijfsprofiel waaruit de receptionist kan antwoorden en een telefoonnummer dat hierop overgaat.

## Vereisten

* Een API-sleutel uit het reselleradminpaneel, ingesteld als `ELEVENLABS_API_KEY`. Het adminpaneel is alleen beschikbaar voor Reception.ai-partners; om partner te worden, [neem je contact op met ons salesteam](https://www.reception.ai/contact-sales).
* Een kaart die is gekoppeld aan je reselleraccount. Als je een workspace abonneert, worden hier kosten voor in rekening gebracht.
* De Python-SDK (`pip install elevenlabs`) of de TypeScript-SDK (`npm install @elevenlabs/elevenlabs-js`).

## Een klant provisionen

### Kies een abonnement

Toon de tiers die je verkoopt. Ze staan op volgorde van laagste prijs, en de eerste is de proefversie.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

tiers = elevenlabs.reception.tiers.list()
for tier in tiers:
    print(tier.tier_id, tier.display_name, tier.tier_economics.monthly_price_usd)
```

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

const elevenlabs = new ElevenLabsClient();

const tiers = await elevenlabs.reception.tiers.list();
for (const tier of tiers) {
  console.log(tier.tierId, tier.displayName, tier.tierEconomics.monthlyPriceUsd);
}
```

```bash
curl "https://api.elevenlabs.io/v1/reception/reseller/tier-ladder" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

### Maak de workspace

Maak de workspace van de klant, neem een betaald abonnement af en nodig de bedrijfseigenaar uit. Uitnodigingen gebeuren op basis van best effort: het resultaat van elke uitnodiging staat in `member_results`.

```python
from elevenlabs import ProvisionResellerWorkspaceSubscription, TeamInviteRequest

workspace = elevenlabs.reception.workspaces.create(
    business_name="Bright Smile Dental",
    subscription=ProvisionResellerWorkspaceSubscription(
        tier_id=tiers[1].tier_id,
        billing_period="monthly_period",
    ),
    members=[
        TeamInviteRequest(email="owner@brightsmiledental.com", role="workspace_admin"),
    ],
)

workspace_id = workspace.workspace_id
```

```typescript
const workspace = await elevenlabs.reception.workspaces.create({
  businessName: "Bright Smile Dental",
  subscription: {
    tierId: tiers[1].tierId,
    billingPeriod: "monthly_period",
  },
  members: [{ email: "owner@brightsmiledental.com", role: "workspace_admin" }],
});

const workspaceId = 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", "billing_period": "monthly_period" },
    "members": [{ "email": "owner@brightsmiledental.com", "role": "workspace_admin" }]
  }'
```

Laat `subscription` weg om een workspace zonder abonnement te maken en [wijs er later een toe](/docs/nl/reception-ai/reception-api/subscriptions-and-billing#assign-a-plan).

### Beschrijf het bedrijf

De receptionist antwoordt vanuit het bedrijfsprofiel. Vanaf hier werkt elke aanroep op de nieuwe workspace en bevat deze dus de header `xi-workspace-id`. Dagen in `operating_hours` lopen van `0` (maandag) tot `6` (zondag), en een dag zonder invoer is gesloten.

```python
from elevenlabs import TimeRangeModel, WorkingHours

weekday = [TimeRangeModel(start_hour=8, start_minute=0, end_hour=17, end_minute=0)]

elevenlabs.reception.business_profile.update(
    xi_workspace_id=workspace_id,
    business_country="US",
    business_description="Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
    timezone="America/Los_Angeles",
    operating_hours=WorkingHours(hours={str(day): weekday for day in range(5)}),
)

elevenlabs.reception.knowledge_sources.add_url(
    xi_workspace_id=workspace_id,
    url="https://brightsmiledental.com",
    crawl_entire_site=True,
)
```

```typescript
const weekday = [{ startHour: 8, startMinute: 0, endHour: 17, endMinute: 0 }];

await elevenlabs.reception.businessProfile.update({
  xiWorkspaceId: workspaceId,
  businessCountry: "US",
  businessDescription:
    "Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
  timezone: "America/Los_Angeles",
  operatingHours: {
    hours: { "0": weekday, "1": weekday, "2": weekday, "3": weekday, "4": weekday },
  },
});

await elevenlabs.reception.knowledgeSources.addUrl({
  xiWorkspaceId: workspaceId,
  url: "https://brightsmiledental.com",
  crawlEntireSite: true,
});
```

```bash
curl -X PUT "https://api.elevenlabs.io/v1/reception/agent-info" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "business_country": "US",
    "business_description": "Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
    "timezone": "America/Los_Angeles",
    "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 }]
      }
    }
  }'

curl -X POST "https://api.elevenlabs.io/v1/reception/knowledge-sources/urls" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://brightsmiledental.com", "crawl_entire_site": true }'
```

Services, personeel, locaties en feestdagen voeg je op dezelfde manier toe, met de groepen `services`, `staff`, `locations` en `holidays`.

### Rond de onboarding af

Door de onboarding af te ronden, wordt de receptionist van de workspace gemaakt op basis van het bedrijfsprofiel. Je kunt dit veilig opnieuw proberen. Je kunt ook `complete_onboarding=True` meegeven wanneer je de workspace maakt, maar dan wordt de receptionist alleen op basis van de bedrijfsnaam gemaakt.

```python
onboarding = elevenlabs.reception.workspaces.complete_onboarding(workspace_id)

receptionist_id = onboarding.customer_facing_agent_id
```

```typescript
const onboarding = await elevenlabs.reception.workspaces.completeOnboarding(workspaceId);

const receptionistId = onboarding.customerFacingAgentId;
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/complete-onboarding" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

### Geef de receptionist een telefoonnummer

In de VS en Canada wordt een nummer met een van de aangevraagde netnummers uit de pool gehaald of gekocht. Als dat niet lukt, wordt een willekeurig nummer in het land van het bedrijf gebruikt.

```python
assignment = elevenlabs.reception.phone_numbers.create(
    xi_workspace_id=workspace_id,
    customer_facing_agent_id=receptionist_id,
    area_codes=["415", "628"],
)

print(assignment.phone_number)
```

```typescript
const assignment = await elevenlabs.reception.phoneNumbers.create({
  xiWorkspaceId: workspaceId,
  customerFacingAgentId: receptionistId,
  areaCodes: ["415", "628"],
});

console.log(assignment.phoneNumber);
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/phone-numbers/assignments" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{ "customer_facing_agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6", "area_codes": ["415", "628"] }'
```

De receptionist beantwoordt nu gesprekken naar `phone_number`.

## Volgende stappen

* [Provisioning en onboarding](/docs/nl/reception-ai/reception-api/provisioning-and-onboarding): meer voorbeelden voor het maken van workspaces en het beschrijven van het bedrijf.
* [Abonnementen en facturering](/docs/nl/reception-ai/reception-api/subscriptions-and-billing): wijzig het abonnement van de klant en houd bij wat er van je kaart wordt afgeschreven.