Webhooks

Webhooks zijn automatische meldingen die Tesoro CRM naar andere systemen stuurt wanneer er iets verandert. Denk aan een digitale boodschapper: zodra u bijvoorbeeld een nieuwe woning toevoegt of een contactpersoon bijwerkt, stuurt Tesoro direct een bericht naar het systeem van uw keuze. Dat ontvangende systeem kan vervolgens actie ondernemen — zonder dat u zelf iets hoeft te doen.

In tegenstelling tot de Open API, waarbij een extern systeem steeds opnieuw moet vragen of er iets veranderd is, stuurt een webhook het bericht op het moment dat de wijziging plaatsvindt. Dat maakt webhooks sneller en efficiënter.

Wanneer webhooks gebruiken

Webhooks zijn nuttig wanneer u Tesoro CRM wilt koppelen aan externe systemen. Enkele praktische voorbeelden:

Uw website — Wanneer u een woning toevoegt of de prijs wijzigt, wordt uw website automatisch bijgewerkt.
Boekhoudsoftware — Bij het aanmaken van een nieuwe deal kan automatisch een factuur of dossier worden aangemaakt.
E-mailmarketingplatform — Nieuwe contacten in Tesoro worden direct doorgestuurd naar uw mailinglijst.
Interne rapportage — Registreer automatisch alle wijzigingen in een extern dashboard of spreadsheet.
Zapier, Make of n8n — Koppel Tesoro aan honderden andere applicaties via een automatiseringsplatform.

Een webhook aanmaken

Klik op uw profielicoon rechtsboven en ga naar Settings.
Navigeer naar Webhooks in het instellingenmenu.
Klik op de knop Add Webhook rechtsboven.
Een zijpaneel opent zich. Vul de volgende gegevens in:
- Name — Geef de webhook een herkenbare naam (bijvoorbeeld “Website sync” of “Boekhoud-koppeling”).
- Payload URL — Vul de URL in waarnaar Tesoro de meldingen moet sturen. Dit is het adres dat u van uw IT-partner of het ontvangende systeem heeft ontvangen. De URL moet beginnen met https://.
- Content Type — Kies het formaat waarin de gegevens worden verzonden. Standaard is dit application/json. Wijzig dit alleen als uw IT-partner een ander formaat aangeeft.
- Status — Bepaal of de webhook direct actief moet zijn (Active) of later handmatig ingeschakeld wordt (Inactive).
Selecteer vervolgens de Scopes (gebeurtenissen) waarvoor u meldingen wilt ontvangen. U kunt per resourcetype aanvinken welke acties een melding moeten triggeren. Zie de tabel hieronder voor alle beschikbare events.
Klik op Save om de webhook aan te maken.
Na het aanmaken wordt eenmalig een Secret getoond. Dit is een beveiligingssleutel waarmee het ontvangende systeem kan verifiëren dat de melding daadwerkelijk van Tesoro afkomstig is. Kopieer deze sleutel direct en bewaar deze op een veilige plek — de sleutel wordt slechts eenmaal getoond en kan daarna niet meer worden opgevraagd.

Beschikbare events

Webhooks worden getriggerd door specifieke gebeurtenissen in het CRM. U selecteert zelf welke events u wilt ontvangen. De events zijn gegroepeerd per resourcetype:

Contact

Event	Beschrijving
Created	Een nieuw contact wordt aangemaakt
Updated	Een bestaand contact wordt gewijzigd
Deleted	Een contact wordt verwijderd

Deal

Event	Beschrijving
Created	Een nieuwe deal wordt aangemaakt
Updated	Een bestaande deal wordt gewijzigd
Deleted	Een deal wordt verwijderd

Property

Event	Beschrijving
Created	Een nieuwe woning wordt aangemaakt
Updated	Een bestaande woning wordt gewijzigd
Deleted	Een woning wordt verwijderd

Relation

Event	Beschrijving
Created	Een nieuwe relatie wordt aangemaakt
Updated	Een bestaande relatie wordt gewijzigd
Deleted	Een relatie wordt verwijderd

Een webhook bewerken

Ga naar Settings > Webhooks.
Klik op de rij van de webhook die u wilt bewerken. Het zijpaneel opent zich met de huidige instellingen.
Pas de gewenste velden aan — naam, URL, content type, status of scopes.
Klik op Save om de wijzigingen op te slaan.

Een webhook in- of uitschakelen

U kunt een webhook tijdelijk uitschakelen zonder deze te verwijderen. Dit is handig wanneer het ontvangende systeem in onderhoud is.

Gebruik de schakelknop (toggle) in de kolom Status in het overzicht om de webhook direct te activeren of te deactiveren.
U kunt de status ook wijzigen via het bewerkingspaneel door het Status-veld aan te passen naar Active of Inactive.

Secret opnieuw genereren

Als u de beveiligingssleutel bent kwijtgeraakt of als deze gecompromitteerd is, kunt u een nieuwe genereren:

Ga naar Settings > Webhooks en klik op de webhook.
In het zijpaneel ziet u de sectie Secret met een veld dat de huidige sleutel verborgen toont.
Klik op Regenerate. Er verschijnt een bevestigingsvenster omdat deze actie niet ongedaan kan worden gemaakt.
Bevestig de actie. De nieuwe sleutel wordt eenmalig getoond — kopieer deze direct.
Werk het ontvangende systeem bij met de nieuwe sleutel. De oude sleutel werkt niet meer.

Een webhook verwijderen

Ga naar Settings > Webhooks.
Klik op de knop Delete rechts van de webhook die u wilt verwijderen.
Bevestig de verwijdering in het bevestigingsvenster.

Hoe webhooks technisch werken

Wanneer een gebeurtenis plaatsvindt in Tesoro CRM (bijvoorbeeld het aanmaken van een woning), doorloopt het systeem de volgende stappen:

Event detectie — Het systeem detecteert dat er een wijziging heeft plaatsgevonden op een resource (contact, deal, woning of relatie).
Webhook matching — Het systeem controleert welke actieve webhooks zijn geabonneerd op dit type event.
Payload opbouw — De volledige gegevens van de gewijzigde resource worden verzameld en in het gekozen formaat verpakt. Bij een update-event worden ook de vorige gegevens meegestuurd, zodat het ontvangende systeem kan zien wat er precies is gewijzigd.
Aflevering — Tesoro verstuurt een HTTP POST-verzoek naar de geconfigureerde URL met de gegevens en een beveiligingshandtekening.
Handtekeningverificatie — Elk verzoek bevat een X-Webhook-Signature header met een HMAC-SHA256 handtekening. Het ontvangende systeem kan hiermee verifiëren dat het bericht daadwerkelijk van Tesoro afkomstig is.

Retry-mechanisme

Als de aflevering mislukt (bijvoorbeeld door een serverstoring bij het ontvangende systeem), probeert Tesoro het automatisch opnieuw:

Poging	Wachttijd	Wanneer
1e poging	Direct	Eerste aflevering
2e poging	1 minuut	Na een serverfout (5xx) of verbindingsprobleem
3e poging	5 minuten	Na herhaalde serverfout of verbindingsprobleem

Meegestuurde headers

Bij elke webhook-aflevering stuurt Tesoro de volgende HTTP-headers mee:

Header	Beschrijving
`Content-Type`	Het gekozen formaat (`application/json` of `application/x-www-form-urlencoded`)
`X-Webhook-Signature`	HMAC-SHA256 handtekening voor verificatie
`X-Webhook-Event`	Het type event (bijv. `contact.created`)
`X-Webhook-Resource`	Het resourcetype (bijv. `contact`)
`User-Agent`	`TesoroCRM-Webhook/1.0`

Afleveringslogboek

Elke afleveringspoging wordt automatisch gelogd. Deze logboeken worden na 7 dagen automatisch verwijderd.

Testen

Wilt u verifiëren dat uw webhook correct werkt? Volg deze stappen:

Gebruik een testservice — Maak een tijdelijke test-URL aan via een gratis dienst zoals webhook.site of requestbin.com. Deze services tonen alle binnenkomende verzoeken.
Maak een testwebhook aan — Ga naar Settings > Webhooks, maak een nieuwe webhook aan met de test-URL en selecteer de gewenste events.
Trigger een event — Voer een actie uit in het CRM die overeenkomt met een geselecteerd event. Maak bijvoorbeeld een testcontact aan als u het event Contact Created heeft geselecteerd.
Controleer het resultaat — Ga naar de testservice en controleer of het verzoek is binnengekomen. U zou de volledige payload moeten zien met de gegevens van het aangemaakte contact.
Verwijder de testwebhook — Vergeet niet om de testwebhook te verwijderen wanneer u klaar bent met testen.

Veelgestelde vragen

Wat is een webhook precies? Een webhook is een automatisch bericht dat Tesoro naar een extern systeem stuurt wanneer er iets verandert. Het ontvangende systeem kan dat bericht gebruiken om automatisch actie te ondernemen.

Hoeveel webhooks kan ik aanmaken? Er is geen vaste limiet op het aantal webhooks. U kunt meerdere webhooks aanmaken met verschillende URLs en events, afhankelijk van uw behoeften.

Wat gebeurt er als het ontvangende systeem tijdelijk niet bereikbaar is? Tesoro probeert de aflevering maximaal 3 keer: direct, na 1 minuut en na 5 minuten. Als alle pogingen mislukken, wordt de melding niet meer herhaald. Het ontvangende systeem mist dan deze gebeurtenis.

Kan ik zien of een webhook succesvol is afgeleverd? Alle afleveringspogingen worden intern gelogd. Deze logboeken worden na 7 dagen automatisch verwijderd.

Wat is de Secret en waarom is deze belangrijk? De secret is een beveiligingssleutel waarmee het ontvangende systeem kan controleren of een bericht echt van Tesoro afkomstig is. Zonder deze verificatie zou een kwaadwillende partij valse berichten kunnen sturen naar uw systeem.

Ik ben mijn secret kwijtgeraakt. Wat nu? U kunt een nieuwe secret genereren via de Regenerate-knop in het bewerkingspaneel van de webhook. Vergeet niet om het ontvangende systeem bij te werken met de nieuwe sleutel.

Welke gegevens worden er precies verstuurd? De webhook-payload bevat het type event, het resourcetype, het ID van de resource, een tijdstempel en de volledige gegevens van de betreffende resource (contact, deal, woning of relatie). Bij update-events worden ook de vorige gegevens meegestuurd.

Worden webhooks ook getriggerd bij bulk-imports? Ja. Webhooks worden getriggerd bij elke individuele aanmaak- of wijzigingsactie, ook wanneer deze onderdeel is van een grotere import.

Gerelateerde artikelen

API-integraties Configureer API-koppelingen met externe systemen.

XML-import Importeer woningen vanuit externe bronnen.

Feed-export Exporteer woningen naar vastgoedportalen.