Keuringsaanvragen vanaf uw eigen website koppelen
Keurix redactie · Bijgewerkt op · 6 min leestijd
Komen uw keuringsaanvragen nu binnen per mail of telefoon? Dan typt iemand ze daarna over in de planning. Met de website-koppeling van Keurix stuurt het aanvraagformulier op uw eigen site de aanvraag rechtstreeks door. De keuring verschijnt meteen als Nieuw in uw keuringenoverzicht, met een Website-label zodat u ziet waar de aanvraag vandaan komt.
Op deze pagina leest u wat de koppeling oplevert, welke twee koppelvormen er zijn en hoe u uw formulier aansluit, op hoofdlijnen en zonder onnodige techniek. Wilt u eerst het volledige werkproces zien, kijk dan bij hoe Keurix werkt en het functie-overzicht.
Keuringen beheren zonder losse lijstjes? Probeer Keurix gratis, de eerste 5 keuringen zijn gratis.
Inhoudsopgave
Wat de koppeling u oplevert
Zonder koppeling is een websiteaanvraag een e-mail die u leest, overtypt en handmatig inplant. Elke stap kost tijd en kan fouten opleveren. Met de koppeling gebeurt dat automatisch: de gegevens die de bezoeker invult, komen één op één in Keurix terecht.
- Geen overtypwerk meer: adres, contactgegevens en keuringstype staan direct in het dossier.
- Aanvragen raken niet meer kwijt tussen andere e-mail.
- U ziet aan het Website-label meteen welke aanvragen via uw site binnenkwamen.
- De aanvrager krijgt na verzenden de gewone bevestiging van uw eigen formulier te zien.
Hoe het op hoofdlijnen werkt
Uw website stuurt de ingevulde aanvraag naar een adres (endpoint) van Keurix. Keurix controleert de gegevens en maakt er een keuring van met de status Nieuw en de bron Website. Vanaf dat moment verloopt de aanvraag als elke andere keuring: u plant hem in, voert de keuring uit en levert het rapport. De koppeling raakt alleen de binnenkomst; de rest van uw werkstroom verandert niet.
De koppeling werkt server-side. De verbinding loopt van uw webserver naar Keurix, niet vanuit de browser van de bezoeker. Zo blijven uw sleutels buiten het zicht van bezoekers.
Twee manieren om te koppelen
Keurix biedt twee koppelvormen. Welke past, hangt af van het formulier waarmee uw website is gebouwd.
Elementor Pro, zonder programmeerwerk
Gebruikt uw WordPress-site Elementor Pro? Dan koppelt u het formulier met de ingebouwde webhook-actie, zonder een regel code. U voegt onder Acties na verzenden een webhook toe, plakt de koppel-URL van Keurix erin en geeft elk formulierveld de juiste veld-id. Elementor stuurt de aanvraag dan server-side vanuit WordPress door. Een webhook is een afspraak waarbij het ene systeem een ander automatisch een bericht stuurt zodra er iets gebeurt, hier: zodra iemand het formulier verzendt.
JSON-koppeling voor elk ander formulier
Werkt uw site met een ander formulier of is het maatwerk? Dan gebruikt u de server-side JSON-koppeling. Uw website stuurt de aanvraag door als een klein gestructureerd berichtje (JSON) met de sleutel in een verborgen kop (header). Voor WordPress is een kant-en-klaar PHP-voorbeeld beschikbaar dat u kunt overnemen. Zo blijft de sleutel volledig buiten de webpagina.
Welke gegevens het formulier meestuurt
Het formulier stuurt de gegevens mee die Keurix nodig heeft om de keuring te kunnen inplannen. Een paar velden zijn optioneel.
| Gegeven | Verplicht of optioneel | Toelichting |
|---|---|---|
| Adres van het pand | Verplicht | Straat, huisnummer, postcode en plaats |
| Contactgegevens | Verplicht | Voor- en achternaam, e-mailadres en telefoonnummer |
| Keuringstype | Verplicht | Een van de zes typen die Keurix ondersteunt |
| Bouwjaar | Optioneel | Bouwjaar van het pand |
| Oppervlakte | Optioneel | Gebruiksoppervlakte in vierkante meter |
De zes keuringstypen zijn energielabel, bouwkundige keuring (NTA 8060), asbestinventarisatie, opleveringskeuring, thermografie en funderingsonderzoek. Biedt uw formulier maar één type aan, dan zet u dat type vast. Status en toegewezen adviseur zijn niet van buitenaf te zetten: die bepaalt Keurix zelf.
Twee losse API-sleutels
Een API-sleutel is een geheim wachtwoord waarmee uw website zich bij Keurix bekendmaakt. Er zijn twee losse sleutels, elk voor één koppelvorm: een algemene sleutel voor de JSON-koppeling en een webhooksleutel voor de Elementor-koppeling. U genereert en trekt ze los van elkaar in onder Administratie, bij Website-API.
- Elke sleutel wordt maar één keer getoond; bewaar hem goed.
- Sleutel kwijt of mogelijk uitgelekt? Genereer een nieuwe. De oude stopt dan direct met werken (sleutelrotatie).
- Omdat de sleutels los staan, raakt een probleem met de ene koppeling nooit de andere.
Zet uw website rechtstreeks aan uw planning
Maak een gratis account aan, activeer de website-koppeling en laat aanvragen vanzelf binnenkomen. De eerste vijf keuringen zijn gratis.
Begin gratis met KeurixIngebouwde bescherming tegen misbruik en dubbel werk
Een formulier dat direct aan uw planning hangt, moet bestand zijn tegen fouten en misbruik. Keurix heeft daarom drie controles ingebouwd:
- Veldcontrole: ontbreekt een verplicht veld of klopt een waarde niet, dan wordt de aanvraag geweigerd en komt er geen half dossier binnen.
- Limiet op het aantal aanvragen: te veel aanvragen in korte tijd worden afgeremd, zodat uw overzicht niet volloopt.
- Duplicaatcontrole: loopt er op hetzelfde adres al een actieve keuring binnen uw organisatie, dan wordt de nieuwe aanvraag geweigerd.
Optioneel automatisch inplannen
Standaard blijft een websiteaanvraag op Nieuw staan, klaar om zelf in te plannen. Wilt u een stap verder, dan schakelt u het automatisch inplannen van websiteaanvragen in. Keurix stelt dan zelf een planvoorstel op aan de hand van uw werkgebieden, beschikbaarheid en reistijd. Lukt dat niet, dan blijft de aanvraag gewoon op Nieuw staan voor handmatige planning. Voor websiteaanvragen is dit automatisch plannen een bewuste keuze die u zelf aanzet.
Het kan zelfs nog directer: uw formulier kan de vrije momenten van uw agenda tonen, zodat de bezoeker meteen een tijdslot kiest. Keurix rekent daarbij met dezelfde regels als de interne planning (werkgebied, beschikbaarheid, reistijd en dagmaximum), dus een getoond moment is ook echt haalbaar. Kiest de bezoeker een slot, dan komt de aanvraag direct als Gepland binnen. Hoe ver vooruit er geboekt kan worden stelt u zelf in: standaard 30 dagen, maximaal 90.
Zo sluit u uw formulier aan
De koppeling is beschikbaar na vrijgave door beheer of automatisch na uw eerste aankoop. Daarna activeert u de koppeling zelf en genereert u de sleutel die bij uw koppelvorm hoort.
- Activeer de website-koppelingZodra de koppeling voor u vrij is, zet u deze zelf aan onder Administratie bij Website-API.
- Genereer de juiste sleutelKies de webhooksleutel voor Elementor Pro of de algemene sleutel voor een JSON-koppeling, en bewaar hem.
- Verbind uw formulierVul in Elementor de webhook-actie in, of laat de JSON-koppeling instellen met het PHP-voorbeeld.
- Test met een echte aanvraagVerstuur een proefaanvraag en controleer of die als Nieuw met een Website-label in uw overzicht verschijnt.
Werkt u alleen? Bekijk dan Keurix voor zelfstandige inspecteurs. Werkt u met een team, dan is Keurix voor keuringsbureaus het startpunt. Wat een afgeronde keuring kost, leest u op de tarievenpagina.
Veelgestelde vragen
Heb ik programmeerkennis nodig om mijn formulier te koppelen?
Voor Elementor Pro niet: daar gebruikt u de ingebouwde webhook-actie zonder code. Voor andere formulieren gebruikt u de server-side JSON-koppeling; voor WordPress is daarvoor een kant-en-klaar PHP-voorbeeld beschikbaar dat een websitebouwer eenvoudig overneemt.
Wat gebeurt er met een aanvraag die vanaf mijn website binnenkomt?
De aanvraag verschijnt direct als Nieuw in uw keuringenoverzicht met een Website-label. Vanaf dat moment plant u de keuring in, voert u hem uit en levert u het rapport, net als bij elke andere keuring.
Waarom zijn er twee aparte API-sleutels?
Elke koppelvorm heeft zijn eigen sleutel: een algemene sleutel voor de JSON-koppeling en een webhooksleutel voor Elementor. U genereert en trekt ze los van elkaar in, zodat een probleem met de ene koppeling nooit de andere raakt.
Wat gebeurt er bij een dubbele aanvraag op hetzelfde adres?
Loopt er binnen uw organisatie al een actieve keuring op dat adres, dan weigert Keurix de nieuwe aanvraag. Zo voorkomt de ingebouwde duplicaatcontrole dat u per ongeluk twee keuringen voor hetzelfde pand in uw planning krijgt.
Worden websiteaanvragen automatisch ingepland?
Alleen als u dat zelf aanzet. Standaard blijft een websiteaanvraag op Nieuw staan voor handmatige planning. Schakelt u het automatisch inplannen in, dan stelt Keurix zelf een planvoorstel op aan de hand van uw werkgebieden, beschikbaarheid en reistijd.
Wat kost de website-koppeling?
De koppeling zelf zit bij Keurix inbegrepen; u betaalt alleen per afgeronde keuring. Aanvragen ontvangen en inplannen is gratis. De exacte prijs per keuring vindt u op de tarievenpagina.
Slimmer keuren met Keurix
Keurix is het administratieplatform voor energielabels, bouwkundige keuringen en andere gebouwinspecties: aanvragen, planning, rapportlevering en facturatie in één overzicht. Voor zelfstandige inspecteurs en bureaus.