Een webhook aanroepen vanuit een trigger

Opmerking: Dit is een technisch zeer gespecialiseerd artikel. Daarom raden wij u aan uw IT‑afdeling te betrekken bij het lezen hiervan. Als u vragen of verzoeken heeft, neem dan contact met ons op via support@azumuta.com — we helpen u graag.

Wanneer Azumuta een ander systeem moet informeren dat er iets is gebeurd (bijvoorbeeld dat een productorder is voltooid of dat een issue is gemeld), heeft een webhook trigger de voorkeur boven periodiek pollen van de REST API. Webhooks wisselen alleen de noodzakelijke gegevens uit op het moment dat het event plaatsvindt. Voor het bredere ERP-integratiepatroon, zie ERP Integration.

Dit artikel legt uit hoe u een Call a webhook trigger configureert: waar u deze instelt, welke attributen u invult, en wat Azumuta naar uw endpoint stuurt.

Vereisten

Webhook-triggers bevatten een apiKey afkomstig van een Api Device in uw workspace. U moet minstens één Api Device geconfigureerd hebben. Als er geen bestaat, faalt de webhook met een foutmelding zoals No api device configured.

Zie Create and manage API keys voor hoe u een Api Device instelt, en Azumuta’s REST API voor hoe die sleutel wordt gebruikt bij het aanroepen van Azumuta.

Een webhook-trigger toevoegen

1. Klik op Instellingen onder Beheer.
2. Klik op Triggers onder Integraties.
3. Klik op Trigger toevoegen (de gele plusknop).
4. Vul de hieronder beschreven velden in.
5. Als u klaar bent, klik op Toevoegen.

Wat, Wanneer en Reikwijdte

• Wat: Selecteer Call a webhook.
• Wanneer: Selecteer het event dat de trigger moet activeren (bijvoorbeeld wanneer een productorder is voltooid, of wanneer een issue is gemeld). Beschikbare events hangen af van de scope.
• Scope: Kies waarvoor de trigger geldt — bijvoorbeeld een artikelcategorie, alle productorders, issues, audits, of een board. Beschikbare events hangen af van de scope. Zie:
  • Triggers for Article Categories and Product Orders
  • Triggers for Continuous Improvement Issues and Approval Requests
  • Triggers for Improvement Boards and Approval Boards

U kunt de trigger later bewerken of verwijderen, en de gebruiksgeschiedenis bekijken.

Attributen

Nadat u Wat en Wanneer heeft geselecteerd, toont de sectie Attributen de webhook-opties:

• Endpoint: De HTTPS-URL die Azumuta zal aanroepen (placeholder begint met https://). Dit endpoint moet bereikbaar zijn vanaf de Azumuta-servers.
• Method: Radioknoppen voor GET of POST. Standaard is GET.
• Payload: Alleen zichtbaar wanneer de methode POST is. Voer hier de aangepaste body-inhoud in. De UI-opmerking luidt: “U kunt parameters in dit veld gebruiken.”

Wat Azumuta verzendt

Azumuta stuurt altijd een apiKey van een Api Device uit de workspace mee, plus event-specifieke velden:

Scope	Typische velden
Productorders	identifier (productordernummer), en indien van toepassing workinstructionId en recordingId
Issues	issueId, issueNumber (en voor sommige events gerelateerde kolom-/actievelden)
Audits	recordingId, workinstructionId, en gerelateerde auditvelden zoals auditNumber

Hoe die velden worden geleverd hangt af van de methode:

• GET: Velden worden toegevoegd als URL-queryparameters.
• POST: Velden worden als JSON in de requestbody gestuurd. Als u een aangepaste Payload heeft geconfigureerd, wordt die inhoud ingesloten onder de sleutel payload in de JSON-body (naast apiKey en de hierboven genoemde eventvelden).

Uw ontvangende systeem kan de meegeleverde apiKey gebruiken om de Azumuta’s REST API aan te roepen voor aanvullende gegevens indien nodig — een gangbaar patroon met een integratielaag vóór een ERP.

Gerelateerde artikelen

• What Is a Trigger?
• Edit and delete a trigger
• Create and manage API keys
• Azumuta’s REST API
• ERP Integration

Opmerking: Het What’s New-artikel Configurable JSON Body When Using Webhooks maakte historisch de POST-payloadfunctie bekend. Deze pagina is de huidige how-to voor het configureren van webhook-triggers.