Webhooks

Webhooks stellen Shifton in staat om realtimemeldingen naar externe systemen te sturen wanneer er gebeurtenissen plaatsvinden in uw bedrijf.

Stapsgewijze instructies

Toegang tot het tabblad Webhooks

Klik in het linkerzijpaneel op Integraties.

Ga naar de pagina Ontwikkelaar → tabblad Webhooks.

Een nieuwe webhook aanmaken

Klik op “Nieuwe webhook”.

Vul de configuratie in:

Veld	Beschrijving
URL	Eindpunt voor het ontvangen van gebeurtenisgegevens
Gebeurtenissen	Shifton-gebeurtenissen die de webhook activeren
Actief	Schakelaar voor in-/uitschakelen

Sla op. Shifton stuurt HTTP POST-verzoeken naar de opgegeven URL.

Webhooks beheren

Klik op een webhook om de URL te bewerken, gebeurtenissen bij te werken of de activiteitsstatus te wijzigen.

Een webhook testen

Activeer de betreffende gebeurtenis in Shifton (maak bijvoorbeeld een testdienst aan).

Controleer uw serverlogs — de gegevens zouden moeten binnenkomen.

Veelgestelde vragen

V: In welk Vormenaat stuurt ploegEindeienston gegevens?
HTTP POST met een body in JSON-formaat. Zie de API-documentatie voor de gegevensstructuur per gebeurtenistype.

V: Kan ik meerdere webhooks voor dezelfde gebeurtenis aanmaken?
Ja, met verschillende URL’s.

V: Wat als de server niet bereikbaar is wanneer de webhook wordt geActieferd?
De levering kan mislukken. Zie de API-documentatie voor details over het beleid voor herhaalpogingen.

V: De webhook wordt niet geActieferd — waarom?
Controleer of de schakelaar Actief is ingeschakeld en de URL publiek toegankelijk is.

V: Hoe controleer ik of de webhook gegevens ontvangt?
Maak een testgebeurtenis aan in Shifton (voeg bijvoorbeeld een dienst toe) en controleer uw serverlogs op het binnenkomende POST-verzoek.

V: Kan ik authenticatie voor de webhook instellen?
Ja. Voeg een geheime sleutel of token toe aan de URL of headers van de webhook. Zie de API-documentatie voor details.

V: Hoe ziet de body van een webhook-verzoek eruit?
Een JSON-object met gebeurtenisgegevens. De structuur is afhankelijk van het type gebeurtenis — zie de API-documentatie voor voorbeelden.

V: Kan een enkele webhook meerdere gebeurtenissen volgen?
Ja. Selecteer bij het aanmaken van de webhook meerdere gebeurtenissen — een URL ontvangt meldingen voor alle geselecteerde gebeurtenissen.

V: Wat is het “beleid voor herhaalpogingen” voor webhooks?
Als de server een fout retourneert (niet 200), kan Shifton het verzoek opnieuw proberen. Details zijn afhankelijk van de platformconfiguratie.

V: Is er een limiet op het aantal webhooks?
Er is geen limiet vermeld in de documentatie, maar het wordt aanbevolen alleen de noodzakelijke aan te maken.

V: Moet ik HTTPS gebruiken voor de webhook-URL?
Aanbevolen. HTTP-adressen kunnen werken, maar HTTPS zorgt voor veilige gegevensoverdracht.

V: Kan ik webhookmeldingen ontvangen bij elke roosterwijziging?
Ja. Voeg gebeurtenissen toe zoals “Dienst aangemaakt” of “schedule updated” bij het configureren van de webhook.

V: Wie heeft toegang tot het aanmaken van webhooks?
Alleen Owner en Beheerder. Managers en Medewerkers zien het gedeelte Developer niet.

V: Kan ik een webhook uitschakelen zonder deze te verwijderen?
Ja. Schakel de schakelaar Actief uit in de webhookinstellingen — deze stopt met activeren maar behoudt de configuratie.

V: Worden webhookActieVrijngen gelogd in ploegEindeienston?
Gedetailleerde leveringslogs voor webhooks worden niet in de interface aangeboden. Tracking vindt plaats aan de kant van uw server.

V: Kan ik een webhook filteren op project of rooster?
Nee. De webhook wordt geactiveerd voor alle gebeurtenissen van het geselecteerde type in het hele bedrijf. Filtering vindt plaats aan de kant van de ontvangende server.

V: Wat gebeurt er met webhooks bij het verwijderen van het bedrijf?
Alle webhooks worden samen met het bedrijf verwijderd.