Mit der NinjaOne-Integration kannst du nach einem Anruf automatisch ein Ticket in NinjaOne erstellen. Die Integration verwendet eine API-Services-Anwendung mit Client Credentials. Es öffnet sich deshalb kein Anmeldefenster im Browser.
API-Services-Anwendung in NinjaOne anlegen
Öffne in NinjaOne Configuration → Apps → API → Client App IDs und lege eine neue Anwendung an. Wähle als Plattform API Services und aktiviere den Grant Type Client Credentials. Für diese Integration sind die Bereiche Monitoring und Management vorgesehen. Bewahre Client ID und Client Secret sicher auf.
Das Client Secret wird nach dem Speichern nicht mehr im Browser angezeigt. Gib es nur erneut ein, wenn du es ändern möchtest.
Numerische Ticketing-IDs ermitteln
Ermittle über die offiziellen NinjaOne-API-Routen die numerische id der Kundenorganisation, des aktiven Ticketformulars und des Ticketstatus. Nutze dafür GET /v2/organizations, GET /v2/ticketing/ticket-form und GET /v2/ticketing/statuses. Wenn du diese API-Abfragen nicht selbst durchführen kannst, lass dir die Werte von deinem NinjaOne-Administrator oder NinjaOne-Support bereitstellen.
Verwende für die Kundenorganisation nicht die Funktion Org ID kopieren aus der NinjaOne-Oberfläche. Die dort angezeigte UUID ist nicht die numerische Client-ID, die die Ticket-API erwartet. smao kann diese UUID nicht umwandeln.
| Feld | Bedeutung |
|---|---|
| Region | na für Nordamerika, emea für Europa oder apac für Asien-Pazifik |
| OAuth Client ID | Client ID der API-Services-Anwendung |
| OAuth Client Secret | Client Secret der API-Services-Anwendung |
NinjaOne verbinden
Öffne im Dashboard die Integrationen, wähle NinjaOne und trage Region, Client ID und Client Secret ein. Wähle die Region ausdrücklich aus; es gibt keinen Standardwert. Beim Verbinden fordert smao ein Zugriffstoken an und prüft die Zugangsdaten mit einer Ticketing-Abfrage. Erst danach wird die Verbindung verschlüsselt gespeichert. Kundenorganisation, Formular und Status werden dabei noch nicht geprüft.
Beim erneuten Verbinden bleiben Region und Client ID vorausgefüllt. Ein unverändertes Client Secret musst du nicht erneut eingeben.
Ticket-Node zur Anrufanalyse hinzufügen
Öffne deine Anrufanalyse und füge die NinjaOne-Aktion Ticket erstellen hinzu. Trage die numerischen IDs für Kundenorganisation, Ticketformular und Ticketstatus ein. Alle drei Felder sind Pflichtfelder und bleiben ohne Standardwert leer. Statt eines festen Werts kannst du mit @ eine vorhandene Analysevariable einsetzen. Betreff und Beschreibung sind ebenfalls Pflichtfelder und unterstützen Variablen.
| Einstellung | Verhalten |
|---|---|
| NinjaOne-Kunden-ID (Organisation) | Numerische API-ID des Zielkunden oder eine @Variable; keine UUID aus der NinjaOne-Oberfläche |
| Ticketformular-ID | Numerische ID eines aktiven Ticketformulars oder eine @Variable; kein Standardwert |
| Ticketstatus-ID | Numerische Ticketstatus-ID oder eine @Variable; kein Standardwert |
| Typ | Standard: Incident; außerdem Problem, Frage, Aufgabe, Änderungsanfrage, Serviceanfrage, Projekt, Termin oder Sonstiges |
| Priorität | Keine, Niedrig, Mittel oder Hoch |
| Schweregrad | Keine, Gering, Moderat, Schwerwiegend oder Kritisch |
| Ticket-ID-Variable | Optionaler Variablenname für die von NinjaOne zurückgegebene Ticket-ID |
smao löst eingetragene @Variablen erst bei der Ausführung auf und prüft dann das Zahlenformat der drei IDs. NinjaOne prüft beim Erstellen des Tickets, ob Kunde, Formular und Status tatsächlich existieren und verwendet werden dürfen. Ein Fehler wird im betroffenen Analyse-Node angezeigt.
Ticket-ID weiterverwenden
Wenn du eine Ticket-ID-Variable angibst, kannst du deren exakten Wert in nachfolgenden Nodes verwenden. Die Integration erzeugt keinen Ticket-Link, weil NinjaOne dafür keine allgemeine, dokumentierte Dashboard-URL bereitstellt.
Bei ungültigen oder widerrufenen Zugangsdaten fordert das Dashboard eine erneute Verbindung an; die gespeicherte verschlüsselte Konfiguration bleibt dabei erhalten. Ungültige Kunden-, Formular- oder Status-IDs werden erst bei der Ticketerstellung sichtbar. Wenn ein Lauf nach einer möglicherweise erfolgreichen Ticketerstellung unterbrochen wurde, wird der Node nicht automatisch erneut ausgeführt. Prüfe in NinjaOne, ob das Ticket bereits vorhanden ist, bevor du manuell einen neuen Analyselauf startest.
Ticketformulare mit zwingenden benutzerdefinierten Attributen werden in Version 1 nicht unterstützt. NinjaOne lehnt die Erstellung in diesem Fall sichtbar ab; wähle ein anderes Formular.