Vai alla navigazione

API Reception

Crea e gestisci i workspace Reception.ai dei tuoi clienti dai tuoi sistemi.

L’API Reception consente a un rivenditore Reception.ai di fare via codice ciò che il pannello di amministrazione del rivenditore fa manualmente: creare un workspace per ogni cliente, assegnargli uno dei tuoi piani, configurare la sua receptionist e monitorare gli addebiti sulla tua carta. Ogni endpoint è disponibile in https://api.elevenlabs.io/v1/reception e negli SDK Python e TypeScript come reception.

Il pannello di amministrazione del rivenditore e, con esso, l’API Reception sono disponibili solo per i partner Reception.ai. Se ti interessa collaborare con noi, contatta il nostro team commerciale.

Autenticazione

Crea una chiave API nel pannello di amministrazione del rivenditore. Solo le chiavi create lì possono chiamare l’API Reception; qualsiasi altra chiave API ElevenLabs viene rifiutata con not_a_reseller_api_key. La chiave viene mostrata una sola volta, quindi salvala in un secret manager.

Invia la chiave nell’header xi-api-key oppure imposta ELEVENLABS_API_KEY e lascia che l’SDK la legga.

Endpoint del rivenditore e del workspace

L’API opera su due livelli.

LivelloOpera suGruppi SDK
RivenditoreIl tuo account rivenditoreworkspaces, tiers, subscriptions, billing
WorkspaceIl workspace di un cliente, indicato in xi-workspace-idbusiness_profile, receptionists, phone_numbers, services, staff, locations, holidays, products, assets, knowledge_sources, team

Gli endpoint del workspace richiedono l’header xi-workspace-id, impostato sull’ID di un workspace che hai creato. Una richiesta senza questo header, o relativa a un workspace che appartiene a un altro rivenditore, viene rifiutata. Negli SDK, l’header corrisponde all’argomento xi_workspace_id in Python e al campo xiWorkspaceId in TypeScript.

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)
staff = elevenlabs.reception.staff.list(
xi_workspace_id=workspaces.workspaces[0].workspace_id,
)

Paginazione

workspaces.list e billing.list_invoices restituiscono una pagina alla volta. Passa il next_cursor di una risposta come cursor per ottenere la pagina successiva e interrompi quando has_more è false.

Limiti di frequenza

I limiti si applicano per rivenditore, su tutte le sue chiavi API:

RichiesteLimite
Letture (GET)600 al minuto
Scritture (tutti gli altri metodi)120 al minuto

Una richiesta oltre il limite restituisce 429. Attendi e riprova.

Passaggi successivi

  • Guida rapida: crea il workspace di un cliente e assegna un numero di telefono alla sua receptionist.
  • Provisioning e onboarding: esempi per creare workspace in blocco e aggiungere sedi, personale, servizi e impostazioni della receptionist di un’attività.
  • Abbonamenti e fatturazione: modifica il piano di un cliente e verifica gli addebiti sulla tua carta.