Naar navigatie springen

Quickstart voor de Reception API

Maak de workspace van een klant, verkoop deze een abonnement en koppel de receptionist aan een telefoonnummer.

Deze handleiding provisiont één klant van begin tot eind met de Reception API: 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.
  • 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

1

Kies een abonnement

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

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

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.

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

Laat subscription weg om een workspace zonder abonnement te maken en wijs er later een toe.

3

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.

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, personeel, locaties en feestdagen voeg je op dezelfde manier toe, met de groepen services, staff, locations en holidays.

4

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.

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

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.

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)

De receptionist beantwoordt nu gesprekken naar phone_number.

Volgende stappen