Wat is een webhook?
Een webhook is een manier om automatisch gegevens tussen verschillende applicaties of systemen uit te wisselen. Webhooks worden vaak gebruikt voor integraties tussen verschillende webtoepassingen. Ze bieden een eenvoudige, efficiënte en betrouwbare manier om gegevens te delen tussen systemen.
We gaan hier m.a.w. informatie m.b.t. afwezigheden vanuit Officient doorsturen naar IAMD als er bepaalde acties uitgevoerd worden. Zoals bv. het toevoegen van een afwezigheid.
Webhooks instellen bij Officient
Surf naar https://www.officient.io/
Log in bij Officiënt (als werkgever)
Ga rechts bovenaan via het tandwieltje naar de instellingen
Ga onder de rubriek 'Geavanceerde instellingen' naar 'Webhooks'
Ik zie geen 'Webhooks' onder integraties?
Zie je de optie 'Webhooks' niet onder de geavanceerde instellingen, dan heb je onvoldoende rechten. Enkel gebruikers met Admin rechten zien deze optie. Login in met een gebruiker die voldoende rechten heeft, of vraag aan een gebruiker met Admin rechten om jou ook de juiste rechten toe te kennen.
Je komt op het overzicht van de webhooks terecht.
Druk vervolgens op de knop ' + Voeg een nieuwe webhook toe'
Er moet voor 3 events een webhook ingesteld worden, nl.
Webhook url | Type event |
https://api- | Afwezigheden toegevoegd |
https://api- | Afwezigheden verwijderd |
https://api- | Status van afwezigheidsdagen geüpdatet |
Deze webhooks zorgen voor de communicatie tussen Officiënt en IAMD.
Koppeling testen
Voeg na het instellen van je webhooks een afwezigheid toe in de kalender van Officiënt en kijk of deze informatie doorstroomt tot in IAMD via Instellingen > Mijn afwezigheden. Deze info komt quasi onmiddellijk door.
Personen matchen met gebruikers
De namen van de personen in Officiënt moeten matchen met de namen van de gebruikers in IAMD. Op basis daarvan worden de afwezigheden toegevoegd op de juiste persoon (niet op basis van e-mailadres, dat mag verschillen!).
Als je merk dat afwezigheden niet doorkomen voor een bepaalde persoon, check dan ook zeker of voor- en achternaam van deze persoon matchen met Officiënt.