Monitor für die Salesforce-Systemdiagnose

Der Health Check Monitor ist ein integriertes Diagnosetool, das Ihre Salesforce-Organisation automatisch auf häufige Fehlkonfigurationen bei der Aircall-Integration überprüft. Es verfügt ausschließlich über Lesezugriff: In Ihrer Organisation werden keine Daten geschrieben oder geändert. Die Ergebnisse werden sofort angezeigt und können als CSV-Datei exportiert werden.

Verwenden Sie ihn bei der erstmaligen Einrichtung der Aircall-Integration, nach einem Paket-Upgrade oder bei der Fehlerbehebung, wenn beispielsweise Felder nicht ausgefüllt oder Anrufe nicht protokolliert werden.

Wer sollte die Prüfung ausführen?

Salesforce-Administratoren oder andere berechtigte Salesforce-Nutzer, die für die Einrichtung oder Verwaltung der Aircall<>Salesforce-Integration in Ihrer Organisation verantwortlich sind.

Was wird geprüft?

Der Monitor führt Prüfungen in drei Kategorien durch:

Paketinstallation: Überprüft, ob das Aircall-Paket korrekt installiert ist, alle erforderlichen Komponenten vorhanden und die Einstellungen für Remote-Standorte konfiguriert sind.

Nutzerberechtigungen: Überprüft, ob der Integrationsnutzer über API-Zugriff, die richtigen CRUD-Berechtigungen für erforderliche Objekte, den erforderlichen zugewiesenen Berechtigungssatz und die Berechtigung „Alle anzeigen“ für wichtige Objekte verfügt.

Sicherheit auf Feldebene: Überprüft, ob der Integrationsnutzer alle erforderlichen Aircall-Felder in wichtigen Objekten lesen und bearbeiten kann.

Health Check Monitor einrichten

Nach der Installation des Aircall-Pakets sind zwei manuelle Schritte erforderlich, um die Registerkarte „Health Check“ in Ihrer Lightning-App verfügbar zu machen.

Schritt 1: Registerkarte „Health Check“ zur Lightning-App hinzufügen

Schritte

1. Gehen Sie zu Einrichtung > App-Manager.
2. Suchen Sie Ihre Lightning-App und klicken Sie auf Bearbeiten.
3. Gehen Sie zu Navigationselemente und fügen Sie die Registerkarte Health Check hinzu.
4. Speichern Sie Ihre Änderungen.

Schritt 2: Registerkarte für das Profil „Systemadministrator“ auf „Standardmäßig aktiviert“ setzen

Schritte

1. Gehen Sie zu Einrichtung > Profile.
2. Öffnen Sie das Profil Systemadministrator.
3. Gehen Sie zu Einstellungen für benutzerdefinierte Registerkarten.
4. Suchen Sie aircallHealthCheckDashboard und setzen Sie die Einstellung auf Standardmäßig aktiviert.
5. Speichern Sie Ihre Änderungen.

Health Check ausführen

Schritte

1. Navigieren Sie in Ihrer Lightning-App zur Registerkarte Health Check.
2. Klicken Sie auf V3 Health Check ausführen.
3. Die Ergebnisse werden direkt angezeigt. Erweitern Sie die einzelnen Kategorien, um Details zu den jeweiligen Prüfungen anzuzeigen.

Oben rechts im Dashboard werden Name, Rolle, E-Mail-Adresse und Profil des Nutzers angezeigt, der die Prüfung gerade ausführt. Vergewissern Sie sich vor der Ausführung, dass Sie als der richtige Nutzer angemeldet sind, da die Prüfungen die Berechtigungen des ausführenden Nutzers widerspiegeln.

Ergebnisse verstehen

Jede Prüfung gibt einen von drei Status zurück:

Wenn eine Prüfung fehlschlägt, erweitern Sie die entsprechende Zeile, um die Ursache und die Schritte zur Behebung anzuzeigen. Jede fehlgeschlagene Prüfung enthält eine Fehlermeldung, konkrete Schritte zur Behebung und einen Link zur relevanten Dokumentation.

Häufige Probleme beheben

Felder in Salesforce-Datensätzen werden nicht ausgefüllt

Zu den betroffenen Feldern gehören SMS, Anruflösung, KI-Erkenntnisse, Anrufaufzeichnung und Tags.

Wahrscheinliche Ursache: fehlende Sicherheit auf Feldebene (FLS) für Aircall-Felder beim Integrationsnutzer.

Schritte

1. Führen Sie den Health Check aus und suchen Sie in der Kategorie Feldsicherheit nach fehlgeschlagenen Prüfungen.
2. Weisen Sie dem Integrationsnutzer AirCall_PermissionSet zu. Dadurch werden Lese- und Schreibberechtigungen auf Feldebene für alle erforderlichen Aircall-Felder gewährt.
3. Wenn der Berechtigungssatz bereits zugewiesen ist, prüfen Sie, ob er einem aktiven Nutzer zugewiesen ist.

Einrichtung des Integrationsnutzers schlägt fehl oder Anrufe werden nicht protokolliert

Wahrscheinliche Ursache: fehlende Berechtigung „API aktiviert“ oder unzureichender CRUD-Zugriff auf erforderliche Objekte (Aufgabe, Kontakt, Lead, Account, Kundenvorgang, Opportunity).

Schritte

1. Führen Sie den Health Check aus und suchen Sie in der Kategorie Nutzerberechtigungen nach fehlgeschlagenen Prüfungen.
2. Weisen Sie AirCall_PermissionSet zu und stellen Sie sicher, dass im Profil des Nutzers API aktiviert festgelegt ist.
3. Wenn der Berechtigungssatz nur inaktiven Nutzern zugewiesen ist, weisen Sie ihn dem aktiven Integrationsnutzer neu zu.

Paket-Upgrade schlägt mit „Berechtigungsfehler für KI-Objekt“ fehl

Wahrscheinliche Ursache: AirCall_PermissionSet ist einem Nutzer mit Gastlizenz zugewiesen. Salesforce blockiert in diesem Zustand Paket-Upgrades.

Schritte

1. Führen Sie die Integritätsprüfung aus und suchen Sie in der Kategorie Paketinstallation nach Fehlern.
2. Gehen Sie zu Einrichtung > Berechtigungssätze > AirCall_PermissionSet > Zuweisungen verwalten.
3. Entfernen Sie alle Nutzer mit Gastlizenz aus der Zuweisung.
4. Versuchen Sie erneut, das Paket zu aktualisieren.

Häufig gestellte Fragen

Nimmt die Integritätsprüfung Änderungen an meiner Organisation vor?

Nein. Sie hat ausschließlich Lesezugriff. Es werden keine Daten geschrieben oder geändert.

Wie lange dauert die Ausführung?

Einige Sekunden.

Wessen Berechtigungen bildet die Prüfung ab?

Die Prüfung bildet die Berechtigungen des Nutzers ab, der sie aktuell ausführt, nicht die Berechtigungen des Integrationsnutzers. Stellen Sie sicher, dass Sie die Prüfung als der richtige Nutzer ausführen. Name, Rolle, E-Mail-Adresse und Profil des ausführenden Nutzers werden oben rechts im Dashboard angezeigt.

Welche Integration wird damit abgedeckt?

Derzeit nur V3/CTI | Computer Telephony Integration. Die Unterstützung für Service Cloud Voice (SFV) ist für eine zukünftige Phase geplant.

Was soll ich tun, wenn eine Prüfung fehlschlägt?

Erweitern Sie die Zeile der fehlgeschlagenen Prüfung. Sie enthält die Fehlermeldung, die erforderliche Korrektur und einen Link zur relevanten Dokumentation. Informationen zu häufigen Fehlerszenarien finden Sie oben im Abschnitt „Häufige Probleme beheben“.

Wenn Sie den Aircall Support kontaktieren müssen

Wenn Sie die Integritätsprüfung ausgeführt haben und das Problem nicht beheben können, halten Sie vor der Kontaktaufnahme mit dem Aircall Support Folgendes bereit:

• Den CSV-Export aus der Integritätsprüfung (klicken Sie auf Bericht herunterladen).
• Ihre Salesforce-Organisations-ID.
• Die Version des Aircall-Pakets (angezeigt in der Prüfung „Warnung zur Paketversion“).
• Den Profilnamen des ausführenden Nutzers (angezeigt im Nutzerinformationsfeld oben rechts).
• Einen Screenshot aller fehlgeschlagenen Prüfungen.

Gehen Sie für Salesforce-Debug-Protokolle zu Einrichtung > Debug-Protokolle und erfassen Sie während der Ausführung der Integritätsprüfung ein Apex-Ausführungsprotokoll. Fügen Sie dieses, sofern verfügbar, Ihrem Support-Ticket bei.