Hoppa till navigering

Snabbstart för Reception API

Skapa en kunds arbetsyta, sälj en plan till den och koppla dess receptionist till ett telefonnummer.

Den här guiden provisionerar en kund från början till slut med Reception API: en arbetsyta med en betald plan, en företagsprofil som receptionisten kan svara utifrån och ett telefonnummer som kopplar samtal till den.

Förutsättningar

  • En API-nyckel från återförsäljarens administratörspanel, angiven som ELEVENLABS_API_KEY. Administratörspanelen är endast öppen för Reception.ai-partner; om du vill bli partner kan du kontakta vårt säljteam.
  • Ett registrerat kort för ditt återförsäljarkonto. Att teckna en prenumeration för en arbetsyta debiterar det.
  • Python-SDK:t (pip install elevenlabs) eller TypeScript-SDK:t (npm install @elevenlabs/elevenlabs-js).

Provisionera en kund

1

Välj en plan

Lista de nivåer du säljer. De visas med den billigaste först, och den första är testversionen.

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

Skapa arbetsytan

Skapa kundens arbetsyta, teckna en prenumeration på en betald nivå och bjud in företagsägaren. Inbjudningar görs efter bästa förmåga: resultatet för var och en finns i 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

Utelämna subscription för att skapa en arbetsyta utan en plan och tilldela en senare.

3

Beskriv företaget

Receptionisten svarar utifrån företagsprofilen. Från och med nu gäller varje anrop den nya arbetsytan och har därför headern xi-workspace-id. Dagar i operating_hours går från 0 (måndag) till 6 (söndag), och en dag utan post är stängd.

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

Tjänster, personal, platser och helgdagar läggs till på samma sätt, med grupperna services, staff, locations och holidays.

4

Slutför introduktionen

När introduktionen slutförs skapas arbetsytans receptionist från företagsprofilen. Det går bra att försöka igen. Du kan också skicka complete_onboarding=True när du skapar arbetsytan, men då skapas receptionisten enbart utifrån företagsnamnet.

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

Ge receptionisten ett telefonnummer

I USA och Kanada hämtas eller köps ett nummer med någon av de begärda riktnummerområdena från poolen, med återgång till valfritt nummer i företagets land.

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)

Receptionisten svarar nu på samtal till phone_number.

Nästa steg