Die woasi-Integration einrichten

Die woasi-Integration einrichten

Die woasi-Integration verbindet octoja mit woasi — der verbundenen Plattform, die du nutzt, um Daten kundenübergreifend zu zentralisieren. Sobald die Verbindung steht, sendet octoja einen Baseline-Inventar-Snapshot an woasi und liefert anschließend stündlich Batches mit jedem Kunden, Standort und Gerät, das sich seit dem letzten Push geändert hat.

Was wird gesendet?

octoja liefert Inventar-Aktualisierungen über signierte ausgehende Zustellungen an eine woasi-API-URL. Der erste Push nach Einrichten ist ein vollständiger Snapshot — jeder Kunde, Standort und jedes Gerät — damit woasi eine vollständige Baseline hat. Danach sendet octoja einen stündlichen Batch, der enthält:

• Kunden-, Standort- und Gerätedatensätze, die seit dem vorherigen Push erstellt, umbenannt oder anderweitig verändert wurden
• Löschungen, die in diesem Fenster eingereiht wurden (damit woasi seine Sicht synchron halten kann)

Der stündliche Batch ist inkrementell — wenn sich an einem Kunden oder Gerät innerhalb der Stunde nichts geändert hat, wird dieser Datensatz nicht erneut gesendet. Die Zustellungen sind mit dem von woasi ausgestellten Bearer-Token signiert, und die Zustellungshistorie wird in octoja als Audit-Trail aufbewahrt — du kannst sie auf der woasi-Integrations-Seite einsehen.

Inventar ist nicht der einzige Payload-Typ: über dieselbe ausgehende Pipeline liefert octoja auch Monitoring-Events an woasi. Der Einrichtungsdialog fragt nach der URL, an die octoja Monitoring-Events senden soll, und die unten beschriebene Test-Zustellung enthält ein Monitoring-Beispiel.

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 einem einzelnen woasi-Integrations-Datensatz.
2. Reiht einen initialen Baseline-Push ein, sodass woasi jeden Kunden, Standort und jedes Gerät erhält, das du derzeit verwaltest.
3. Startet den stündlichen Delta-Scheduler.

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
• Reiht einen Baseline-Inventar-Push ein

Der Status der Karte wechselt auf Aktiviert, und beim nächsten Tick des stündlichen Delta-Schedulers werden alle Änderungen seit der Baseline gesendet.

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.

Integration aktiv, aber der Snapshot schlägt mit 405 fehl

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. Wechsle zum Tab Historie und klicke bei der fehlgeschlagenen Snapshot-Zustellung auf Erneut senden. Der vollständige Snapshot wird an die korrigierte URL geschickt.

Zustellungen, die mit einem 4xx-Status abgewiesen wurden, werden nicht automatisch wiederholt, und der Baseline-Snapshot wird vom stündlichen Scheduler nicht erneut angestoßen — bis der Snapshot durchgeht (oder du trennst und neu verbindest, was eine frische Baseline einreiht), bleibt Letzter Inventar-Push auf Ausstehend und es werden keine stündlichen Batches gesendet. 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. Das Status-Label zeigt, ob aktuell ein Token gespeichert ist.

Tipps

• Nur HTTPS. Das Einrichtungsformular weist alles ab, was nicht eine absolute https://-URL ist.
• Der Baseline-Push läuft einmal beim Verbinden. Wenn du die Verbindung trennst und später wieder verbindest, reiht octoja eine frische Baseline ein, damit woasi synchron ist. Das Fortsetzen nach einer Pause löst keine neue Baseline aus — der nächste stündliche Tick holt die Änderungen von selbst nach.
• 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 und Monitoring-Events. octoja sendet keine Meldungsaktivität oder Remote-Control-Ereignisse an woasi.
• Um Check-Alarme an andere externe Systeme zu senden, sieh dir Webhooks einrichten und Alarme an einen Microsoft-Teams-Kanal senden an.