KoppelingenKolibri
Kolibri API koppelen aan je website.
Je aanbod staat in Kolibri en hoort op je eigen site te staan. Wij bouwen die koppeling op SiteLink, de API van Kolibri voor makelaarswebsites: elke woning een eigen pagina op je domein, met foto’s, kenmerken en status, op WordPress of op maatwerk.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Kolibri je oplevert.
Eén plek om bij te houden. Je zet een woning in Kolibri en hij staat op je site, met kenmerken, foto’s en status.
Een eigen pagina per woning. Elke woning krijgt een eigen adres op je domein, dus Google kan hem vinden en jij kunt eraan linken.
Jouw ontwerp en jouw filters. Het aanbod staat in de opmaak van je eigen site, met de zoekfilters die bij jouw kantoor passen.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- SiteLink: één download die een ZIP teruggeeft met per object een XML-bestand
- Authenticatie
- Token in het adres, door Kolibri per e-mail aan de makelaar verstrekt
- Richting
- Van het systeem naar de site
- Verversing
- Tien keer per dag ophalen, met PRO vierentwintig; elke respons blijft een uur in de cache
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- De daglimiet bepaalt het ontwerp en niet andersom. SiteLink mag tien keer per dag worden opgehaald, met PRO vierentwintig, en elke respons blijft een uur in de cache. Realtime bestaat hier dus niet: een verkochte woning staat in het slechtste geval nog een paar uur op je site. Dat is geen instelling die je aan kunt zetten, dus reken erop in wat je de klant belooft. Tijdens het bouwen kun je bij Kolibri tijdelijk verruiming vragen.
- Er is geen manier om alleen de wijzigingen op te vragen. Je haalt elke keer de hele voorraad op en bepaalt zelf wat er nieuw, gewijzigd of verdwenen is. Dat is prima te doen, maar het is wel werk dat bij andere systemen al voor je gedaan is, en het bepaalt hoe je de opslag inricht.
- De foto’s mag je niet vanaf de adressen van Kolibri tonen. De documentatie laat daar geen ruimte in: je bent verplicht de media naar je eigen server te halen en vanaf daar te serveren. Elke bijlage heeft een Hash en een wijzigingsdatum, dus je haalt alleen opnieuw op wat echt is veranderd. Houd er in de planning rekening mee dat dit opslag en bandbreedte kost.
- SiteLink haalt alleen op. Wil je een contactaanvraag vanaf je site terug in Kolibri hebben, dan loopt dat via de Core API onder AppXchange, met OAuth 2.0 en een eigen aanvraag bij Kolibri. Die documentatie zit achter een ontwikkelaarslogin, dus dat zoeken we uit voordat we het toezeggen. Het is een tweede traject, geen onderdeel van SiteLink.
Kolibri koppelen
Wat je moet weten voor je begint.
Wat is Kolibri?
Kolibri is makelaarssoftware uit Arnhem. Het CRM is het hart ervan: daarin staan de panden, de relaties, de agenda en het dossier, van de eerste bezichtiging tot de overdracht. Volgens de leverancier werken er meer dan tweeduizend makelaars mee.
Het pakket is breder dan het CRM alleen. Er zitten websites voor makelaars in, een klantportaal onder de naam Jouwmakelaar.online, een digitaal woondossier en AppXchange voor koppelingen met andere software. Voor een eigen website is vooral het pandendeel interessant, want dat is wat een bezoeker komt bekijken.
Hoe de koppeling werkt: SiteLink
SiteLink is de dienst van Kolibri waarmee een makelaarswebsite het aanbod ophaalt. Je roept één adres aan met jouw token erin en krijgt een ZIP-bestand terug met per object een XML-bestand, waarin dat object uitgebreid staat beschreven.
In die XML zitten de onderdelen die je op een woningpagina nodig hebt: oppervlaktes, kenmerken, verwarming en energielabel, tags en de bijlagen. Taal, valuta en cultuur van het kantoor komen mee, zodat prijzen en eenheden kloppen. De foto’s staan er als adres in; die halen wij naar je eigen server, want anders mag je ze niet tonen.
Er zijn drie versies. Wij bouwen op versie 3, die sinds 26 augustus 2019 meeloopt met de wijzigingen in Kolibri. In versie 1 en 2 ontbreken pandtypes en details die in versie 3 wel zitten, dus daar beginnen we niet meer aan.
Wat de daglimiet betekent voor je site
Dit is het verschil met een systeem als Realworks, en het is het eerste wat we bespreken. SiteLink levert geen mutaties maar momentopnames: tien keer per dag mag je de hele voorraad ophalen, met PRO vierentwintig, en binnen hetzelfde uur krijg je dezelfde gegevens terug uit de cache.
Daar valt prima mee te werken, maar het bepaalt wat je belooft. Een woning die vanmiddag onder bod gaat, staat hooguit een paar uur later goed op je site. Voor een bezoeker is dat geen probleem; voor een verkoper die net de status heeft omgezet en meteen kijkt wel.
Wij halen daarom op de momenten dat het uitmaakt, verspreid over de dag, en niet allemaal ’s nachts. En we zetten er een melding op: komt er een keer niets binnen, dan hoor je dat, want een voorraad die stil blijft staan ziet er precies hetzelfde uit als een voorraad die klopt.
Kolibri levert zelf ook websites
Dat is een reële optie en we doen niet alsof dat niet zo is. Zit je aanbod in Kolibri en wil je vooral snel iets online, dan is hun eigen site de kortste weg.
De vraag is wat je site verder moet doen. Een makelaarssite die alleen aanbod toont is één ding; een site die ook over je kantoor gaat, die lokaal moet scoren op verkoopmakelaar in jouw plaats, die een aankoopdienst verkoopt en die eruitziet zoals jouw huisstijl, is iets anders. Daar loop je bij een standaardpakket vast op wat er nét niet in zit.
Onze afweging is simpel. Gaat het je om het aanbod, neem dan hun site. Gaat het je om het kantoor erachter, bouw dan je eigen site en haal het aanbod erbij. Dat tweede is waar wij voor gebeld worden.
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn Kolibri-aanbod op mijn eigen website tonen?
Ja. Kolibri heeft daar SiteLink voor: een dienst die je hele aanbod als XML aanlevert, bedoeld voor makelaarswebsites. Wij halen dat op en maken per woning een eigen pagina op je site, met foto’s, kenmerken en status. Je blijft het aanbod gewoon in Kolibri beheren.
Heeft Kolibri een API?
Ja, en zelfs meer dan één. SiteLink is de API voor makelaarswebsites en levert het aanbod. Daarnaast is er de Core API onder AppXchange voor koppelingen met andere software, en de Mediapartner API voor portalen. Voor een eigen website is SiteLink de route.
Hoe snel staat een verkochte woning van mijn site af?
Binnen een paar uur, niet binnen een minuut. SiteLink mag tien keer per dag worden opgehaald, met PRO vierentwintig, en een respons blijft een uur in de cache. Dat is een grens van Kolibri en geen instelling. Wij verdelen de ophaalmomenten over de dag, zodat de site zo kort mogelijk achterloopt.
Hoe kom ik aan een SiteLink-token?
Die vraagt de makelaar zelf aan bij Kolibri; het token komt daarna automatisch per e-mail binnen. Zonder geldig token geeft de dienst een 403 terug en kan er niets worden opgehaald of getest. Regel het dus aan het begin van het traject en niet op de dag dat de site live moet.
Werkt een Kolibri-koppeling ook op WordPress?
Ja. We slaan de opgehaalde woningen op als eigen berichttype in WordPress, zodat zoeken, filteren en losse woningpagina’s werken zoals de rest van je site. Kolibri blijft leidend: je bewerkt het aanbod daar en niet in WordPress, anders lopen de twee uit elkaar.
Kunnen aanvragen van mijn site terug naar Kolibri?
Niet via SiteLink; die haalt alleen op. Terugschrijven loopt via de Core API onder AppXchange, met OAuth 2.0 en een aparte aanvraag bij Kolibri. Wij zoeken eerst uit wat daar precies kan voordat we het toezeggen, want die documentatie is niet openbaar.
Let’s work together.
Je hele aanbod uit Kolibri op je eigen site, met een pagina per woning.