Health Check Monitor è uno strumento diagnostico integrato che verifica automaticamente la presenza di comuni problemi di configurazione dell'integrazione Aircall nella tua organizzazione Salesforce. È di sola lettura: nulla viene scritto o modificato nella tua organizzazione. I risultati vengono visualizzati immediatamente e possono essere esportati in formato CSV.
Utilizzalo quando configuri per la prima volta l'integrazione Aircall, dopo l'aggiornamento di un pacchetto o per risolvere problemi quali campi non compilati o chiamate non registrate.
Importante: Health Check Monitor è disponibile solo in Salesforce Lightning. Non è disponibile in Salesforce Classic.
Chi deve eseguirlo
Gli amministratori Salesforce o qualsiasi altro Utente Salesforce autorizzato e responsabile della configurazione o della manutenzione dell'integrazione Aircall<>Salesforce nella tua organizzazione.
Che cosa verifica
Il monitor esegue verifiche in tre categorie:
Installazione del pacchetto: verifica che il pacchetto Aircall sia installato correttamente, che tutti i componenti necessari siano presenti e che le impostazioni dei siti remoti siano configurate.
Autorizzazioni dell'Utente: verifica che l'Utente dell'integrazione disponga dell'accesso API, delle autorizzazioni CRUD corrette per gli oggetti necessari, del set di autorizzazioni richiesto e dell'autorizzazione Visualizza tutto per gli oggetti principali.
Sicurezza a livello di campo: verifica che l'Utente dell'integrazione possa leggere e scrivere tutti i campi Aircall necessari negli oggetti principali.
Nota: Per le versioni future sono previste ulteriori categorie di verifica, tra cui Raggiungibilità degli endpoint Apex, Dati e flussi, Configurazione CTI e vocale e Connettività. Attualmente il monitor copre solo l'integrazione V3/CTI. Il Supporto per Service Cloud Voice (SFV) è previsto per una fase futura.
Configurazione di Health Check Monitor
Una volta installato il pacchetto Aircall, sono necessari due passaggi manuali per rendere disponibile la scheda Controllo integrità nella tua App Lightning.
Passaggio 1: aggiungere la scheda Controllo integrità alla tua App Lightning
Passaggi
- Vai a Configurazione > Gestore applicazioni.
- Individua la tua App Lightning e fai clic su Modifica.
- Vai a Elementi di navigazione e aggiungi la scheda Controllo integrità.
- Salva le modifiche.
Passaggio 2: impostare la scheda su Attiva per impostazione predefinita per il profilo Amministratore di sistema
Passaggi
- Vai a Configurazione > Profili.
- Apri il profilo Amministratore di sistema.
- Vai a Impostazioni schede personalizzate.
- Individua aircallHealthCheckDashboard e impostalo su Attiva per impostazione predefinita.
- Salva le modifiche.
Esecuzione del controllo integrità
Passaggi
- Vai alla scheda Controllo integrità nella tua App Lightning.
- Fai clic su Esegui controllo integrità V3.
- I risultati vengono visualizzati direttamente nella pagina. Espandi ogni categoria per visualizzare i dettagli delle singole verifiche.
Nell'angolo in alto a destra, il Dashboard mostra il nome, il ruolo, l'indirizzo e-mail e il profilo dell'Utente che sta eseguendo il controllo. Prima dell'esecuzione, verifica di avere effettuato l'accesso come Utente corretto, poiché i controlli riflettono le autorizzazioni dell'Utente che li esegue.
Nota: I risultati non vengono memorizzati e scompaiono quando la pagina viene aggiornata. Utilizza il pulsante Scarica report per esportare tutti i risultati in formato CSV prima di chiudere o aggiornare la pagina.
Comprendere i risultati
Ogni verifica restituisce uno dei tre stati seguenti:
| Stato | Significato | Che cosa fare |
|---|---|---|
| SUPERATO | La verifica è stata superata, non è richiesta alcuna azione. | Nulla. |
| NON SUPERATO | È stato rilevato un errore di configurazione. | Espandi la riga per visualizzare il messaggio di errore, i passaggi per risolverlo e un link alla documentazione pertinente. |
| AVVISO | È un'informazione, non un errore, ma è opportuno esaminarla. | Esamina i dettagli mostrati nella riga della verifica. |
Quando una verifica non viene superata, espandi direttamente la riga per scoprire che cosa non ha funzionato e come risolvere il problema. Ogni verifica non superata include un messaggio di errore, passaggi specifici per risolverlo e un link alla documentazione pertinente.
Risoluzione dei problemi comuni
Campi non compilati nei record Salesforce
I campi interessati includono SMS, Risoluzione chiamata, Approfondimenti IA, Registrazione delle chiamate e Tag.
Causa probabile: mancanza della sicurezza a livello di campo (FLS) nei campi Aircall per l'Utente dell'integrazione.
Passaggi
- Esegui il controllo integrità e cerca eventuali errori nella categoria Sicurezza dei campi.
- Assegna AirCall_PermissionSet all'Utente dell'integrazione. In questo modo vengono concesse le autorizzazioni FLS di lettura e scrittura per tutti i campi Aircall necessari.
- Se il set di autorizzazioni è già assegnato, verifica che sia assegnato a un Utente attivo.
Configurazione dell'Utente dell'integrazione non riuscita o chiamate non registrate
Causa probabile: autorizzazione API abilitata mancante o accesso CRUD insufficiente per gli oggetti necessari (Attività, Contatto, Lead, Il mio conto, Caso, Opportunità).
Passaggi
- Esegui il controllo integrità e cerca eventuali errori nella categoria Autorizzazioni dell'Utente.
- Assegna AirCall_PermissionSet e verifica che API abilitata sia impostata nel profilo dell'Utente.
- Se il set di autorizzazioni è assegnato solo a Utenti inattivi, riassegnalo all'Utente attivo dell'integrazione.
Aggiornamento del pacchetto non riuscito con "Errore di autorizzazione dell'oggetto IA"
Causa probabile: AirCall_PermissionSet è assegnato a un Utente con licenza Ospite. In questo stato, Salesforce blocca gli aggiornamenti dei pacchetti.
Passaggi
- Esegui il controllo dello stato e cerca eventuali errori nella categoria Installazione del pacchetto.
- Vai a Configurazione > Set di autorizzazioni > AirCall_PermissionSet > Gestisci assegnazioni.
- Rimuovi dall'assegnazione tutti gli Utenti con licenza Guest.
- Riprova ad aggiornare il pacchetto.
FAQ
Il controllo dello stato apporta modifiche alla mia organizzazione?
No. È completamente in sola lettura. Nessun dato viene scritto o modificato.
Quanto tempo richiede l'esecuzione?
Qualche secondo.
Di chi sono le autorizzazioni riportate dal controllo?
Il controllo riporta le autorizzazioni dell'Utente che lo sta eseguendo, non quelle dell'Utente dell'integrazione. Assicurati di eseguire il controllo con l'Utente corretto. Il nome, il ruolo, l'indirizzo e-mail e il profilo dell'Utente che esegue il controllo sono mostrati nell'angolo in alto a destra del Dashboard.
Quale integrazione è inclusa?
Attualmente solo V3/CTI. Il supporto per Service Cloud Voice (SFV) è previsto per una fase futura.
Cosa devo fare se un controllo non riesce?
Espandi la riga del controllo non riuscito. Mostra il messaggio di errore, cosa correggere e un link alla documentazione pertinente. Per gli scenari di errore comuni, consulta la sezione "Risoluzione dei problemi comuni" qui sopra.
Se devi contattare il Supporto Aircall
Se hai eseguito il controllo dello stato e non riesci a risolvere il problema, raccogli quanto segue prima di contattare il Supporto Aircall:
- L'esportazione CSV del controllo dello stato (fai clic su Scarica report).
- L'ID della tua organizzazione Salesforce.
- La versione del pacchetto Aircall (mostrata nel controllo Avviso sulla versione del pacchetto).
- Il nome del profilo dell'Utente che esegue il controllo (mostrato nel riquadro delle informazioni sull'Utente in alto a destra).
- Uno screenshot di tutti i controlli non riusciti.
Per i registri di debug di Salesforce, vai a Configurazione > Registri di debug e acquisisci un registro di esecuzione Apex durante l'esecuzione del controllo dello stato. Se disponibile, includilo nel ticket di Supporto.
Stato di Aircall
Assistenza per l'accesso