TulzWerkzeugverwaltung

Webhook an die Werkstattsoftware einrichten

Hilfe › Verwaltung

Ausgehende Webhooks schicken Ereignisse aus Tulz an andere Systeme: die Werkstattsoftware bekommt jede Ausgabe mit Auftragsnummer, Zapier/Make/n8n oder Home Assistant starten eigene Abläufe.

Webhooks mit Ereignissen und letzter Zustellung
Webhooks mit Ereignissen und letzter Zustellung

Einrichten

  1. Einstellungen → Schnittstellen & Geräte → Webhooks → Webhook anlegen.
  2. Adresse (https://…) des Empfängers und die Ereignisse anhaken: Ausgabe, Rückgabe, Weitergabe, Schaden, Verlust, Prüfung, neues Werkzeug, Wareneingang.
  3. Das angezeigte Geheimnis kopieren – damit prüft der Empfänger die Signatur X-Tulz-Signature (HMAC-SHA256 des Inhalts). Es wird nur einmal angezeigt.
  4. Test schickt eine Probemeldung; die Liste zeigt die letzte Zustellung mit HTTP-Status.

Jede Meldung ist JSON (POST) mit X-Tulz-Event, X-Tulz-Delivery und dem Werkzeug, Mitarbeiter und Auftrag im Inhalt. Antwortet der Empfänger nicht mit 2xx, wiederholt der Cronjob die Zustellung bis zu sechsmal mit wachsendem Abstand; unter Letzte Zustellungen sehen Sie Fehler. Adressen im eigenen Servernetz sind aus Sicherheitsgründen nicht erlaubt.

War das hilfreich?