⚠️ Opgelet:
Je kan deze functionaliteit niet zelf activeren. Als je het onderdeel "Webhooks" niet ziet onder Admin → Beheer → Instellingen, neem dan contact op met onze support via de chat .
ℹ️ Wat zijn webhooks?
Admins kunnen nu webhooks bekijken en beheren om derde partijen op de hoogte te stellen wanneer bepaalde gebeurtenissen in Strobbo plaatsvinden, zoals:
⏰ In- en uitklokken van werknemers
📄 Externe contracten
Derde partijen kunnen een URL instellen waarnaar wij informatie sturen over bepaalde events in real time, zodat zij hierop kunnen reageren zoals zij willen (bijvoorbeeld Dimona updaten bij in-/uitklokken).
⚙️ Hoe kan je de webhooks instellen?
Via Beheer → Instellingen → Webhooks
Klik op de groene "Toevoegen" knop rechtsboven in de tabel om een nieuwe webhook aan te maken.
Vul in de modal de volgende velden in:
📝 Naam, beschrijving:
Geef een aangepaste naam en beschrijving op voor de webhook.
🌐 Webhook URL:
Bepaal naar welke URL het event wordt gestuurd zodra een gebeurtenis is getriggerd. Dit moet een geldige HTTPS-URL zijn, inclusief het protocol (bijv.: https://).
👥 Gebruikersgroep:
Kies je een specifieke gebruikersgroep, dan ontvangt het endpoint alleen gebeurtenissen van die groep.
Laat je het leeg, dan geldt de webhook voor alle gebruikersgroepen.
📊 Event types:
Stuur mij alles: Ontvang alle gebeurtenissen.
Laat me individuele events selecteren: Selecteer specifieke categorieën van gebeurtenissen waarop de webhook moet reageren.
⏰ Eventgroep: klokkenDeze eventgroep omvat alle gebeurtenissen die te maken hebben met in- en uitklokken van medewerkers. De specifieke events in deze groep zijn:
Werknemer klokt in
Werknemer klokt uit
Werknemer annuleert klok-in
📄 Eventgroep: externe contracten
Deze eventgroep omvat alle gebeurtenissen die te maken hebben met contractacties. De specifieke events in deze groep zijn:
Externe contracten klaar
🛠️ Aangepaste headers:
Standaard is dit gedeelte ingeklapt in het formulier.
Hier kan je definiëren welke request-headers aan elke webhook-aanvraag moeten worden toegevoegd.
✏️ Webhook bewerken
Door op de bewerkknop (potlood) te klikken, opent dezelfde modal die ook wordt gebruikt bij het aanmaken van een webhook.
Zo kan je de details van een webhook achteraf aanpassen.
🕒 Webhook geschiedenis bekijken
Klikken op deze geschiedenis-knop (klokje), dat je vindt achter de meer acties knop, toont een overzicht van alle berichten die naar het endpoint zijn gestuurd.
Bovenaan de tabel vind je een datumfilter om de geschiedenis te beperken.
Klik op de 🔄 vernieuw-knop om de tabel bij te werken met de laatste entries in de geschiedenis.
▶️⏹️ Webhooks activeren, deactiveren en verwijderen
Deactiveren: Klik op het stop-symbool (rode stop) om een webhook tijdelijk uit te schakelen.
Activeren: Klik op de groene pijl om een webhook weer in te schakelen.
Verwijderen: Klik op het prullenbak-icoon 🗑️ om een webhook permanent te verwijderen.