KoppelingenRealworks
Realworks API koppelen aan je website.
Je aanbod staat in Realworks en hoort op je eigen site te staan, actueel en zonder dat iemand het overtypt. Wij bouwen die koppeling op de officiële Realworks API, op WordPress of op maatwerk: objecten, foto’s en kenmerken komen binnen, en een contactaanvraag gaat terug als lead in je CRM.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Realworks je oplevert.
Eén keer invoeren. Je zet een woning in Realworks en hij staat op je site, met foto’s, kenmerken, plattegrond en status.
Leads komen terug. Een contactverzoek of brochure-aanvraag op je site komt via de Wonen API binnen als lead in Realworks.
Je eigen ontwerp. Geen standaard portaalthema in een kader, maar jouw huisstijl met jouw zoekfilters en jouw indeling.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- REST API, per productlijn (Wonen, Aankoop, Business, Nieuwbouw, Relatie)
- Authenticatie
- Developer-ID met token, na activatie door de makelaar in de Realworks Marketplace
- Richting
- Beide kanten op
- Verversing
- Bij elke mutatie in Realworks
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- De makelaar zet de API zelf aan, in de Marketplace onder Servicedesk, en geeft daar het datalevel vrij. Gebeurt dat niet, dan kan een koppelpartij niets ophalen, ook niet met een geldig developer-ID. Dat is de meest voorkomende reden dat een koppeling “niet werkt” terwijl er technisch niets mis is.
- Realworks rekent voor de API zelf kosten, los van het bouwen van de koppeling. Wat dat bedrag is hangt af van wat je kantoor met Realworks heeft afgesproken.
- Er zijn acht API’s. Alleen aanbod tonen is de Wonen API; wil je ook relaties, agenda, taken of facturen, dan is elk daarvan een aparte afname in de Marketplace.
Realworks koppelen
Wat je moet weten voor je begint.
Wat is Realworks?
Realworks is het CRM waarmee Nederlandse makelaars hun verkoop- en verhuurproces beheren, van het eerste contact tot de overdracht. Het bestaat sinds 2004 en wordt volgens de leverancier door ongeveer tachtig procent van de Nederlandse makelaars gebruikt. Het systeem is van Realworks B.V. in Amsterdam.
In Realworks staat het volledige woningdossier: kenmerken, vraagprijs, foto’s, plattegronden, status en de relaties die erbij horen. Daarnaast zitten er onderdelen in voor identificatie, WWFT-controles en het biedlogboek. Voor een website is vooral het objectdeel interessant, want dat is wat een bezoeker wil zien.
Wat doet een Realworks koppeling met je website?
De koppeling haalt je objecten uit Realworks en zet ze op je eigen site. Verandert er iets in het CRM — een nieuwe woning, een prijswijziging, verkocht onder voorbehoud — dan verandert het op de site mee. Niemand typt iets over en er staat nooit een woning te koop die al weg is.
De andere kant op werkt ook. De Wonen API kan leads importeren, dus een contactformulier, een bezichtigingsaanvraag of een brochure-aanvraag op je site belandt direct als lead in Realworks in plaats van in een mailbox. Dat scheelt overtypen en het scheelt aanvragen die blijven liggen.
Hoe we de koppeling bouwen op WordPress
Op WordPress halen we het aanbod periodiek op en slaan we het op als eigen berichttype. Dat is bewust: zou je de API bij elk bezoek bevragen, dan is je site zo traag als de koppeling op dat moment toevallig is, en ligt hij plat als Realworks onderhoud heeft.
Doordat elke woning een echt bericht is, werkt alles wat WordPress al kan: zoeken, filteren, een eigen indeling per woningtype en een eigen adres per object. De beheerder ziet het aanbod in zijn eigen beheerscherm staan, maar bewerkt het niet: Realworks blijft de bron, anders lopen de twee uit elkaar.
Hoe we hem bouwen op Next.js of maatwerk
Op een maatwerksite halen we het aanbod aan de serverkant op en bouwen we elke woning als een eigen, statisch gegenereerde pagina. Die pagina staat er dus al voordat een bezoeker hem opvraagt, en hij ververst zichzelf op een vaste termijn of zodra Realworks een wijziging doorgeeft.
Dat heeft twee gevolgen die je merkt. De pagina laadt zonder te wachten op een externe partij, en de inhoud staat in de HTML die Google en antwoordmachines lezen. Bij een koppeling die het aanbod pas in de browser ophaalt is dat allebei niet zo.
Waar het in de praktijk misgaat
Het vaakst op de rechten. De koppeling is gebouwd, het developer-ID klopt, en er komt niets binnen omdat de makelaar de API nog niet heeft geactiveerd of het datalevel niet heeft vrijgegeven. Dat is geen technisch probleem en het is in tien minuten opgelost, maar je zoekt er lang naar als je niet weet waar je moet kijken.
Daarna op de media. Realworks levert foto’s in één formaat; de site moet zijn eigen maten maken. Doe je dat niet, dan laadt elke zoekpagina tientallen foto’s op volledige grootte en is je site traag op een telefoon, precies waar de meeste bezoekers zitten.
Resultaat in de praktijk
Werk dat we hebben opgeleverd.
Boumij MakelaarsRealworks-koppeling met woningzoeker en eigen woningpagina’s
DUX Real EstateRealworks-koppeling voor het bedrijfsonroerendgoedaanbodSpecialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Hoe koppel ik mijn Realworks-aanbod aan mijn website?
In drie stappen. Je activeert in Realworks onder Servicedesk, Marketplace de Wonen API en geeft het datalevel vrij. Je koppelpartij meldt zich aan op developers.realworks.nl en krijgt een developer-ID. Met dat ID en een token haalt de koppeling je objecten op en zet ze op je site.
Wat kost een Realworks koppeling?
Twee dingen tellen mee. Realworks rekent kosten voor de API zelf, en wat dat is hangt af van wat je kantoor met Realworks heeft afgesproken. Daarnaast kost het bouwen van de koppeling geld. Voor dat tweede geven we vooraf een vaste prijs, op basis van wat je wilt tonen.
Hoe lang duurt het bouwen van een Realworks koppeling?
In de praktijk ligt een koppeling die alleen aanbod toont tussen de één en twee weken. Gaat er ook data terug, zoals leads uit je formulieren, dan komt daar testen bij. De activatie in de Marketplace kun je zelf alvast doen, want daar wachten we anders op. Een harde levertijd staat pas in de offerte.
Moet ik de Realworks API zelf aanzetten?
Ja. Alleen de makelaar kan dat, en het kan niet namens jou. Je gaat in Realworks naar Servicedesk, dan Marketplace, en activeert daar de Wonen API. Vervolgens geef je aan welk datalevel de koppelpartij mag zien. Zonder die twee stappen komt er geen gegeven binnen.
Werkt een Realworks koppeling ook op WordPress?
Ja. We slaan het aanbod op als eigen berichttype in WordPress, zodat zoeken, filteren en losse woningpagina’s werken zoals de rest van je site. Realworks blijft de bron: je bewerkt woningen in het CRM, niet in WordPress, anders lopen de twee na een paar weken uit elkaar.
Blijft mijn aanbod op de site automatisch actueel?
Ja. Elke wijziging in Realworks komt op de site terecht: een nieuwe woning, een prijswijziging, verkocht onder voorbehoud of uit de verkoop. Je hoeft niets aan te passen op de website zelf. Dat is ook het punt van de koppeling: één plek waar je het bijhoudt.
Kan ik ook aanvragen vanaf mijn site in Realworks krijgen?
Ja, dat kan met de Wonen API. Een contactverzoek, een bezichtigingsaanvraag of een brochure-aanvraag komt dan binnen als lead in Realworks, bij de juiste woning. Zonder die koppeling belandt zo’n aanvraag in een mailbox en moet iemand hem overtypen.
Let’s work together.
Aanbod uit Realworks op je eigen site, in je eigen huisstijl.