Een webhook aanroepen vanuit een trigger

Opmerking: Dit is een technisch artikel. Daarom raden wij aan uw IT‑afdeling erbij te betrekken bij het lezen hiervan. Mocht u vragen of verzoeken hebben, 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 wanneer een productorder is voltooid of een issue is gemeld), heeft u een webhook trigger de voorkeur boven periodiek polleren van de REST API. Webhooks wisselen alleen de noodzakelijke gegevens uit op het moment dat de gebeurtenis plaatsvindt. Voor het bredere ERP-integratiepatroon, zie ERP Integration.

Dit artikel legt uit hoe u een Webhook aanroepen-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 heeft minimaal één Api Device geconfigureerd nodig. Als er geen bestaat, faalt de webhook met een foutmelding zoals No api device configured.

Zie How to Create and Manage API Keys voor instructies over het instellen van een Api Device, en Azumuta’s REST API voor hoe die sleutel wordt gebruikt bij het aanroepen van Azumuta.

Hoe een Webhook-trigger toe te voegen

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 “Webhook aanroepen”.
• Wanneer: Selecteer de gebeurtenis die de trigger moet activeren (bijvoorbeeld wanneer een productorder is voltooid of wanneer een issue wordt gemeld). Beschikbare gebeurtenissen hangen af van de reikwijdte.
• Reikwijdte: Kies waarop de trigger van toepassing is — bijvoorbeeld een artikelcategorie, alle productorders, issues, audits of een board. Beschikbare gebeurtenissen hangen af van de reikwijdte. 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 servers van Azumuta.
• Method: Keuzerondjes voor GET of POST. De standaardwaarde is GET.
• Payload: Alleen zichtbaar wanneer de methode POST is geselecteerd. Voer hier de aangepaste body-inhoud in. De UI-opmerking luidt: “U kunt parameters in dit veld gebruiken.”

Wat Azumuta verzendt

Azumuta voegt altijd een apiKey toe van een workspace Api Device, plus gebeurtenisspecifieke velden:

Reikwijdte	Typische velden
Productorders	identifier (productordernummer), en indien van toepassing workinstructionId en recordingId
Issues	issueId, issueNumber (en voor sommige gebeurtenissen 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 verzonden als JSON in de request-body. Als u een aangepaste Payload heeft geconfigureerd, wordt die inhoud genest onder de sleutel payload in de JSON-body (naast apiKey en de bovengenoemde gebeurtenisvelden).

Uw ontvangende systeem kan de meegeleverde apiKey gebruiken om de Azumuta REST API aan te roepen voor aanvullende gegevens indien nodig — een veelvoorkomend patroon met een integratielaag voor een ERP.

Gerelateerde artikelen

• What Is a Trigger?
• How to Edit an Delete a Trigger
• How to Create and Manage API Keys
• Azumuta’s REST API
• ERP Integration

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