Einführung
Diese Integration synchronisiert Level-Geräte als Assets in HaloPSA und leitet Level-Warnmeldungen an HaloPSA-Tickets weiter. Die Einrichtung erfolgt in drei Schritten: Konfigurieren Sie eine HaloPSA-Anwendung, verbinden Sie diese in Level und ordnen Sie dann Ihre Gerätegruppen den HaloPSA-Standorten zu. Wählen Sie außerdem aus, welche Monitor-Richtlinien Tickets erstellen sollen.
⚙️ VORAUSSETZUNGEN
Level-Administratorzugang
HaloPSA-Administratorzugang mit der Berechtigung, Anwendungen zu erstellen und Agenten zu verwalten
HaloPSA-Integration
HaloPSA-Anwendung konfigurieren
HaloPSA verwendet „Anwendungen", um den API-Zugriff zu ermöglichen. Wir müssen eine für Level erstellen.
1. Gehen Sie zu Einstellungen > Integrationen:
2. Klicken Sie auf „HaloPSA API":
3. Notieren Sie sich die unten angezeigte Basis-URL. Diese wird als „HaloPSA-URL" bei der Konfiguration von Level verwendet:
4. Klicken Sie auf „Anwendungen anzeigen":
5. Dies ist eine Liste Ihrer vorhandenen „Anwendungen". Klicken Sie oben rechts auf „Neu", um eine Anwendung für Level zu erstellen:
6. Füllen Sie das Pflichtfeld „Anwendungsname" mit einem Namen Ihrer Wahl aus. Wählen Sie die Option „Client-ID und Secret (Dienste)":
7. Notieren Sie sich die „Client-ID" und das „Client-Secret", da wir diese bei der Konfiguration von Level benötigen.
8. Wählen Sie „Agent" als „Anmeldetyp" und wählen Sie den Agenten aus, den Level verwenden soll.
💡 TIPP: HaloPSA empfiehlt, für Integrationen einen „Nur-API"-Agenten zu erstellen. Dieser Agententyp zählt nicht gegen Ihre Lizenzplätze.
9. Klicken Sie auf „Speichern":
10. Klicken Sie auf „Berechtigungen":
11. Wählen Sie die folgenden Berechtigungen aus:
read:tickets
edit:tickets
read:customers
read:assets
edit:assets
ℹ️ HINWEIS: Halo hat kürzlich eine Änderung vorgenommen, die verhindert, dass Nicht-Admin-Integrationen Felder zu Asset-Typen hinzufügen können. Sie arbeiten daran, die Änderung rückgängig zu machen, aber das wird etwa zwei Wochen dauern (ca. 19. November). Wenn Sie Ihre Halo-Integration in der Zwischenzeit zum ersten Mal einrichten, gewähren Sie der Anwendung bitte die „Admin"-Berechtigung für und den Agenten. Wir bitten die Unannehmlichkeiten zu entschuldigen.
12. Klicken Sie auf „Speichern", wenn Sie fertig sind:
HaloPSA-Agentenberechtigungen konfigurieren
Der API-Agent, den Sie im vorherigen Schritt als „Anmelde-Agent" festgelegt haben, benötigt einige Berechtigungen, um ordnungsgemäß zu funktionieren.
1. Gehen Sie zu Einstellungen > Teams & Agenten > Agenten und wählen Sie den der Anwendung zugewiesenen Agenten aus:
2. Klicken Sie auf die Registerkarte „Berechtigungen" und aktivieren Sie den „Bearbeiten"-Modus:
3. Stellen Sie sicher, dass die folgenden Einstellungen gesetzt sind:
Tickets-Zugriffsebene – Lesen und Ändern
Kunden-Zugriffsebene – Nur Lesen
Assets-Zugriffsebene – Lesen und Ändern
Neue Tickets hinzufügen darf – Ja
Verwendung aller Ticket-Typen erlauben – Ja
4. Klicken Sie auf „Speichern", wenn Sie fertig sind:
Integration in Level konfigurieren
1. Gehen Sie zu Einstellungen > Integrationen:
2. Klicken Sie auf die HaloPSA-Integration:
3. Füllen Sie die drei Konfigurationsfelder aus:
HaloPSA-URL
Die URL, über die Sie auf Ihre HaloPSA-Instanz zugreifen. Diese URL kann auf einen lokalen oder cloudbasierten Speicherort verweisen und sollte das entsprechende Protokoll enthalten. Zum Beispiel: https://domainhalopsa.com.
Client-ID
Der Wert, den wir in den vorherigen Schritten generiert haben.
Client-Secret
Der Wert, den wir in den vorherigen Schritten generiert haben.
4. Klicken Sie auf die Schaltfläche „Änderungen speichern":
5. Drücken Sie „Verbindung testen", um sicherzustellen, dass Ihre Einstellungen funktionieren:
Level-Gruppen HaloPSA-Standorten zuordnen
Level erstellt Assets in HaloPSA basierend auf Ihren Gruppenzuordnungen. Sie können jede Gruppe oder Untergruppe in Level auswählen und sie einer Kombination aus Unternehmen und Standort aus HaloPSA zuordnen.
1. Gehen Sie zu „Gruppenzuordnung":
2. Klicken Sie auf „Neue Gruppen hinzufügen", um die Level-Gruppen auszuwählen, die HaloPSA-Standorten zugeordnet werden sollen:
3. Wählen Sie eine oder mehrere Gruppen aus und klicken Sie auf „Neue Gruppen hinzufügen":
4. Wählen Sie ein HaloPSA-Unternehmen für die erste Zuordnung aus:
5. Wählen Sie den HaloPSA-Standort aus:
6. Wiederholen Sie dies für jede Zeile und klicken Sie auf „Speichern", wenn Sie fertig sind:
ℹ️ HINWEIS: Die Integration bleibt in dieser Phase deaktiviert, daher werden noch keine Geräte synchronisiert.
Level-Monitor-Richtlinien HaloPSA-Ticket-Typen zuordnen
Level kann Warnmeldungen HaloPSA-Tickets zuordnen. Wir müssen lediglich auswählen, welche Monitor-Richtlinien Tickets erstellen sollen und als welche Ticket-Typen diese erstellt werden sollen.
1. Klicken Sie auf „Ticketing":
2. Wählen Sie HaloPSA-Ticket-Typen für jede Richtlinie aus, die Sie zuordnen möchten:
3. Klicken Sie abschließend unten auf der Seite auf „Änderungen speichern":
ℹ️ HINWEIS: Die Integration bleibt in dieser Phase deaktiviert, daher werden noch keine Geräte synchronisiert.
Geräte und Warnmeldungen übermitteln
1. Klicken Sie auf den Schalter „Deaktiviert":
2. Dadurch werden sofort Geräte und Warnmeldungen übermittelt. Sie können sehen, wie sich die Gruppenzuordnungen von „Nicht synchronisiert" zu „Wird synchronisiert" und schließlich zu „Synchronisiert" ändern:
3. Wenn Sie den Fortschritt verfolgen oder ein Problem beheben möchten, navigieren Sie zur Registerkarte „Ereignisse", um eine Echtzeit-Liste der an HaloPSA gesendeten Anfragen zu sehen:
Häufig gestellte Fragen
Wer kann diese Integration konfigurieren? Ein Level-Administrator. Auf der HaloPSA-Seite ist ebenfalls ein Administrator erforderlich, der die Berechtigung hat, Anwendungen zu erstellen und Agenten zu verwalten.
Muss ich einen dedizierten HaloPSA-Agenten dafür erstellen? HaloPSA empfiehlt es. Ein „Nur-API"-Agent verbraucht keinen Lizenzplatz und hält Integrationsaktivitäten von menschlichen Agentenaktivitäten getrennt.
Werden alle Geräte sofort synchronisiert, wenn ich die Integration aktiviere? Ja. Durch Aktivieren des Schalters werden alle Geräte in zugeordneten Gruppen synchronisiert. Beobachten Sie die Gruppenzuordnungstabelle – Zeilen wechseln von „Nicht synchronisiert" zu „Synchronisiert", während Geräte verarbeitet werden.
Warum wird ein Gerät in HaloPSA nicht angezeigt? Überprüfen Sie, ob die Gruppe des Geräts unter Gruppenzuordnung und dass die Integration aktiviert ist. Öffnen Sie dann die Ereignisse Registerkarte und suchen Sie nach fehlgeschlagenen Anfragen im Zusammenhang mit diesem Gerät.
Kann ich nach der Aktivierung der Integration weitere Gruppen zuordnen? Ja. Gehen Sie zurück zu Gruppenzuordnung, fügen Sie neue Gruppen hinzu und speichern Sie. Neue Gruppen werden nach dem Speichern der Zuordnung synchronisiert.






