Einführung
Diese Integration synchronisiert Level-Geräte als Assets in HaloPSA und leitet Level-Alarme an HaloPSA-Tickets weiter. Die Einrichtung erfolgt in drei Schritten: eine HaloPSA-Anwendung konfigurieren, sie in Level verbinden und anschließend Ihre Gerätegruppen HaloPSA-Standorten zuordnen sowie festlegen, welche Überwachungsrichtlinien Tickets erstellen.
⚙️ VORAUSSETZUNGEN
Level-Administratorzugang
HaloPSA-Administratorzugang mit der Berechtigung, Anwendungen zu erstellen und Agenten zu verwalten
HaloPSA-Integration
HaloPSA-Anwendung konfigurieren
HaloPSA verwendet „Anwendungen", um 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 „View Applications":
5. Dies ist eine Liste Ihrer vorhandenen „Anwendungen". Klicken Sie oben rechts auf „New", um eine Anwendung für Level zu erstellen:
6. Füllen Sie das Pflichtfeld „Application Name" mit einem Namen Ihrer Wahl aus. Wählen Sie die Option „Client ID and Secret (Services)":
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" für den „Login Type" 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 „Save":
10. Klicken Sie auf „Permissions":
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 Asset-Typen Felder hinzufügen können. Sie arbeiten daran, die Änderung rückgängig zu machen, was jedoch etwa zwei Wochen dauern wird (ca. 19. November). Wenn Sie Ihre Halo-Integration in der Zwischenzeit zum ersten Mal einrichten, erteilen Sie der Anwendung bitte die „admin"-Berechtigung für und dem Agenten. Wir entschuldigen uns für die Unannehmlichkeiten.
12. Klicken Sie auf „Save", wenn Sie fertig sind:
HaloPSA-Agentenberechtigungen konfigurieren
Der API-Agent, den Sie im vorherigen Schritt als „Agent to log in as" festgelegt haben, benötigt einige Berechtigungen, um ordnungsgemäß zu funktionieren.
1. Gehen Sie zu Einstellungen > Teams & Agents > Agents und wählen Sie den der Anwendung zugewiesenen Agenten aus:
2. Klicken Sie auf die Registerkarte „Permissions" und wechseln Sie in den „Edit"-Modus:
3. Stellen Sie sicher, dass die folgenden Einstellungen gesetzt sind:
Tickets Access Level - Read and Modify
Clients Access Level - Read Only
Assets Access Level - Read and Modify
Can add new Tickets - Yes
Allow use of all Ticket Types - Yes
4. Klicken Sie auf „Save", 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 Standort 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 „Save changes":
5. Klicken Sie auf „Test connection", 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 in HaloPSA zuordnen.
1. Gehen Sie zu „Group mapping":
2. Klicken Sie auf „Add new groups", 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 „Add new groups":
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 „Save", wenn Sie fertig sind:
ℹ️ HINWEIS: Die Integration bleibt in diesem Stadium deaktiviert, sodass noch keine Geräte synchronisiert werden.
Level-Überwachungsrichtlinien HaloPSA-Tickettypen zuordnen
Level kann Alarme HaloPSA-Tickets zuordnen. Wir müssen lediglich auswählen, welche Überwachungsrichtlinien Tickets erstellen sollen und als welche Tickettypen diese erstellt werden sollen.
1. Klicken Sie auf „Ticketing":
2. Wählen Sie HaloPSA-Tickettypen für jede Richtlinie aus, die Sie zuordnen möchten:
3. Klicken Sie abschließend unten auf der Seite auf „Save changes":
ℹ️ HINWEIS: Die Integration bleibt in diesem Stadium deaktiviert, sodass noch keine Geräte synchronisiert werden.
Geräte und Alarme senden
1. Klicken Sie auf den Schalter „Disabled":
2. Damit beginnt sofort die Übertragung von Geräten und Alarmen. Sie können beobachten, wie sich die Gruppenzuordnungen von „Unsynced" zu „Syncing" und schließlich zu „Synced" ändern:
3. Wenn Sie den Fortschritt verfolgen oder ein Problem beheben möchten, navigieren Sie zur Registerkarte „Events", um eine Echtzeit-Liste der an HaloPSA gesendeten Anfragen anzuzeigen:
FAQ
Wer kann diese Integration konfigurieren? Ein Level-Administrator. Auf der HaloPSA-Seite ist außerdem ein Administrator mit der Berechtigung erforderlich, 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 wird die Synchronisierung aller Geräte in zugeordneten Gruppen gestartet. Beobachten Sie die Gruppenzuordnungstabelle – die Zeilen wechseln von „Unsynced" zu „Synced", während die Geräte verarbeitet werden.
Warum wird ein Gerät nicht in HaloPSA angezeigt? Überprüfen Sie, ob die Gruppe des Geräts unter Group mapping und dass die Integration aktiviert ist. Öffnen Sie dann die Events Registerkarte und suchen Sie nach fehlgeschlagenen Anfragen, die mit diesem Gerät zusammenhängen.
Kann ich nach der Aktivierung der Integration weitere Gruppen zuordnen? Ja. Kehren Sie zu Group mapping, fügen Sie neue Gruppen hinzu und speichern Sie. Neue Gruppen werden nach dem Speichern der Zuordnung synchronisiert.






