Dit artikel behandelt twee gebieden: het verbinden van de 14 ingebouwde portaalintegraties (MLS) en het instellen van de Feed Manager voor aangepaste feeds naar partnerkantoren.
Tesoro CRM ondersteunt 14 vastgoedportalen. Elke portaalverbinding valt in een van twee categorieen: XML-datafeed (het portaal leest periodiek een URL die Tesoro genereert) of Directe API-verbinding (Tesoro pusht updates automatisch naar het portaal).
Zoek het portaal dat u wilt inschakelen in het raster van portaalkaarten.
Zet de schakelaar op AAN. Het portaal is nu actief en zal uw woningen opnemen in zijn datafeed.
Voor feed-gebaseerde portalen (alle behalve Idealista en Fotocasa) wordt automatisch een feed-URL gegenereerd. Klik op de copy-knop op de portaalkaart om deze URL te kopieren. Mogelijk moet u deze URL aan het portaal verstrekken bij het opzetten van uw account bij hen.
Herhaal voor alle andere portalen die u wilt inschakelen.
Controleer eerst uw taalinstellingen. Kyero vereist dat minstens een van uw websitetalen overeenkomt met de ondersteunde talenlijst. Als geen taal overeenkomt, wordt de Kyero-schakelaar uitgeschakeld en verschijnt een waarschuwing.
Zet de schakelaar op AAN op de Kyero-portaalkaart.
Kopieer de feed-URL via de copy-knop en verstrek deze aan uw Kyero-accountmanager.
Configureer de Prime Property Count: klik op het bewerkpictogram op de Kyero-kaart. Er opent een zijpaneel met een dropdown Set Property Count. Selecteer een getal tussen 1 en 25 — dit is het maximale aantal woningen dat tegelijk de Prime-aanduiding (uitgelicht) kan dragen. Klik op Update om op te slaan.
Verbindingstype: Directe API-verbinding
Markt: Spanje, Portugal, Italie
Extra configuratie: Ja — Klantcode
Idealista is een van de grootste vastgoedportalen in Zuid-Europa. Tesoro maakt een directe verbinding via de Idealista API met OAuth2-authenticatie. Er is geen feed-URL nodig — updates worden automatisch gepusht.
Zodra Idealista actief is en uw klantcode is opgeslagen, pusht Tesoro automatisch woningsupdates naar Idealista wanneer u een woning wijzigt die aan dit portaal is toegewezen. Dit omvat:
Woningdetails (type, prijs, kenmerken, adres)
Afbeeldingen
Video’s
Beschrijvingen in ondersteunde talen
U hoeft geen feed-URL te kopieren — de verbinding is volledig automatisch.
Woningtype dat een Idealista-equivalent heeft (appartement, huis, commercieel, grond, landhuis)
Transactietype (koop of huur)
Prijs (minimaal 1, maximaal 999.999.999)
Volledig adres inclusief straat, postcode, gemeente en provincie
Referentienummer (max. 50 tekens)
Beschrijving (max. 4.000 tekens) in een door Idealista ondersteunde taal
Minimaal 1 afbeelding met geldige URL
Websitedomein geconfigureerd
Verbindingstype: Directe API-verbinding
Markt: Spanje
Extra configuratie: Ja — API-sleutel, e-mailadres, telefoonnummer
Fotocasa is een van de grootste Spaanse vastgoedportalen. Net als Idealista maakt Tesoro een directe API-verbinding. Updates worden automatisch gepusht.
Net als Idealista worden woningsupdates automatisch gepusht zodra Fotocasa actief en geconfigureerd is. Als een API-aanroep mislukt, wordt de fout geregistreerd en wordt de MLS-toewijzing bij aanmaak automatisch verwijderd.
Controleer uw taalinstellingen. ThinkSpain heeft dezelfde taalvereiste als Kyero — minstens een websitetaal moet overeenkomen met de ondersteunde talenlijst.
Zet de schakelaar op AAN op de ThinkSpain-portaalkaart.
Kopieer de feed-URL en verstrek deze aan ThinkSpain.
Kyero-compatibel formaat — identiek aan de vereisten van Kyero, Green Acres en andere Kyero-compatibele portalen. Zie het tabblad Green Acres of Kyero voor de volledige lijst.
Ondersteunde talen: ca, da, de, en, es, fi, fr, it, nl, no, pt, ru, sv.
Verbindingstype: XML-datafeed
Markt: Spanje, Portugal, Frankrijk
Extra configuratie: Geen (alleen schakelaar)
Resales Online is een MLS-netwerk voor vastgoedmakelaars in Zuid-Spanje, met name aan de Costa del Sol.
Kyero-compatibel formaat — identiek aan de vereisten van Kyero en andere Kyero-compatibele portalen.
Ondersteunde talen: ca, da, de, en, es, fi, fr, it, nl, no, pt, ru, sv.
Valuta: EUR, GBP, USD.
Landen: Spanje, Portugal, Frankrijk.
Verbindingstype: XML-datafeed
Markt: Universeel
Extra configuratie: Geen (alleen schakelaar)
De “Own Company”-feed is een generieke XML-feed die uw eigen bedrijfsnaam als label gebruikt. U kunt deze feed gebruiken om uw woningdata te delen met externe systemen, uw eigen website of samenwerkingspartners die een Kyero-compatibele XML-feed accepteren.
Deze portalen lezen een URL die Tesoro genereert. U kopieert de URL en verstrekt deze aan het portaal.
Portaal
Landen
Valuta
Talen
Kyero
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
ThinkSpain
ES
EUR
13 talen (ca-sv)
A Place in the Sun
Internationaal
EUR, GBP, USD
en, fr
Luxury Estate
Internationaal
USD, EUR, CNY, MXN, RUB
n.v.t.
Green Acres
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
Idomia
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
Spain Property Portal
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
Resales Online
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
ImmoVario
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
Mimove
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
Spain Houses
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
Eigen Bedrijf
ES, PT, FR
EUR, GBP, USD
13 talen (ca-sv)
Hoe synchronisatie werkt: Het portaal leest periodiek de feed-URL. Elke woning die aan het portaal is toegewezen, de status Active heeft en Display on Website ingeschakeld heeft, verschijnt in de feed. Wijzigingen aan woningen worden weergegeven de volgende keer dat het portaal de feed uitleest.
Deze portalen ontvangen updates die direct vanuit Tesoro worden gepusht. Geen URL-kopieren nodig.
Hoe synchronisatie werkt: Wanneer u een wijziging opslaat aan een woning die aan een van deze portalen is toegewezen, detecteert Tesoro automatisch welke velden zijn gewijzigd en pusht de update. Dit omvat woningdetails, afbeeldingen, video’s en virtuele rondleidingen.
De Feed Manager is een apart hulpmiddel dat u vindt bij Settings > Feed Manager. Hiermee kunt u aangepaste feeds aanmaken die niet gebonden zijn aan een specifiek portaal. In plaats daarvan wordt elke feed aangedreven door een opgeslagen woningfilter en gedeeld met partnerkantoren via unieke URL’s.
Name (verplicht) — een beschrijvende naam voor deze feed, tussen 3 en 100 tekens. Moet uniek zijn onder uw feeds.
Description (optioneel) — een langere beschrijving van wat deze feed bevat, maximaal 8.000 tekens.
Status (verplicht) — kies Active of Offline. Alleen actieve feeds leveren data wanneer ze worden geraadpleegd.
Dynamic Filter — selecteer een opgeslagen woningfilter. Dit filter bepaalt welke woningen in de feed verschijnen. Alleen woningen die aan de filtercriteria voldoen, zowel Display on Website als Display on Feed ingeschakeld hebben, en een in aanmerking komende status hebben, worden opgenomen.
Relations — voeg een of meer partnerkantoren toe. Elk kantoor dat u toevoegt ontvangt een unieke, prive URL met een beveiligingstoken.
Klik op Save om de feed aan te maken.
In aanmerking komende statussen voor Feed Manager-feeds:
Pending Approval, Active, Sold, Rented, Under Offer, Off Market, Negotiating, Under Contract, Open House, Key Ready, Under Construction of Removed by Feed.
Wanneer u een partnerkantoor (relation) aan een feed toevoegt, genereert Tesoro automatisch een uniek beveiligingstoken voor dat kantoor. De feed-URL heeft het volgende formaat:
U kunt de feed delen met meerdere kantoren, en elk heeft een eigen prive URL.
U kunt bijhouden hoe vaak elk kantoor de feed heeft geraadpleegd (het aanvraagaantal) en wanneer ze het laatst hebben geraadpleegd.
Als u een kantoor uit de feed verwijdert, werkt hun URL direct niet meer.
De feeddata wordt gevalideerd tegen Kyero-compatibele standaarden voordat deze wordt geleverd. Woningen die de validatie niet doorstaan worden automatisch uitgesloten van de feed.
Om een feed te bewerken, klikt u op het drie-punten-menu op de feedrij en selecteert u Edit. Het zijpaneel opent met de huidige waarden vooraf ingevuld.
Om een feed te verwijderen, klikt u op het drie-punten-menu en selecteert u Delete. U ziet een bevestigingsdialoog voordat de feed permanent wordt verwijderd.
Probleemoplossing: feed toont 0 woningen
Als uw feed 0 woningen toont, controleer het volgende:
Controleer of het opgeslagen filter overeenkomt met tenminste enkele woningen.
Bevestig dat die woningen zowel Display on Website als Display on Feed op AAN hebben staan.
Controleer of de woningen een in aanmerking komende status hebben (zie de lijst hierboven).
Zorg ervoor dat de woningen de validatie doorstaan — ze hebben minimaal een referentienummer, prijs, woningtype, stad, provincie, slaapkamers, badkamers, een beschrijving en minstens een foto nodig.
