Guida rapida all'API Reception
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
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.
Ometti subscription per creare un workspace senza piano e assegnarne uno in seguito.
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.
Servizi, personale, sedi e festività vengono aggiunti allo stesso modo, con i gruppi services, staff, locations e holidays.
Passaggi successivi
- Provisioning e onboarding: altri esempi per creare workspace e descrivere l’attività.
- Abbonamenti e fatturazione: modifica il piano del cliente e monitora gli addebiti sulla tua carta.