Matrix42-Node für n8n

Was der Node kann

Der Node spricht mit der Matrix42-ESMP-Web-Services-API und deckt die Aufgaben ab, die in der Service-Desk-Automatisierung am häufigsten vorkommen:

• Tickets: Tickets mit gewähltem Status anlegen, Incidents und Service Requests schließen, Tickets in einen anderen Typ umwandeln, Journaleinträge mit Vorlagenparametern hinzufügen
• Data Fragments: Fragmente beliebiger Datendefinitionen suchen, anlegen, ändern und löschen, mit Paging für große Ergebnisse
• Data Objects: Objekte eines Configuration Items anlegen, lesen, ändern und löschen
• Data Queries: die Einträge einer Datenabfrage lesen, mit Paging und Benutzerfiltern
• Storage: eine Datei hochladen und an ein Configuration Item hängen
• Imports: eine vordefinierte Importdefinition ausführen

Workflows aus Matrix42 starten

Das Paket enthält außerdem einen Matrix42 Trigger. Er prüft Matrix42 in einem Intervall und startet einen Workflow, sobald etwas Neues auftaucht:

• wenn ein Ticket angelegt wird, auf Wunsch nur für einen Tickettyp wie Incidents
• wenn ein Objekt einer beliebigen Datendefinition angelegt wird
• wenn ein Objekt angelegt oder geändert wird

Ein ASQL-Filter grenzt ein, was zählt. Der Trigger beginnt beim neuesten vorhandenen Datensatz, beim Aktivieren werden also keine alten Tickets erneut verarbeitet. Jedes Ergebnis enthält die Objekt-ID, bereit für die Ticket-Funktionen des Nodes.

Einrichtung

1. Der Node ist von n8n verifiziert. Öffnen Sie in n8n das Nodes-Panel, suchen Sie nach Matrix42 und installieren Sie ihn; das funktioniert auch in n8n Cloud. Auf einem selbst gehosteten n8n geht es auch über die Einstellungen unter Community Nodes oder mit npm.
2. Legen Sie Zugangsdaten an. Empfohlen ist ein Matrix42-API-Token: Der Node tauscht es gegen ein kurzlebiges Access-Token und erneuert es, bevor es abläuft. Benutzername und Passwort funktionieren ebenfalls.
3. Verwendet Ihr Matrix42-Server ein selbst signiertes Zertifikat, nehmen Sie dessen Zertifizierungsstelle in n8n auf oder aktivieren Sie "Ignore SSL Issues" für diese Zugangsdaten.

Kompatibilität

• n8n 1.85 oder neuer, zuletzt getestet mit n8n 2.36
• Node.js 22 oder neuer
• Matrix42-ESMP-API, zuletzt getestet mit Matrix42 26.1

Gut zu wissen

Der Node nutzt nur die dokumentierte öffentliche API von Matrix42. Er ist ein Community-Projekt und steht in keiner Verbindung zu Matrix42. Fragen und Fehlermeldungen gehen an die Issues des Repositorys auf GitHub.

Was der Node in einem echten Service Desk leisten kann, beschreibt unser Beitrag Matrix42-Integration für n8n. Wenn KI-Assistenten mit derselben Matrix42-Instanz arbeiten sollen, sehen Sie sich den Matrix42 MCP-Server an.