Provisioning e onboarding
Questi esempi si basano sulla guida rapida. Usano lo stesso cliente Bright Smile Dental e ogni chiamata al workspace include il suo ID in xi-workspace-id.
Provisioning dei workspace
Provisioning con una richiesta
Quando non hai ancora i dettagli dell’attività, crea il workspace, attiva l’abbonamento, invita il titolare e completa l’onboarding con una sola chiamata. La receptionist viene creata basandosi solo sul nome dell’attività, quindi completa il profilo aziendale in seguito. Passa una idempotency_key affinché un nuovo tentativo dopo un timeout non possa creare un secondo workspace.
L’onboarding durante la creazione viene eseguito in modalità best-effort: se non riesce, onboarding_completed_at_unix è null e puoi ritentarlo con complete_onboarding.
Provisioning dei clienti dal tuo CRM
Deriva ogni idempotency_key dal tuo ID cliente, così rieseguendo l’importazione verranno restituiti i workspace già creati anziché crearne di nuovi. La stessa chiave con un body diverso viene rifiutata con idempotency_key_reused.
Completa l’onboarding dei workspace ancora in configurazione
workspaces.list mostra quali workspace non hanno completato l’onboarding. Puoi riprovare complete_onboarding in sicurezza, quindi puoi eseguirlo a intervalli programmati.
Descrivi l’attività
Aggiungi sedi, personale, servizi e chiusure dell’attività prima di completare l’onboarding, così la receptionist verrà creata a partire da queste informazioni. Puoi anche aggiungerli o modificarli in qualsiasi momento successivo.
Finché l’onboarding non è completo, la procedura guidata di configurazione che il titolare dell’attività vede quando accede può sostituire o rimuovere questi dati. Completa l’onboarding prima che il titolare acceda.
Aggiungi una sede
Ogni sede ha i propri orari. I giorni vanno da 0 (lunedì) a 6 (domenica) e un giorno senza voce è considerato chiuso.
Aggiungi un membro del personale
Un membro del personale presso una sede segue gli orari di quella sede, a meno che non gli assegni i propri working_hours. customer_facing_name è il nome che sentono i chiamanti; name rimane l’etichetta interna.
Aggiungi servizi
Un servizio ha una o più variants, ciascuna con durata e prezzo propri; la prima è quella predefinita. Imposta any_staff_member su false per limitare chi può erogarlo.
Quando il prezzo dipende dal lavoro da svolgere, usa pricing_mode="quote" e aggiungi intake_questions. La receptionist le pone e raccoglie una richiesta di preventivo anziché indicare un prezzo.
Chiudi per festività
Una chiusura copre intere giornate, da start_date a end_date. Usa time_off_type="location" per l’attività oppure "staff" con l’ID del membro del personale in resource_id per l’assenza di una persona.
Carica un documento
Fornisci alla receptionist un documento da usare per rispondere, come una FAQ o un listino prezzi. Usa knowledge_sources.add_url per un sito web, come nella guida rapida.
Configura la receptionist
Queste chiamate richiedono l’ID della receptionist: customer_facing_agent_id da complete_onboarding oppure agent_id da receptionists.list.
Imposta il saluto, le lingue e le informazioni da raccogliere
Vengono modificate solo le impostazioni che invii.
Trasferisci chiamate e aggiungi regole
Una regola di trasferimento passa la chiamata a una persona quando viene soddisfatta la relativa condition. I trasferimenti dipendono dal piano: prima controlla is_transfer_allowed sulla receptionist. Una regola indica alla receptionist come comportarsi; una regola strict viene sempre seguita, mentre una suggestion è una linea guida.
Invita il team
Invita persone in qualsiasi momento dopo la creazione del workspace. Un invito in attesa occupa un posto, quindi un invito viene rifiutato quando membri e inviti raggiungono la dimensione del team prevista dal piano.