Die woasi-Integration einrichten

Die woasi-Integration einrichten

Die woasi-Integration verbindet octoja mit woasi, um Inventaränderungen und ausgewählte Check-Alarme zu übertragen. Nach dem Verbinden sendet octoja stündlich geänderte oder gelöschte Geräte; jeder gesendete Batch enthält außerdem die vollständige Kunden- und Standortliste.

Was wird gesendet?

octoja liefert Inventar-Aktualisierungen als ausgehende HTTP-Zustellungen an eine woasi-API-URL. Beim Verbinden wird kein vollständiger Erstbestand gesendet. Der stündliche Batch berücksichtigt Änderungen seit dem Verbinden beziehungsweise dem letzten erfolgreichen Push und enthält:

• Deine vollständige Kundenliste, jeder Kunde mit seinen Standorten. Dieser Teil ist in jedem gesendeten Batch vollständig enthalten
• Die Geräte, deren Inventar sich seit dem vorherigen Push geändert hat — neu aufgenommen, umbenannt, neu zugeordnet oder mit abweichender Hardware gemeldet
• Die Geräte, die in diesem Fenster gelöscht wurden, damit woasi sie aus seiner Sicht entfernen kann

Der Geräte-Teil des Batches ist inkrementell: Ein Gerät, das sich nicht geändert hat, wird nicht erneut gesendet. Hat sich kein Gerät geändert und wurde keines gelöscht, überspringt octoja diese Stunde und sendet gar nichts. Jede Zustellung führt das von woasi ausgestellte Bearer-Token im Authorization-Header mit, damit woasi bestätigen kann, dass die Anfrage von deinem Mandanten kommt. Die Zustellungshistorie bleibt in octoja als Audit-Trail erhalten — du kannst sie auf der woasi-Integrations-Seite einsehen.

Inventar ist nicht der einzige Payload-Typ: Über dieselbe ausgehende Pipeline liefert octoja auch Check-Alarme an woasi — deshalb beschreibt der Einrichtungsdialog das Feld als die URL, an die octoja Monitoring-Events senden soll. Alarme laufen aber nicht automatisch. Das Verbinden nimmt woasi in die Liste der Alarmkanäle auf, und ein Alarm erreicht woasi nur, wenn eine Alarmierungskonfiguration woasi als einen ihrer Kanäle nennt — siehe Alarmierung für einen Check einrichten.

Ticketsprache einstellen

Öffne Administration → Integrationen → woasi und auf dem Reiter Konfiguration den Bereich Störungsmeldungen. Wähle Ticketsprache und speichere die Einstellungen. Standard ist Deutsch; auch Englisch, Französisch und Niederländisch stehen zur Verfügung.

octoja übergibt einen lesbaren Betreff und eine Problembeschreibung mit Check, Gerät, Status, Häufigkeit im Auswertungsfenster, Prüfergebnis und Direktlink zum Gerät. Bei Erholung beschreibt der Text den Normalzustand statt der Fehlerhäufigkeit. Die Sprachwahl betrifft Betreff und Beschreibung, nicht die Inventardaten.

Voraussetzungen

• Ein aktives woasi-Konto mit API-Zugriff
• Von woasi: die API-URL, an die octoja Inventar POSTen soll, und das von woasi ausgestellte Bearer-Token für ausgehende Zustellungen
• Die Berechtigung Integrationsverwaltung in octoja, erteilt über Gruppen unter Administration → Gruppen

So funktioniert es

Wenn du auf Einrichten klickst (der Dialog mit dem Titel woasi einrichten öffnet sich), macht octoja Folgendes:

1. Speichert API-URL und Bearer-Token auf dem woasi-Integrations-Datensatz.
2. Setzt den Beginn der Inventarübertragung auf den Verbindungszeitpunkt.
3. Nimmt woasi in den stündlichen Inventar-Push auf. Bereits unverändert vorhandene Geräte werden dadurch nicht vollständig nachgeliefert.

Schritte — Verbinden

1. Gehe zu Administration → Integrationen. Unter Ticketsysteme findest du die woasi-Karte.
2. Klicke auf der woasi-Karte auf Einrichten. Der Dialog mit dem Titel woasi einrichten öffnet sich.
3. Fülle aus:

4. Klicke auf Speichern. octoja:

• Speichert URL und Token auf dem woasi-Integrations-Datensatz
• Aktiviert die Übertragung künftiger Inventaränderungen

octoja öffnet die woasi-Integrations-Seite, auf der der Status Aktiviert lautet. Ab dem nächsten stündlichen Lauf werden die Änderungen seit dem Verbinden berücksichtigt.

Eine Test-Zustellung senden

Klicke auf der woasi-Integrations-Seite auf Test senden. octoja reiht zwei Test-Events — ein Event im Inventar-Stil und ein Monitoring-Beispiel — für die Zustellung an die konfigurierte URL mit dem konfigurierten Bearer-Token ein; ein Toast bestätigt Test-Events in die Auslieferungs-Pipeline gestellt. Verwende das, um zu bestätigen, dass woasi die Verbindung akzeptiert, bevor du dich auf den Live-Inventar-Feed verlässt. Test-Zustellungen gehen auch dann raus, wenn die Integration pausiert ist, und sie bleiben aus den Erfolgs- und Fehlerzählern heraus — so kannst du einen korrigierten Endpunkt erneut testen, ohne den Live-Feed zu stören.

Fehlgeschlagene Zustellung prüfen

Ein 405 — Method Not Allowed in der Zustellungshistorie bedeutet: Der woasi-Server war erreichbar, aber die exakt eingetragene Adresse akzeptiert keine POST-Anfragen. Weil octoja genau an die gespeicherte URL sendet, ist die Ursache fast immer eine unvollständige API-URL — typischerweise nur die Domain oder die API-Wurzel (z. B. https://api.woasi.com/) statt des vollständigen Empfänger-Endpunkts von woasi (z. B. https://api.woasi.com/incoming/octoja/…).

So behebst du es:

1. Öffne auf der woasi-Integrations-Seite den Tab Konfiguration, füge den vollständigen Endpunkt in woasi-API-URL ein und klicke auf Speichern.
2. Prüfe mit Test senden die korrigierte Verbindung. Öffne unter Historie die fehlgeschlagene Zustellung und prüfe Anfrage und Antwort. Mit Erneut senden kannst du eine vollständig gespeicherte Zustellung erneut auslösen.

Zu große Anfragen werden in der Historie nur gekürzt gespeichert und entsprechend gekennzeichnet. Du kannst sie nicht manuell erneut senden. Nicht erfolgreich übertragene Inventaränderungen werden im nächsten stündlichen Batch erneut berücksichtigt, solange die Integration aktiv bleibt.

Zustellungen, die mit einem 4xx-Status abgewiesen wurden, werden nicht automatisch als derselbe Versuch wiederholt. Serverfehler und Zeitüberschreitungen wiederholt octoja von selbst: bis zu sechs weitere Versuche, jeweils 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 12 Stunden und schließlich 24 Stunden nach dem vorherigen. Schlagen Zustellungen dauerhaft fehl, pausiert octoja die Integration nach 20 aufeinanderfolgenden Fehlschlägen automatisch.

Pausieren vs. Trennen

Das Bearer-Token aktualisieren

Wenn woasi das Bearer-Token rotiert, öffne die woasi-Integrations-Seite und füge das neue Token in Bearer-Token (woasi → octoja) ein. Das Feld leer zu lassen, behält das aktuelle Token. Ein Badge neben dem Feld zeigt Hinterlegt oder Nicht hinterlegt, damit du auf einen Blick siehst, ob ein Token vorliegt.

Tipps

• Nur HTTPS. Das Einrichtungsformular weist alles ab, was nicht eine absolute https://-URL ist.
• Verwende Pausieren statt Trennen, wenn du die Übertragung vorübergehend unterbrechen und danach die Änderungen nachholen möchtest.
• Der stündliche Batch ist gebündelt — wenn ein Gerät innerhalb einer Stunde mehrfach geändert wird, sendet octoja einen Datensatz mit dem letzten Stand, nicht einen je Änderung.
• Der woasi-Feed umfasst Inventaränderungen und die Check-Alarme, die du über den Alarmkanal an woasi leitest.
• Um Check-Alarme an andere externe Systeme zu senden, sieh dir Webhooks einrichten und Alarme an einen Microsoft-Teams-Kanal senden an.