Realworks API koppelen aan je website.

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 we verder voor makelaars doen staat op de pagina over vastgoed.

De integratie haalt je objecten uit Realworks en zet ze op je eigen site. Verandert er iets in het CRM, zoals een nieuwe woning, een prijswijziging of 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.

1. Je kiest welke API’s je nodig hebt. Realworks heeft er acht; voor aanbod tonen en leads terugsturen is dat de Wonen API, en relaties, agenda, taken of facturen zijn elk een aparte afname.

2. Het kantoor activeert die API in Realworks onder Servicedesk, Marketplace, en geeft daar het datalevel vrij voor de koppelpartij.

3. Wij melden ons als koppelpartij aan op het developerportaal van Realworks en koppelen met ons developer-ID en een token aan jullie omgeving.

4. We halen eerst een handvol objecten op en controleren kenmerken, foto’s en status tegen wat er in Realworks staat, voordat de volledige lijst binnenkomt.

5. Bij de livegang zetten we de verversing aan en sturen we een testaanvraag vanaf de site, om te zien dat hij als lead bij de goede woning landt.

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.

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 integratie die het aanbod pas in de browser ophaalt is dat allebei niet zo. Meer over zulke makelaarssites en de techniek erachter lees je onder Design & Development.

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.