Met webhooks verwittigt de ene applicatie de andere zodra er iets gebeurt, in plaats van te wachten tot die zelf komt kijken. Voor Belgische kmo's en integratoren houdt een webhook-koppeling uw CRM, ERP of facturatietool gesynchroniseerd zodra informatie wijzigt, bijvoorbeeld de status van een onderneming in de KBO. Hieronder leest u hoe dat werkt.
Zo werkt een webhook-koppeling
Het principe is eenvoudig: u abonneert zich op gebeurtenissen en de aanbieder stuurt telkens een POST-request naar uw URL. Bij polling moet uw systeem de API daarentegen op vaste tijdstippen bevragen, vaak voor niets. Webhooks verminderen dus het aantal oproepen en sparen uw quota. Ze verkorten ook de tijd tussen wijziging en verwerking. De gebeurtenis company.status_changed kan bijvoorbeeld automatisch de klantfiche in uw CRM bijwerken. Uw team hoeft dus geen geplande scripts meer te onderhouden die voortdurend naar wijzigingen zoeken.
Elk bericht bevat het type gebeurtenis en de nuttige gegevens, meestal in JSON. Ernstige aanbieders ondertekenen hun berichten bovendien, bijvoorbeeld met HMAC SHA-256 en een gedeeld geheim, zodat u de herkomst kunt controleren. Uw webhook-koppeling leest daarna de inhoud, controleert de handtekening en start de voorziene actie: klantfiches bijwerken, verkopers verwittigen of facturen blokkeren. Die lus vormt de kern van elke webhook-koppeling.
Best practices voor een betrouwbare webhook-koppeling
Controleer eerst altijd de handtekening voordat u berichten verwerkt, en stel uw URL enkel via HTTPS open. Antwoord daarna snel met statuscode 2xx en verwerk de inhoud op de achtergrond, want trage verwerking leidt tot onnodige nieuwe verzendingen. Zorg daarnaast voor idempotentie: dezelfde gebeurtenis kan na nieuwe pogingen twee keer binnenkomen. Log tot slot elke ontvangst, zodat uw webhook-koppeling bij incidenten makkelijk te analyseren blijft. Houd die verwerkingscode klein en goed testbaar.
Bekijk aan de kant van de aanbieder het beleid voor nieuwe pogingen. Goede diensten proberen opnieuw met oplopende wachttijden, bijvoorbeeld tot 24 uur, en bieden een beheerpagina om gebeurtenissen handmatig opnieuw af te spelen. Bewaar uw geheim veilig en vervang het bij het minste vermoeden van lekken. Test uw webhook-koppeling ten slotte in een testomgeving vóór de livegang. Goede documentatie maakt latere aanpassingen voor uw team bovendien eenvoudiger. Spreek ook af wie intern alarmen opvolgt wanneer berichten blijven mislukken.
Ons artikel over webhook-koppeling en wanneer u ons inschakelt
Ons artikel over de API v2 voor Belgische bedrijfsdata stelt de beschikbare realtime gebeurtenissen voor: company.updated, company.status_changed, company.filing_deposited, establishment.created en establishment.closed. Het beschrijft ook de handtekening via de header X-Espero-Signature en de exponentiële nieuwe pogingen. U vindt er daarnaast de NACE-referentiedata, de validatie van btw-nummers en de score voor betalingsrisico. Het richt zich tot developers, ERP-integratoren en datateams die geen eigen connector meer willen schrijven. Zo beschikt u meteen over concrete voorbeelden.
Schakel een professional in als u die gebeurtenissen wilt doorsturen naar uw ERP, CRM of datawarehouse zonder zelf KBO-connectoren te schrijven. Het team van Espero-Soft bouwt uw webhook-koppeling of webplatform op maat, met degelijk beheer van fouten, nieuwe pogingen en beveiliging. We helpen u ook om enkel de nuttige gebeurtenissen te kiezen, zodat het volume aan berichten beheersbaar blijft. Vraag ons gerust om advies vóór u aan de bouw begint.
