Vai alla navigazione

Guida rapida all'API Reception

Crea il workspace di un cliente, assegnagli un piano e collega la sua receptionist a un numero di telefono.

Questa guida esegue il provisioning completo di un cliente con l’API Reception: un workspace con un piano a pagamento, un profilo aziendale da cui la receptionist può rispondere e un numero di telefono che la fa squillare.

Prerequisiti

  • Una chiave API dal pannello di amministrazione del rivenditore, impostata come ELEVENLABS_API_KEY. Il pannello di amministrazione è disponibile solo per i partner Reception.ai; per diventarlo, contatta il nostro team commerciale.
  • Una carta registrata per il tuo account rivenditore. L’attivazione di un abbonamento per un workspace comporta un addebito.
  • L’SDK Python (pip install elevenlabs) o l’SDK TypeScript (npm install @elevenlabs/elevenlabs-js).

Provisioning di un cliente

1

Scegli un piano

Elenca i tier che vendi. Sono ordinati dal meno costoso e il primo è la prova.

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

Crea il workspace

Crea il workspace del cliente, attiva l’abbonamento a un tier a pagamento e invita il titolare dell’attività. Gli inviti vengono eseguiti in modalità best-effort: il risultato di ciascuno è 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

Ometti subscription per creare un workspace senza piano e assegnarne uno in seguito.

3

Descrivi l’attività

La receptionist risponde in base al profilo aziendale. Da questo punto in poi, ogni chiamata opera sul nuovo workspace e include quindi l’header xi-workspace-id. I giorni in operating_hours vanno da 0 (lunedì) a 6 (domenica) e un giorno senza voce è considerato chiuso.

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

Servizi, personale, sedi e festività vengono aggiunti allo stesso modo, con i gruppi services, staff, locations e holidays.

4

Completa l’onboarding

Il completamento dell’onboarding crea la receptionist del workspace a partire dal profilo aziendale. Puoi riprovare in sicurezza. Puoi anche passare complete_onboarding=True quando crei il workspace, ma in quel caso la receptionist viene creata solo dal nome dell’attività.

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

Assegna un numero di telefono alla receptionist

Negli Stati Uniti e in Canada, viene preso dal pool o acquistato un numero con uno dei prefissi richiesti, con fallback a qualsiasi numero nel paese dell’attività.

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)

La receptionist ora risponde alle chiamate verso phone_number.

Passaggi successivi