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

# Reception API

Reception API låter en Reception.ai-återförsäljare göra i kod det som återförsäljarens administratörspanel gör manuellt: skapa en arbetsyta för varje kund, sälja en av dina planer till den, konfigurera dess receptionist och följa vad som debiteras på ditt kort. Varje endpoint finns under `https://api.elevenlabs.io/v1/reception` och är tillgänglig som `reception` i Python- och TypeScript-SDK:erna.

> **Note**
>
> Återförsäljarens administratörspanel, och därmed Reception API, är endast öppen för Reception.ai-partner. Om
> du är intresserad av att samarbeta med oss kan du [kontakta vårt säljteam](https://www.reception.ai/contact-sales).

## Autentisering

Skapa en API-nyckel i återförsäljarens administratörspanel. Endast nycklar som skapas där kan anropa Reception API; alla andra ElevenLabs API-nycklar avvisas med `not_a_reseller_api_key`. Nyckeln visas bara en gång, så spara den i en hemlighetshanterare.

Skicka nyckeln i headern `xi-api-key`, eller ange `ELEVENLABS_API_KEY` och låt SDK:t läsa den.

## Endpoints för återförsäljare och arbetsytor

API:t fungerar på två nivåer.

| Nivå           | Gäller                                          | SDK-grupper                                                                                                                                           |
| -------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Återförsäljare | Ditt återförsäljarkonto                         | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| Arbetsyta      | En kunds arbetsyta, angiven i `xi-workspace-id` | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

Endpoints för arbetsytor kräver headern `xi-workspace-id`, angiven som ID:t för en arbetsyta som du har skapat. En begäran utan den, eller för en arbetsyta som tillhör en annan återförsäljare, avvisas. I SDK:erna är headern argumentet `xi_workspace_id` i Python och fältet `xiWorkspaceId` i TypeScript.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
    print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)

staff = elevenlabs.reception.staff.list(
    xi_workspace_id=workspaces.workspaces[0].workspace_id,
)
```

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

const elevenlabs = new ElevenLabsClient();

const { workspaces } = await elevenlabs.reception.workspaces.list({ pageSize: 50 });
for (const workspace of workspaces) {
  console.log(workspace.workspaceId, workspace.businessName, workspace.billingTier);
}

const staff = await elevenlabs.reception.staff.list({
  xiWorkspaceId: workspaces[0].workspaceId,
});
```

```bash
elevenlabs reception workspaces list --page-size 50
```

## Sidindelning

`workspaces.list` och `billing.list_invoices` returnerar en sida i taget. Skicka `next_cursor` från ett svar som `cursor` för att hämta nästa sida, och sluta när `has_more` är `false`.

## Hastighetsbegränsningar

Gränserna gäller per återförsäljare, för alla dess API-nycklar:

| Begäranden                       | Gräns         |
| -------------------------------- | ------------- |
| Läsningar (`GET`)                | 600 per minut |
| Skrivningar (alla andra metoder) | 120 per minut |

En begäran som överskrider gränsen returnerar `429`. Vänta och försök igen.

## Nästa steg

* [Snabbstart](/docs/sv/reception-ai/reception-api/quickstart): skapa en kunds arbetsyta och koppla dess receptionist till ett telefonnummer.
* [Provisionering och introduktion](/docs/sv/reception-ai/reception-api/provisioning-and-onboarding): exempel på att skapa arbetsytor i bulk och lägga till ett företags platser, personal, tjänster och receptionistinställningar.
* [Prenumerationer och fakturering](/docs/sv/reception-ai/reception-api/subscriptions-and-billing): ändra en kunds plan och se vad som debiteras på ditt kort.