Webhook aus einem Trigger aufrufen

Aktualisiert 2026-08-31

Hinweis: Dies ist ein hoch technischer Artikel. Wir empfehlen daher, Ihre IT‑Abteilung beim Durchlesen hinzuzuziehen. Wenn Sie Fragen oder Wünsche haben, kontaktieren Sie uns unter support@azumuta.com - wir helfen Ihnen gerne weiter.

Wenn Azumuta ein anderes System darüber informieren muss, dass etwas passiert ist (z. B. eine Produktionsbestellung abgeschlossen wurde oder ein Problem gemeldet wurde), verwenden Sie vorzugsweise einen Webhook-Trigger statt periodischem Abfragen der REST-API. Webhooks tauschen nur die notwendigen Daten genau zum Zeitpunkt des Ereignisses aus. Für das größere ERP‑Integrationsmuster siehe ERP Integration.

Dieser Artikel erklärt, wie Sie einen Call a webhook-Trigger konfigurieren: wo Sie ihn einrichten, welche Attribute zu befüllen sind und was Azumuta an Ihren Endpunkt sendet.

Voraussetzungen

Webhook-Trigger beinhalten einen apiKey, der von einem Api Device in Ihrem Workspace stammt. Sie benötigen mindestens ein konfiguriertes Api Device. Wenn kein Api Device existiert, schlägt der Webhook mit einer Fehlermeldung wie No api device configured fehl.

Siehe Create and manage API keys zur Einrichtung eines Api Device und Azumutas REST-API dazu, wie dieser Schlüssel beim Aufruf von Azumuta verwendet wird.

Einen Webhook-Trigger hinzufügen

Klicken Sie unter Management auf Settings.
Klicken Sie unter Integrations auf Triggers.
Klicken Sie auf Add trigger (der gelbe Plus‑Button).
Füllen Sie die unten beschriebenen Felder aus.
Wenn Sie fertig sind, klicken Sie auf Add.

Was, Wann und Umfang

What: Wählen Sie Call a webhook.
When: Wählen Sie das Ereignis aus, das den Trigger auslösen soll (z. B. wenn eine Produktionsbestellung abgeschlossen ist oder ein Problem gemeldet wird). Verfügbare Ereignisse hängen vom Scope ab.
Scope: Wählen Sie, worauf sich der Trigger bezieht — z. B. eine Artikelkategorie, alle Produktionsbestellungen, Probleme, Audits oder ein Board. Verfügbare Ereignisse hängen vom Scope ab. Siehe:

Sie können den Trigger später bearbeiten oder löschen und die Nutzungsverläufe einsehen.

Attribute

Nachdem Sie What und When ausgewählt haben, zeigt der Abschnitt Attributes die Webhook‑Optionen an:

Endpoint: Die HTTPS‑URL, die Azumuta aufruft (Platzhalter beginnt mit https://). Dieser Endpunkt muss von den Azumuta‑Servern erreichbar sein.
Method: Auswahlfeld für GET oder POST. Standard ist GET.
Payload: Nur sichtbar, wenn die Methode POST ist. Geben Sie hier den benutzerdefinierten Body‑Inhalt ein. Hinweis in der UI: “You can use parameters in this field.”

Was Azumuta sendet

Azumuta schickt immer einen apiKey von einem Workspace Api Device sowie ereignisspezifische Felder:

Scope	Typical fields
Product orders	`identifier` (Produktbestellnummer) und, falls zutreffend, `workinstructionId` und `recordingId`
Issues	`issueId`, `issueNumber` (und bei einigen Ereignissen verwandte Spalten-/Ak tionsfelder)
Audits	`recordingId`, `workinstructionId` und verwandte Audit‑Felder wie `auditNumber`

Wie diese Felder übermittelt werden, hängt von der Methode ab:

GET: Felder werden als URL‑Query‑Parameter angehängt.
POST: Felder werden als JSON im Request‑Body gesendet. Wenn Sie eine benutzerdefinierte Payload konfiguriert haben, wird dieser Inhalt unter dem Schlüssel payload im JSON‑Body verschachtelt (neben apiKey und den oben genannten Ereignisfeldern).

Ihr empfangendes System kann den enthaltenen apiKey verwenden, um die Azumutas REST-API für zusätzliche Daten aufzurufen — ein gängiges Muster mit einer Integrationsschicht vor einem ERP.