Direct naar de inhoud

Voor verhuurders · Voor makelaars

Je huuraanbod koppelen aan HuurPulse

Werk je als makelaar met Realworks? Dan kun je je huuraanbod automatisch op HuurPulse laten verschijnen. Jij bepaalt of de koppeling aan staat en welke gegevens je deelt. Zet je haar uit, dan verdwijnt je aanbod automatisch van HuurPulse.

Stap voor stap activeren

  1. Log in op het Realworks Dashboard en ga naar het onderdeel voor API-koppelingen (koppelingen met andere partijen).
  2. Kies een nieuwe koppeling en vul ons developer-ID in. Zo weet de software dat de koppeling voor HuurPulse is:329e7228-ed77-4157-9dd7-792bccafcba1
  3. Zet de API's aan die je wilt delen:
    • Wonen (verplicht): je huurwoningen.
    • Nieuwbouw (optioneel): nieuwbouwprojecten met huurprijzen.
    • Makelaar (optioneel): de gegevens van je kantoor, alleen nodig als je wilt dat we je kantoornaam en contactgegevens bij je woningen tonen.
    Andere onderdelen (zoals aankoop, agenda, taken, bedrijfsmatig vastgoed of je relatiebestand) hebben we niet nodig; zet die niet aan.
  4. Sta het IP-adres van onze server toe in het Realworks Dashboard. Zonder dit adres weigert de software onze verzoeken:85.10.139.6
  5. Activeer de koppeling. Na je activering ontvangt HuurPulse per API een token per e-mail. Wij slaan de tokens versleuteld op en tonen ze nooit volledig, ook niet aan onze eigen medewerkers.
  6. Laat ons weten welke gegevens we mogen tonen door te mailen naar adverteerders@huurpulse.nl. Daarna zetten we de koppeling bij ons aan en verschijnt je aanbod meestal binnen een uur.
  7. Aanbevolen: stel webhooks in, dan zien we wijzigingen binnen enkele minuten in plaats van binnen een uur. Je krijgt van ons per mail een persoonlijke webhook-URL (deel die met niemand). Kies in het Developer Portal bij je token “Voeg webhook toe” en maak er twee aan, allebei met objecttype Wonen en onze URL als doel:
    • updatetype Object update (prijs, foto's, tekst gewijzigd);
    • updatetype Status update (verhuurd, ingetrokken of niet meer vrijgegeven).
    Naam en e-mailadres kies je zelf; op dat adres meldt Realworks als een webhook niet aankomt. Trek je de vrijgave van een woning in, dan halen we haar direct van HuurPulse. Zonder webhooks werkt de koppeling ook: we controleren dan elk uur.

Welke gegevens je deelt

Altijd nodig om een woning te kunnen tonen: huurprijs, adres, woonoppervlakte, aantal kamers en beschikbaarheid. Daarnaast kies je zelf of je vrijgeeft:

  • Foto's: alleen de foto's die je in je software voor publicatie hebt vrijgegeven.
  • Omschrijving: je aanbiedingstekst.
  • Contactgegevens van je kantoor: naam, telefoonnummer, e-mailadres en website (via de Makelaar-API).

Wat je niet vrijgeeft, nemen we niet over. Geef je later minder vrij, dan verwijderen we die gegevens direct.

Wat we wel en niet doen

  • We tonen alleen huurwoningen die actief en beschikbaar zijn; vertrouwelijke objecten nooit.
  • We halen alleen op wat er gewijzigd is: elk uur, en direct na een seintje (webhook) van je software. Eén keer per nacht controleren we het volledige aanbod.
  • We doen hooguit één verzoek per seconde, met een vast maximum per ronde.
  • Verhuurd of ingetrokken? Dan verdwijnt de woning direct na het seintje (webhook), en anders bij de volgende ronde van HuurPulse.
  • Toont een woningzoeker interesse, dan komt die alleen in je CRM terecht als hij daar uitdrukkelijk toestemming voor geeft.

Stoppen

Zet de koppeling uit in je Realworks Dashboard of trek het token in. Zodra de software onze verzoeken weigert, zetten we de koppeling automatisch stop en verwijderen we al je woningen, foto's en teksten van HuurPulse. Liever dat wij het doen? Mail naar adverteerders@huurpulse.nl. Later opnieuw koppelen kan altijd.

Vragen

Mail naar adverteerders@huurpulse.nl. Vermeld je kantoornaam, dan helpen we je snel verder.