Aufruf eines Webhooks durch einen Trigger

Aktualisiert 2026-10-09

Hinweis: Dieser Artikel ist technisch; wir empfehlen, eine Person mit entsprechender technischer Expertise einzubeziehen. Bei Fragen kontaktieren Sie uns unter support@azumuta.com.

Wenn Azumuta ein anderes System benachrichtigen muss, dass etwas passiert ist (z. B. eine Produktionsbestellung abgeschlossen wurde oder ein Problem gemeldet wurde), verwenden Sie vorzugsweise einen Webhook-Trigger anstatt periodisch die REST API abzufragen. Webhooks übertragen nur die notwendigen Daten zum Zeitpunkt des Ereignisses. Für das allgemeinere ERP-Integrationsmuster siehe ERP Integration.

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

Voraussetzungen

Webhook-Trigger enthalten einen apiKey, der von einem Api Device in Ihrem Workspace stammt. Sie benötigen mindestens ein konfiguriertes Api Device. Falls keines vorhanden ist, schlägt der Webhook mit einer Fehlermeldung wie No api device configured fehl.

Siehe Create and manage API keys für Anweisungen zum Einrichten eines Api Device und Azumuta’s REST API dafür, wie dieser Schlüssel beim Aufruf von Azumuta verwendet wird.

Einen Webhook-Trigger hinzufügen

Klicken Sie unter Management auf Einstellungen.
Klicken Sie unter Integrations auf Trigger.
Klicken Sie auf Trigger hinzufügen (die gelbe Plus-Schaltfläche).
Füllen Sie die unten beschriebenen Felder aus.
Klicken Sie abschließend auf Hinzufügen.

What, When, and Scope

What: Wählen Sie Call a webhook.
When: Wählen Sie das Ereignis, das den Trigger auslösen soll (z. B. wenn eine Produktionsbestellung abgeschlossen ist oder ein Problem gemeldet wird). Verfügbare Ereignisse hängen vom Geltungsbereich 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 Geltungsbereich 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 Attribute die Webhook-Optionen an:

Endpoint: Die HTTPS-URL, die Azumuta aufruft (Platzhalter beginnt mit https://). Dieser Endpunkt muss von den Azumuta-Servern aus erreichbar sein.
Method: Optionsfelder für GET oder POST. Standard ist GET.
Payload: Wird nur angezeigt, wenn die Methode POST ist. Geben Sie hier den benutzerdefinierten Inhalt des Bodys ein. Der Hinweis in der UI lautet: „Sie können Parameter in diesem Feld verwenden."

Was Azumuta sendet

Azumuta fügt immer einen apiKey von einem Workspace Api Device sowie ereignisspezifische Felder bei:

Geltungsbereich	Typische Felder
Product orders	`identifier` (Nummer der Produktionsbestellung) und, falls zutreffend, `workinstructionId` und `recordingId`
Issues	`issueId`, `issueNumber` (und für einige Ereignisse zugehörige Spalten-/Akionsfelder)
Audits	`recordingId`, `workinstructionId` und zugehörige Audit-Felder wie `auditNumber`

Wie diese Felder geliefert 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 im JSON-Body unter dem Schlüssel payload verschachtelt (neben apiKey und den oben genannten Ereignisfeldern).

Ihr empfangendes System kann den mitgesendeten apiKey verwenden, um bei Bedarf zusätzliche Daten über die Azumuta REST API abzurufen – ein übliches Muster mit einer Integrationsschicht vor einem ERP.