Webhooks: events naar externe systemen
Webhooks sturen automatisch berichten naar een externe URL bij specifieke events in Tesoro, nieuwe lead binnen, deal naar Won-status, woning Sold. Gebruikt voor integraties met Zapier, Make, eigen systemen.
Wanneer gebruikt u dit?
Section titled “Wanneer gebruikt u dit?”- Nieuwe lead via Zapier naar Slack-kanaal
- Deal Won-event naar uw boekhoudsysteem
- Externe analytics-tool real-time data laten ontvangen
Wat is een webhook?
Section titled “Wat is een webhook?”Bij elk geselecteerd event stuurt Tesoro een HTTP POST-request naar uw URL met JSON-payload. Uw systeem ontvangt, verwerkt, reageert (200 OK).
Een webhook aanmaken
Section titled “Een webhook aanmaken”- Settings → Webhooks → Add webhook.
- Vul in:
- Name: herkenbare naam
- URL: endpoint die de payload ontvangt (HTTPS aanbevolen)
- Events: selecteer welke events triggeren
- Secret (optioneel), voor request-validatie
- Save → webhook actief.
Beschikbare events
Section titled “Beschikbare events”| Categorie | Events |
|---|---|
| Lead | created, updated, status_changed, converted, deleted |
| Contact | created, updated, deleted, portal_user_created |
| Deal | created, status_changed, won, lost, deleted |
| Property | created, status_changed, sold, rented, deleted |
| Meeting | created, status_changed, completed |
| Activity | task_created, task_completed, note_created |
Selecteer minimaal 1, meerdere mogelijk.
Payload-formaat
Section titled “Payload-formaat”JSON-body bevat:
event: type (bv.lead.created)timestamp: wanneerdata: full record met alle veldenprevious_data(bij wijzigingen), vorige statuscompany_id: voor multi-tenant integraties
Authenticatie + veiligheid
Section titled “Authenticatie + veiligheid”Secret-validatie (aanbevolen): Tesoro signeert elke webhook met HMAC. Uw endpoint berekent dezelfde HMAC en valideert.
Zonder secret: elke POST kan vanuit elke bron komen. Niet aanbevolen voor productiesystemen.
Retry-gedrag
Section titled “Retry-gedrag”Webhook faalt (geen 200-response binnen X seconden, of network timeout)? Tesoro probeert opnieuw:
- 1 minuut later
- 5 minuten later
- 30 minuten later
- 2 uur later
- Daarna gemarkeerd als Failed, geen verdere pogingen
Failed webhooks zichtbaar in dashboard. Handmatig retry mogelijk.
Webhook-logs
Section titled “Webhook-logs”Per webhook ziet u laatste pogingen:
- Timestamp
- Event-type
- Response-status
- Aantal retries
- Body (in/uit)
Helpt bij debuggen.
Veelgemaakte fouten
Section titled “Veelgemaakte fouten”Geen events ontvangen
Section titled “Geen events ontvangen”Check:
- URL bereikbaar van internet?
- HTTPS-certificaat geldig?
- Endpoint stuurt 200-response binnen 5 sec?
- Events daadwerkelijk geselecteerd in webhook-config?
Dubbele events
Section titled “Dubbele events”Webhook-retry-gedrag, bij timing-issues krijgt u soms een retry van een al geslaagde delivery. Maak uw endpoint idempotent: dezelfde event-ID twee keer ontvangen → één keer verwerken.