Zur Navigation springen

Schnellstart für die Reception API

Erstellen Sie den Workspace eines Kunden, verkaufen Sie ihm einen Plan und weisen Sie seiner Rezeption eine Telefonnummer zu.

Dieser Leitfaden stellt einen Kunden mit der Reception API 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.
  • 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

1

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.

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)
2

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.

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

Lassen Sie subscription weg, um einen Workspace ohne Plan zu erstellen und später einen zuzuweisen.

3

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.

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,
)

Services, Mitarbeitende, Standorte und Feiertage werden auf dieselbe Weise über die Gruppen services, staff, locations und holidays hinzugefügt.

4

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.

onboarding = elevenlabs.reception.workspaces.complete_onboarding(workspace_id)
receptionist_id = onboarding.customer_facing_agent_id
5

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.

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)

Die Rezeption beantwortet nun Anrufe an phone_number.

Nächste Schritte