Je kunt met een webhook gebeurtenissen laten doorgeven voor klanten, verkoop- en aankoopfacturen, offertes, afrekeningen, projecten, artikelen, medewerkers, planning, werkbonnen, materialen, installaties, documenten, opmerkingen, verkooporders en formulierantwoorden.
Per onderwerp zijn er meestal een created- en een updated-gebeurtenis. Bij offertes en afrekeningen zijn er ook recalculated-gebeurtenissen, en bij artikelen een stock-changed-gebeurtenis.
Endpoint registreren
Een webhook-endpoint registreer je via een POST op /api/v2/webhook-endpoints met description, events en url. Dit kan alleen een admin via de API; er is geen scherm voor. Bewaar het secret dat je terugkrijgt, want je hebt het nodig om de Robaws-Signature-header te controleren.
Gebeurtenissen geef je exact op, zonder jokertekens. Een typfout na de punt wordt niet geweigerd, maar die gebeurtenis komt dan nooit door. Je ontvangt de id, de naam van de gebeurtenis en de volledige data. Het endpoint moet binnen 2 seconden met een 2XX antwoorden, anders probeert Robaws het opnieuw. Blijft een endpoint falen, dan wordt het opgeschort en krijgen alle admins een melding.
Zo doe je het
- Registreer het endpoint via een POST op
/api/v2/webhook-endpointsmetdescription,eventsenurl, als admin. - Bewaar het secret dat je terugkrijgt.
- Kies de gebeurtenissen die je nodig hebt, exact zoals ze in de lijst staan.