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

# Schnellstart für die Reception API

Dieser Leitfaden stellt einen Kunden mit der [Reception API](/docs/de/reception-ai/reception-api/overview) vollständig bereit: einen Workspace mit einem kostenpflichtigen Plan, ein Unternehmensprofil, aus dem die Rezeption Antworten ableitet, und eine Telefonnummer, die sie entgegennimmt.

## Voraussetzungen

* Ein API-Key aus dem Reseller-Admin-Panel, gesetzt als `ELEVENLABS_API_KEY`. Das Admin-Panel steht nur Reception.ai-Partnern offen. Um Partner zu werden, [kontaktieren Sie unser Vertriebsteam](https://www.reception.ai/contact-sales).
* Eine für Ihr Reseller-Konto hinterlegte Karte. Das Abonnieren eines Workspace wird ihr belastet.
* Das Python-SDK (`pip install elevenlabs`) oder das TypeScript-SDK (`npm install @elevenlabs/elevenlabs-js`).

## Kunden bereitstellen

### Plan auswählen

Listen Sie die Pläne auf, die Sie verkaufen. Sie sind vom günstigsten zum teuersten sortiert, und der erste ist der Testplan.

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

### Workspace erstellen

Erstellen Sie den Workspace des Kunden, abonnieren Sie dafür einen kostenpflichtigen Plan und laden Sie den Unternehmensinhaber ein. Einladungen erfolgen nach bestem Bemühen: Das Ergebnis jeder Einladung steht 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" }]
  }'
```

Lassen Sie `subscription` weg, um einen Workspace ohne Plan zu erstellen und [später einen zuzuweisen](/docs/de/reception-ai/reception-api/subscriptions-and-billing#assign-a-plan).

### Unternehmen beschreiben

Die Rezeption leitet ihre Antworten aus dem Unternehmensprofil ab. Von hier an wirkt jeder Aufruf auf den neuen Workspace und enthält daher den Header `xi-workspace-id`. Die Tage in `operating_hours` reichen von `0` (Montag) bis `6` (Sonntag); ein Tag ohne Eintrag ist geschlossen.

```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, Mitarbeitende, Standorte und Feiertage werden auf dieselbe Weise über die Gruppen `services`, `staff`, `locations` und `holidays` hinzugefügt.

### Onboarding abschließen

Mit dem Abschluss des Onboardings wird die Rezeption des Workspace aus dem Unternehmensprofil erstellt. Der Vorgang kann sicher wiederholt werden. Sie können beim Erstellen des Workspace auch `complete_onboarding=True` übergeben, doch dann wird die Rezeption allein anhand des Unternehmensnamens erstellt.

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

### Der Rezeption eine Telefonnummer zuweisen

In den USA und Kanada wird eine Nummer mit einer der angeforderten Vorwahlen aus dem Pool genommen oder gekauft. Falls keine verfügbar ist, wird auf eine beliebige Nummer im Land des Unternehmens zurückgegriffen.

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

Die Rezeption beantwortet nun Anrufe an `phone_number`.

## Nächste Schritte

* [Bereitstellung und Onboarding](/docs/de/reception-ai/reception-api/provisioning-and-onboarding): Weitere Beispiele zum Erstellen von Workspaces und zum Beschreiben des Unternehmens.
* [Abonnements und Abrechnung](/docs/de/reception-ai/reception-api/subscriptions-and-billing): Ändern Sie den Plan des Kunden und verfolgen Sie nach, was Ihrer Karte belastet wird.