Webhooks

Gebruik webhooks wanneer je Reonic-gebeurtenissen wilt doorsturen naar een zelfgebouwd systeem, een BI-pipeline of een ander endpoint dat een ondertekend verzoek kan ontvangen. Reonic biedt twee opties: een eenvoudige webhook die bij elke nieuwe aanvraag wordt verzonden, en een webhook met gebeurtenisabonnementen waarmee je je abonneert op een reeks gebeurtenissen rond projecten, aanbiedingen, checklists, contacten, taken, bestanden, notities en afspraken, met ondertekende payloads en automatische herhaalpogingen. Voor no-code-automatiseringen en om gegevens op te halen wanneer je ze nodig hebt, zie je de handleidingen over Zapier en de REST API.

Voor wie dit artikel is

Admins die Reonic-gebeurtenissen koppelen aan hun eigen systeem, een BI-pipeline of een ander endpoint dat een ondertekend verzoek kan ontvangen.

Voordat je begint

• Je hebt admin-rechten nodig in je Reonic-Workspace.
• Een openbaar bereikbaar HTTPS-endpoint dat je zelf beheert, en de mogelijkheid om een ondertekend verzoek te verifiëren.
• De configuratie van webhooks staat onder Instellingen > API / Developers > Webhooks (ontwikkelaars), niet onder Instellingen > Bedrijfsinstellingen > Integraties.

De aanvraag-webhook configureren

De aanvraag-webhook verzendt één keer een bericht, wanneer er een nieuwe aanvraag wordt aangemaakt.

1. Open Instellingen > API / Developers > Webhooks.
2. Zoek de sectie Webhook on request (webhook bij een nieuwe aanvraag).
3. Zet de schakelaar aan.
4. Plak de URL van je HTTPS-endpoint in het veld URL.
5. Sla op. De configuratie is direct actief.
6. Kopieer het gedeelde geheim dat op de pagina wordt getoond en stel je endpoint zo in dat het inkomende verzoeken daarmee verifieert.

Reonic stuurt nu elke keer dat er een aanvraag wordt aangemaakt een bericht naar je URL.

Wat de aanvraag-payload bevat

Elke aanvraag-payload bevat de gegevens die een nieuwe lead heeft ingediend, waaronder:

• Contactgegevens: voornaam, achternaam, e-mail, telefoon en een notitie.
• Het adres: land, postcode, plaats, straat en huisnummer.
• De productpakketten die de klant heeft gekozen, als die er een heeft gekozen (zonne-energie, batterij, laadpaal, warmtepomp).
• Welke systemen de klant al heeft, voor zover van toepassing (bestaande zonnepanelen, warmtepomp, batterij, laadpaal of elektrisch voertuig).
• Een unieke aanvraag-ID en een deeplink die de aanvraag weer in het Portal opent.

Gebeurtenisabonnementen configureren

Kies voor gebeurtenisabonnementen wanneer je meer nodig hebt dan de gebeurtenis voor een aangemaakte aanvraag, of wanneer je ondertekende payloads met automatische herhaalpogingen wilt. Je registreert één HTTPS-endpoint, abonneert je op de gebeurtenissen die voor jou van belang zijn, en Reonic levert ondertekende JSON zodra er een plaatsvindt.

1. Open Instellingen > API / Developers > Webhooks en ga naar de sectie voor gebeurtenisabonnementen.
2. Voer de URL van je HTTPS-endpoint in. Die moet openbaar bereikbaar zijn.
3. Selecteer de gebeurtenistypes die je wilt ontvangen.
4. Sla op. Reonic genereert een ondertekeningsgeheim voor je abonnement.
5. Kopieer het ondertekeningsgeheim en gebruik het om de handtekening van elk inkomend bericht te verifiëren.
6. Gebruik Testgebeurtenis verzenden om een voorbeeldpayload naar je endpoint te sturen en te controleren dat die aankomt.

De gebeurtenissen waarop je je kunt abonneren, omvatten:

• Projecten: een residentieel of commercieel project wordt aangemaakt, wordt naar een andere kolom op het bord verplaatst, wijzigt van dealstatus of wordt gearchiveerd.
• Aanbodhandtekeningen: een handtekening voor een residentieel aanbod wordt aangevraagd, gezet of ingetrokken.
• Checklists: de voltooiing van een checklist-segment van een project verandert, of er wordt een checklist-pdf gegenereerd.
• Contacten: een contact wordt aangemaakt of bijgewerkt.
• Taken: een taak wordt aangemaakt, bijgewerkt, voltooid of heropend, of verwijderd.
• Bestanden: een bestand wordt aangemaakt, bijgewerkt of verwijderd.
• Notities: een notitie wordt aangemaakt, bijgewerkt of verwijderd.
• Afspraken: een afspraak wordt aangemaakt, bijgewerkt of verwijderd in een Reonic-agenda.

Hoe gebeurtenisabonnementen leveren en ondertekenen

• Lichte payloads. Elke gebeurtenispayload is een kleine envelop met ID's in plaats van volledige records. Ontvang je er een, haal dan de actuele status op via de Reonic REST API. De webhook vertelt je dát er iets is veranderd; de API vertelt je hoe het er nu uitziet.
• Ondertekende leveringen. Reonic ondertekent elke levering, en het bericht bevat het gebeurtenistype, een gebeurtenis-ID, een leverings-ID en een tijdstempel. De gebeurtenis-ID blijft gelijk bij herhaalpogingen van dezelfde gebeurtenis, zodat je die als idempotentiesleutel kunt gebruiken.
• Automatische herhaalpogingen. Mislukt een levering, dan probeert Reonic het in de dagen daarna automatisch nog een aantal keer. Mislukken alle pogingen, dan pauzeert Reonic het abonnement en stuurt het een e-mail naar je contactpersoon. Schakel het weer in zodra je endpoint weer goed werkt.

Het leveringslogboek

Gebeurtenisabonnementen houden een leveringslogboek bij dat je zelf kunt raadplegen, met de recente leveringen. Open een levering om het antwoord, de payload en een handmatige actie Opnieuw proberen te zien. Gebruik het om te controleren dat leveringen zijn aangekomen en om één gebeurtenis opnieuw af te spelen.

Goed om te weten

• De aanvraag-webhook wordt alleen verzonden wanneer een aanvraag wordt aangemaakt. Bij latere wijzigingen wordt hij niet verzonden. Gebruik gebeurtenisabonnementen voor meer gebeurtenistypes, of voor ondertekening en herhaalpogingen. Haal de status na het aanmaken op via de Reonic REST API (zie de handleiding over de REST API).
• Bouw idempotentie in aan jouw kant. De aanvraag-webhook verzendt mislukte leveringen niet opnieuw voor je, dus ontwerp je endpoint zo dat het een levering aankan die het al eerder heeft ontvangen. Gebeurtenisabonnementen proberen het wel opnieuw voor je.
• Webhooks, Zapier en een gekoppeld CRM werken naast elkaar. Ze zijn onafhankelijk van elkaar. Heb je ze alle drie geconfigureerd, dan bereikt elke nieuwe aanvraag alle drie de bestemmingen.
• Auditspoor per aanroep. Elke levering komt in je integratielogboeken terecht met het integratietype, de status en het tijdstempel, zichtbaar onder Instellingen > Bedrijfsinstellingen > Integraties.
• Verifieer de handtekening van elk bericht. Valideer elke levering met het geheim dat op de pagina Webhooks wordt getoond, zodat je alleen echte leveringen van Reonic accepteert.

Laatst bijgewerkt op 9 november 2026