Collegare il centralino Yeastar

1. aUn centralino Yeastar P-Series Cloud Edition con firmware 84.20.0.21 o successivo: è la versione da cui il centralino invia gli eventi via webhook.
2. bUn utente con accesso da amministratore al portale web del centralino.
3. cUn utente di majéOS con ruolo di amministratore dello studio.
4. dL'elenco degli interni dello studio: quale interno usa ogni persona, quali numeri sono risponditori automatici o code, quali caselle di segreteria usate e quali interni rispondono a studio chiuso.

majéOS è collaudato con Yeastar P-Series Cloud Edition. Se il tuo centralino è di un'altra edizione o di un'altra serie, scrivi all'assistenza prima di iniziare.

Nel portale web del centralino:

1. aApri Integrations > API e accendi API.
2. bCopia il Client ID e il Client Secret: ti servono al passo successivo. Trattali come una password.
3. cLascia spenta IP Restriction: majéOS si collega dal cloud con indirizzi che possono cambiare, e con la restrizione attiva la lettura della segreteria si fermerebbe.

1. aVai in Impostazioni → Integrazioni, apri Centralino (Yeastar) e premi Configura.
2. bCompila API Client ID e API Client Secret con i valori copiati, e URL centralino con l'indirizzo che usi nel browser per aprire il portale del centralino: solo la parte iniziale, da https:// fino al primo «/» escluso.
3. cPremi Salva. Il campo Webhook Secret per ora resta vuoto: lo genera il centralino al passo 4.
4. dNella scheda del centralino compare URL webhook per il centralino: premi Copia.

Le credenziali vengono salvate cifrate e non si possono più rileggere: majéOS mostra solo se sono presenti. Per cambiarle basta incollare i valori nuovi.

Di nuovo nel portale del centralino, in Integrations > API:

1. aSeleziona Webhook Event Push e aggiungi un webhook.
2. bWebhook URL: incolla l'indirizzo copiato da majéOS, intero.
3. cRequest Method: POST.
4. dEvent: seleziona solo (30012) Call End Details Notification, l'evento che il centralino invia quando una chiamata finisce. majéOS registra come chiamata ciò che arriva a questo indirizzo: altri eventi non vanno selezionati.
5. eCopia il Secret che il centralino ha generato (32 caratteri): è la chiave con cui firma ogni messaggio.
6. fLascia Timeout(s) e Retry Count ai valori proposti e salva.

1. aTorna in Impostazioni → Integrazioni → Centralino (Yeastar) → Configura.
2. bIncolla il Secret nel campo Webhook Secret e premi Salva.
3. cAccendi Integrazione attiva: l'interruttore si sblocca solo quando tutte e quattro le credenziali sono presenti.

Finché l'integrazione è spenta majéOS rifiuta i messaggi del centralino. È voluto: nessuna chiamata entra prima che la configurazione sia completa.

1. aVai in Impostazioni → Moduli e funzionalità e accendi Chiamate.
2. bNel menu compare la voce Chiamate. Se l'integrazione non è ancora configurata, majéOS non lascia accendere il modulo e te lo dice.

Nella stessa scheda del centralino, in Impostazioni → Integrazioni, ci sono tre campi. Separa i numeri con una virgola.

1. aEstensioni di sistema: risponditori automatici, code e interni di servizio. Una chiamata a cui risponde uno di questi numeri non entra nel registro, perché non l'ha gestita una persona. Scrivi qui solo numeri di sistema: l'interno di una persona finito in questo elenco fa sparire le sue chiamate risposte.
2. bCaselle di segreteria: le caselle che majéOS controlla ogni 5 minuti per segnalare «Messaggio in segreteria» sulla chiamata. Al massimo 5; vuoto significa nessun controllo.
3. cInterni di chiusura: gli interni che rispondono quando lo studio è chiuso. Le chiamate che li toccano portano l'etichetta «Chiusura» nella dashboard.

majéOS attribuisce ogni chiamata a chi ha risposto, riconoscendolo dal suo interno.

1. aOggi l'abbinamento fra operatore e interno lo esegue l'assistenza di majéOS durante l'attivazione: mandaci l'elenco degli operatori con il loro interno.
2. bFinché un interno non è abbinato, le sue chiamate entrano comunque nel registro, ma senza il nome di chi ha risposto.

1. aSul centralino, in Integrations > API → Webhook Event Push, premi l'icona di invio nella colonna Operations del webhook: il centralino manda un messaggio di prova firmato. Se viene consegnato, indirizzo, Secret e attivazione sono giusti.
2. bFai una chiamata vera: da un numero esterno chiama lo studio e rispondi da un interno di una persona.
3. cEntro un paio di minuti dalla fine della chiamata la trovi in Chiamate, con il paziente riconosciuto se il numero è nella sua scheda.
4. dSe hai configurato una casella di segreteria, lasciaci un messaggio: entro una decina di minuti la chiamata mostra la nota «Messaggio in segreteria».