Lees hier hoe je een webhook instelt zodat een ander systeem automatisch een melding krijgt als een rit in YesHugo wijzigt.
Een webhook is een webadres van een ander systeem dat je in YesHugo registreert. Wijzigt een rit, dan stuurt YesHugo direct een bericht naar dat adres. Zo hoeft het andere systeem niet zelf te blijven vragen of er iets veranderd is. Handig voor bijvoorbeeld een salarisadministratie, een planningssysteem of een eigen koppeling.
Goed om te weten
- Je hebt de rol manager nodig. Bestuurders zien de koppelingsinstellingen niet.
- Je abonnement moet API-toegang bevatten. Zie je de melding Webhooks zijn uitgeschakeld voor deze omgeving, neem contact op met support om gebruik te kunnen maken van webhooks.? Neem dan contact met ons op.
- Een webhook stuurt alleen een bericht als een bestaande rit wijzigt: iemand past de rit aan, of YesHugo verwerkt de rit opnieuw en een veld verandert. Een nieuwe of verwijderde rit levert geen bericht op.
- Het bericht bevat alleen het rit-ID. Het andere systeem heeft ook een API-sleutel nodig om de ritgegevens op te halen. Zie API-sleutels beheren.
Een webhook toevoegen
- Ga naar Beheer > Koppelingen en zoek de kaart Webhooks.

- Klik op Webhook toevoegen.

- Vul het veld URL (https://) in met het webadres van het ontvangende systeem. Voeg optioneel een Omschrijving toe, bijvoorbeeld de naam van het systeem.
- Klik op Toevoegen.
- Het venster Ondertekeningsgeheim toont het geheim (begint met
whsec_). Klik op Geheim kopiëren en geef het door aan degene die het ontvangende systeem beheert.
Let op: Bewaar dit geheim nu. Na het sluiten van dit venster is het niet meer zichtbaar. Raak je het kwijt, genereer dan een nieuw geheim (zie hieronder).
- Klik op Klaar. De webhook is meteen actief.
Mogelijke foutmeldingen bij het toevoegen:
- Vul een URL in.: je hebt geen adres ingevuld.
- Vul een geldig https://-adres in, zonder inloggegevens in de URL.: het adres begint niet met
https://of bevat een gebruikersnaam of wachtwoord. - De URL mag maximaal 2048 karakters bevatten.
- Gebruik maximaal 255 karakters.: de omschrijving is te lang.
Pauzeren, geheim vernieuwen en verwijderen
- Pauzeren of hervatten: gebruik de schakelaar Actief op de rij van de webhook. Een gepauzeerde webhook ontvangt geen berichten voor wijzigingen die plaatsvinden terwijl hij uit staat, ook niet achteraf.
- Nieuw geheim genereren: open het menu Acties (⋮) van de webhook en kies Nieuw geheim genereren. Bevestig en kopieer het nieuwe geheim. Let op: het oude geheim werkt direct niet meer. Stuur eventueel mislukte berichten daarna opnieuw (zie hieronder).

- Adres wijzigen: een adres kan niet worden bewerkt. Voeg een nieuwe webhook toe met het nieuwe adres en verwijder daarna de oude.
- Verwijderen: open het menu Acties (⋮) en kies Verwijderen. Bevestig de melding. Er worden geen berichten meer verstuurd naar dit adres.

Bezorggeschiedenis bekijken en berichten opnieuw versturen
- Klik op Bezorgingen op de rij van de webhook.

- Je ziet een lijst met berichten: Aangemaakt, Gebeurtenis, Rit, Status, Pogingen en Volgende poging. Filter op In behandeling, Bezorgd of Mislukt.
- Klik op een bericht om de Bezorgpogingen te zien, inclusief tijdstip, of het Automatisch of Handmatig was, en het antwoord van het ontvangende systeem.

- Wil je een bericht opnieuw versturen? Klik op het bericht en kies Nu opnieuw versturen. Dit werkt ook voor berichten die al bezorgd zijn of van een gepauzeerde webhook.
Problemen oplossen
- De Webhooks-kaart zegt dat webhooks uitgeschakeld zijn. Je abonnement heeft geen API-toegang. Neem contact met ons op.
- Elk bericht mislukt. Het ontvangende systeem wijst het bericht af, waarschijnlijk omdat het een oud of verkeerd geheim gebruikt. Genereer een nieuw geheim, zet het in het ontvangende systeem en stuur de mislukte berichten opnieuw.
- We krijgen geen bericht voor een nieuwe rit. Dat klopt: webhooks worden alleen verstuurd bij wijzigingen. Een nieuwe rit wordt kort na verwerking gewijzigd (en dan verstuurd), dus het bericht volgt normaal binnen enkele minuten.
Was dit artikel nuttig?
Dat is fantastisch!
Hartelijk dank voor uw beoordeling
Sorry dat we u niet konden helpen
Hartelijk dank voor uw beoordeling
Feedback verzonden
We stellen uw moeite op prijs en zullen proberen het artikel te verbeteren