webhooks voor makelaars kunnen bijvoorbeeld melden dat een object is gepubliceerd, een prijs is gewijzigd of een lead is ontvangen. Het ontvangende systeem krijgt een bericht en verwerkt daarna de relevante informatie.
De snelheid is aantrekkelijk, maar een webhook is geen garantie dat ieder bericht precies één keer aankomt. Een robuuste verwerking houdt rekening met vertraging, dubbele levering en tijdelijke uitval.
Kies gebeurtenissen die een duidelijke vervolgactie hebben
Niet iedere kleine wijziging hoeft direct een webhook te veroorzaken. Selecteer gebeurtenissen die een ander systeem werkelijk moet verwerken, zoals statuswijziging, nieuwe media of een nieuwe aanvraag.
Geef ieder bericht een uniek gebeurtenisnummer en tijdstip. Daarmee kan de ontvanger vaststellen of een melding al is afgehandeld.
Beveilig de afzender en de inhoud
Controleer of een bericht echt van de verwachte leverancier komt, bijvoorbeeld met een digitale handtekening of gedeeld geheim. Gebruik versleutelde verbindingen en beperk de hoeveelheid persoonsgegevens in de payload.
Log geen volledige verzoeken wanneer daar gevoelige contactgegevens in staan. Bewaar technisch noodzakelijke informatie gescheiden van inhoudelijke klantdata.
- Beantwoord ontvangen berichten snel en verwerk ze daarna asynchroon.
- Voorkom dubbele acties met idempotente verwerking.
- Stel een wachtrij in voor pieken en tijdelijke fouten.
- Monitor het aantal mislukte en vertraagde gebeurtenissen.
Plan herstel wanneer een endpoint niet bereikbaar is
De verzender moet berichten opnieuw kunnen aanbieden wanneer het ontvangende systeem tijdelijk uitvalt. Spreek het aantal pogingen en de tijdsintervallen af, zodat storingen niet leiden tot een plotselinge berichtenstorm.
Bied daarnaast een manier om gemiste wijzigingen opnieuw op te vragen via een API of export. Alleen vertrouwen op een vluchtige melding maakt gegevensherstel kwetsbaar.
Veelgestelde vragen
Wat is het verschil tussen een webhook en een API?
Een webhook duwt een melding naar de ontvanger; via een API vraagt een systeem gegevens op of wijzigt die. Vaak worden beide samen gebruikt.
Kunnen webhooks woningfeeds vervangen?
Voor sommige processen wel, maar grote mediabestanden of volledige periodieke controles vragen vaak nog een aanvullende API of feed.
Gebruik snelheid zonder betrouwbaarheid op te geven
Webhooks maken vastgoedprocessen responsiever wanneer gebeurtenissen goed zijn gekozen en verwerking bestand is tegen dubbele of gemiste berichten. Ontwerp daarom altijd een controle- en herstelroute.