HaloITSM

Aktualisiert am 02.11.20265 Min. LesezeitVon Emmanuel YazbeckVeröffentlicht 18.10.2026

Verbinden Sie HaloITSM, damit der KI-Sprachagent Anrufer finden, Tickets erstellen und aktualisieren sowie Ihre Wissensdatenbank in Halo durchsuchen kann.

Verfügbarkeit: AI Voice- und AI Voice + Helpdesk-Profile. Nur Administratoren.

Voraussetzungen

Sie haben die Rolle Eigentümer oder Administrator.
Ihre Organisation verwendet das AI Voice- oder das AI Voice + Helpdesk-Profil.
Ihre Halo-Adresse. Bei einer haloitsm.com-Instanz benötigen Sie nur den ersten Teil, zum Beispiel northwind. Bei einer Test- oder selbst gehosteten Instanz benötigen Sie den vollständigen Hostnamen, zum Beispiel northwind.trial.usehalo.com.
Eine Halo-API-Anwendung mit einer Client-ID und einem Client-Secret. AurionAI meldet sich mit diesen beiden Werten an und fordert den Scope all an.
Optional: die Halo-IDs des Abschlussergebnisses, des offenen Status und des Ticket-Typs für Änderungsanfragen.

HaloITSM verbinden

Wählen Sie in der Seitenleiste Konfiguration.
Öffnen Sie die Kategorie Integrationen und wählen Sie Anbieter.
Wählen Sie im Abschnitt ITSM-Integration die Option ITSM-Anbieter einrichten. Wenn bereits ein Tool verbunden ist, wählen Sie Anmeldedaten bearbeiten auf dessen Karte.
Wählen Sie unter Anbietertyp die Option HaloITSM.
Geben Sie unter Instanzname den ersten Teil Ihrer Halo-Adresse oder den vollständigen Hostnamen ein. Geben Sie keine IP-Adresse ein.
Optional: Füllen Sie im Feld HaloITSM Ticket-Lifecycle-Einstellungen die IDs aus:
- Schließungs-Ergebnis-ID: das Ergebnis, das AurionAI zum Schließen von Tickets verwendet.
- Offen-Status-ID: der Status, den AurionAI zum Wiedereröffnen von Tickets verwendet.
- Änderungsantrags-Typ-ID: der Ticket-Typ, den AurionAI für Änderungsanfragen verwendet.
Lassen Sie ein Feld leer, um den AurionAI-Standard zu verwenden.
Fügen Sie unter Client-ID und Client-Geheimnis die Werte Ihrer Halo-API-Anwendung ein.
Wählen Sie Verbindung testen. Warten Sie auf Verbindung mit den angegebenen Anmeldedaten erfolgreich..
Überprüfen Sie die Schalter unter Fähigkeiten. Lesen Sie Ihre ITSM- und CS-Tools verbinden.
Wählen Sie Speichern.

Der Verbindungsdialog mit den HaloITSM-Feldern.

Beim ersten Speichern öffnet AurionAI die Feldzuordnung. Legen Sie bei einer neuen Halo-Installation dort die Standardwerte für ausgehende Tickets fest. Lesen Sie Anbieterfelder zuordnen.

Wenn Sie eine gespeicherte Verbindung bearbeiten, zeigt der Dialog Anmeldeinformationen gespeichert an. Lassen Sie die Client-ID und das Client-Secret leer, um die gespeicherten Werte beizubehalten.

So füllt AurionAI neue Halo-Tickets aus

Eine Standard-Halo-Installation lehnt ein neues Ticket ohne Auswirkung, Dringlichkeit und Kategorie ab. AurionAI sendet diese drei Felder bei jedem neuen Ticket:

Die Kategorie stammt aus Ihren aktiven Halo-Kategorien. AurionAI sucht zunächst nach einer Kategorie, die zum Problem des Anrufers passt. Andernfalls wird eine allgemeine Kategorie verwendet.
Wenn AurionAI Ihre Kategorien nicht lesen kann, verwendet es Auswirkung 2, Dringlichkeit 2 und die Kategorie Allgemein. Beim nächsten Ticket versucht es erneut, die Kategorien zu lesen.

Eine Kategorie oder ein Wert, den Sie selbst wählen, hat immer Vorrang.

Verbindung testen und Test-Ticket erstellen

Wählen Sie Verbindung testen auf der Karte. Die Karte zeigt Verbindung erfolgreich. oder den Grund des Fehlers an.
Wählen Sie Testticket erstellen, um ein echtes Ticket in Halo zu erstellen. Das Ticket hat den Betreff „AurionAI - Configuration Test". Löschen Sie es anschließend in Halo.

Verbindung ändern oder entfernen

Um die Anmeldedaten zu ersetzen, wählen Sie ITSM-Anmeldeinformationen rotieren. Fügen Sie die neuen Werte in HaloITSM-Client-ID und HaloITSM-Client-Geheimnis ein. Wählen Sie Verbindung testen und dann Rotieren. AurionAI behält die vorherigen Werte.
Um zu den vorherigen Anmeldedaten zurückzukehren, wählen Sie Rollback auf vorherige Anmeldeinformationen und bestätigen Sie.
Um die Verbindung zu entfernen, wählen Sie Integration entfernen und bestätigen Sie. Dies kann nicht rückgängig gemacht werden.

Ergebnis

Die Karte zeigt HaloITSM und Verbunden an. AurionAI testet die Verbindung jedes Mal, wenn Sie speichern. Anrufe, die nach dem Speichern beginnen, verwenden die neuen Einstellungen.

Wenn etwas schiefläuft

Ungültige Anmeldeinformationen. Überprüfen Sie Ihren API-Schlüssel oder Ihr Client-Geheimnis. Halo hat die Client-ID oder das Client-Secret abgelehnt. Überprüfen Sie beide Werte in Ihrer Halo-API-Anwendung.
Erforderliche Berechtigungen fehlen. Kontaktieren Sie Ihren ITSM-Administrator. Die API-Anwendung oder der Agent, als der sie ausgeführt wird, hat keine Berechtigung für Tickets. Überprüfen Sie die Berechtigungen der Anwendung in Halo.
Ratenlimit überschritten. Versuchen Sie es später noch einmal. Halo begrenzt die Anzahl der Anfragen. Warten Sie einen Moment und testen Sie erneut.
Der Anbieter kann nicht erreicht werden. Überprüfen Sie die API-URL und die Netzwerkkonnektivität. AurionAI kann die Adresse nicht erreichen. Überprüfen Sie den Instanznamen. Geben Sie bei einer Testinstanz den vollständigen Hostnamen ein.
Instanzname ist erforderlich — eine Subdomain oder ein vollständiger Hostname (Buchstaben, Zahlen, Bindestriche und Punkte) Geben Sie eine Subdomain oder einen vollständigen Hostnamen ein. Eine IP-Adresse wird nicht akzeptiert.
Geben Sie oben Anmeldedaten ein, bevor Sie testen. Der Test im Dialog benötigt die Client-ID und das Client-Secret. Fügen Sie diese ein, auch wenn sie bereits gespeichert sind.
Halo lehnt neue Tickets ab, weil Auswirkung, Dringlichkeit oder Kategorie erforderlich sind. Stellen Sie sicher, dass Ihr Halo aktive Kategorien hat. Legen Sie dann die Standardwerte für ausgehende Tickets in der Feldzuordnung fest.
Der Sprachagent kann Tickets nicht wiedereröffnen. Setzen Sie Offen-Status-ID auf die ID eines offenen Status in Ihrem Halo.
Der Sprachagent kann Tickets nicht schließen. Setzen Sie Schließungs-Ergebnis-ID auf die ID eines Abschlussergebnisses in Ihrem Halo.
Der Sprachagent kann keine Änderungsanfragen erstellen. AurionAI findet den Änderungsanfrage-Typ nur dann selbstständig, wenn Ihr Halo genau einen Ticket-Typ namens Change Request hat. Andernfalls setzen Sie Änderungsantrags-Typ-ID.
Ticket-Test fehlgeschlagen, mit einer Meldung, dass die Verbindung nicht verifiziert ist. Testen Sie zuerst die Verbindung. Wenn der Test fehlschlägt, korrigieren Sie die Einstellungen und speichern Sie sie.
Speichern der Integrationseinstellungen fehlgeschlagen, mit einer Meldung, dass Sie die Anmeldedaten erneut eingeben müssen. Sie haben die Halo-Adresse geändert. Fügen Sie die Client-ID und das Client-Secret erneut ein und speichern Sie dann.