API Reception
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.
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.
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:
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.