Koppelingen

Koppelingen aanvragen bij Realworks via de Marketplace

Het aanvragen van de Moving Digital koppelingen kan via de Market Place van Realworks. Log in de Realworks omgeving in en volg onderstaande stappen:
  • Kies voor Servicedesk (staat links getoond) en daaronder voor ‘Market Place’.
  • Scrol naar beneden; ergens komt het kopje ‘Connected partners – koppeling derden’ tevoorschijn.
  • Klik op Diorama:
    • kies voor bestellen, ga akkoord met beide hokjes en kies voor ‘bestellen’. Uiteraard worden er geen kosten vanuit Realworks gerekend voor het gebruik van deze modules. Het contract verloopt via Moving Digital.
  • Volg deze stappen ook voor Woonplanner, mits je gebruik maakt/wilt maken van het Woonplanner platform.
  • Zorg dat panden daarna worden vrijgegeven volgens deze uitleg voor vrijgave.

Vrijgave van panden in Realworks CRM omgeving (uitleg verkregen vanuit Realworks):

Om de standaard vrijgave in te stellen ga je eerst rechts bovenin naar je profiel in Realworks (klik op je naam).
Ga dan naar: (Bedrijfs)instellingen –> Publicatie –> Instellingen Vrijgave

Hier kun je de standaard vrijgave bepalen en de eventuele vertraging (afbeelding 1). Klik op ‘bewaar’ en vervolgens op ‘objecten bijwerken’.
Daar kun je vervolgens alle huidige objecten (met de zojuist gekozen standaard instellingen) overschrijven (afbeelding 2). Vink de juiste opties aan en klik op bewaar.


Afbeelding 1

Per woning vrijgeven/vrijgeven voor panden die ‘in aanmelding’ zijn.
Wil je per woning bepalen of deze wel of niet vrijgegeven moeten worden, dan ga je bij de woning naar het tabblad Marketing –> Publicatie.
Zet daar Diorama op ‘vrijgave’ per ‘direct’ (afbeelding 3).
Op deze manier kunnen ook panden die de status ‘in aanmelding’ hebben, in het Moving Digital systeem worden ingeladen

Vaak zit er in het systeem een kleine bug ingebouwd, waardoor er eerst voor een vertraging moet worden gekozen. Deze stel je in voor bijvoorbeeld 1 dag.
– Kies daarna voor de optie: ‘Alle objecten bijwerken’.
– ‘Wonen’ aanvinken
– De vertraging kan daarna weer als optie worden uitgevinkt (vertraging: geen).
– Kies wederom voor opslaan; de koppelingen zouden nu vrijgegeven moeten zijn.

Vrijgave panden Kolibri (Venum)

Let op: de Moving Digital module heet hier ‘Vrenz’.

De instellingen van Kolibri – Mediapartners

Zie voor het activeren van de Moving Digital modules in Kolibri onderstaande informatie vanuit Wazzup, over het aanvragen van koppelingen:

https://support.kolibri.software/portal/nl/kb/articles/de-instellingen-van-kolibri-mediapartners

Vrijgave panden Goes & Roos

Er is geen online handleiding beschikbaar, maar bij G&R werd het onderstaande aangegeven:
  1. Moving Digital kan de koppeling aanvragen, met de makelaardij in de CC (Goes & Roos zal nl. uiteraard altijd checken of de makelaardij daadwerkelijk akkoord is met deze samenwerking).
  2. G&R vraagt bij makelaardij ook na of het gehele aanbod voor Woonplanner/Diorama vrijgegeven moet worden. Ook staat de basisinstelling op de automatische vrijgave voor elk pand (ook de nieuw aangemelde panden). Deze status heet dan ‘open’.
    Indien de makelaardij dit niet wil, kan de basisinstelling op ‘vrijgave per object’ worden gezet. Dit houdt echter een extra handeling per aanmelding van een pand in; de vrijgave voor Woonplanner/Diorama gaat dan telkens op objectniveau. De voorkeur voor basisinstelling wordt tussen makelaardij en Goes & Roos afgestemd.
  3. Het vrijgeven per object gaat als volgt:
  • De makelaar zoekt het woonobject op in het CRM-systeem onder het woningaanbod
  • Bij betreffend object kan op het ‘potlood’-symbool worden geklikt voor wijzigen
  • Daarna bij het tabblad ‘Algemeen’ moet er rechtsboven de melding ‘Naar website’ op ‘ja’ staan.
  • Op het tabblad ‘Koppelingen’ moet zowel Woonplanner (voorheen KMH) als Diorama (voorheen: HelpMee) worden aangevinkt.
  • Hierna zouden alle vrijgave instellingen geregeld moeten zijn.

Vincent van Goes & Roos voor Moving Digital contactpersoon (gesproken over het bovenstaande in feb 2018).

Handige info:
Panden die in het G&R systeem als ‘inactief’ worden ingeladen, krijgen wij niet binnen voor Diorama (HelpMee) en/of Diorama.Ads. Daarnaast kan het 1-2 dagen duren voordat de gegevens bij ons zijn binnengekomen, wanneer een pand wél als actief staat ingevoerd in jouw G&R CRM-systeem.

Notitie voor Moving Digital: ID in feed URL is koppel ID.

Uitleg voor makelaar: vrijgave panden Yes-co

De koppeling voor ‘HelpMee’ (HelpMee marketing kanaal – naam kan inmiddels gewijzigd zijn naar Moving Digital – Diorama) kan bij de ‘app market’ van Yes-co worden aangezet (via de button ‘Activeren’). Deze actie is eenmalig. Onderstaand voorbeeld is als printscreen bij Yes-co verkregen.
De vrijgave van panden gebeurt in Yes-co per pand; na het invoeren van een pand kunnen er verschillende kanalen worden aangevinkt (of in 1x alle kanalen), maar HelpMee moet bij het betreffende pand in elk geval worden aangevinkt. Daarna krijgen ook wij het pand binnen. Houd er rekening mee dat panden die vandaag voor HelpMee worden vrijgegeven, morgen (na een automatische, nachtelijke import aan onze kant) in de Diorama (HelpMee) account staan. 

Vrijgave panden Cubic

U kunt een pand voor onze modules aanvinken zodat deze ook in onze account verschijnt.

Dat doe je door bij het desbetreffende pand te gaan naar:
tab Presentatie => Feedbeheer

Daar vind je het veld “kijkmijnhuis helpmee” met een optie tot aanvinken erachter.
Deze optie staat standaard uit. Voor vrijgave aan HelpMee (Diorama) dient het vinkje aan te worden gezet.

Indien je hier niet uitkomt, kun je het beste contact opnemen met Cubic Eyes support, zoals wij van hen hebben begrepen:
(030) 608 0008

Vrijgave panden in Skarabee

In de Skarabee account kunnen de volgende stappen worden doorlopen:

  1. Via de zoekfunctie in Skarabee, zoek alle panden die gepubliceerd moeten worden. Dit kan bijvoorbeeld al het ‘te koop’ aanbod zijn;
  2. Wanneer je de lijst voor je hebt, selecteer dan alle panden die je wenst door te sturen. Doe dit door de juiste vinkjes aan te klikken of gebruik te ‘dropdown’ links bovenaan;
  3. Wanneer de correcte panden zijn geselecteerd, volstaat het om links onderaan op de knop ‘publicaties’ te klikken om deze aan te maken.
  4. U selecteert ‘nieuwe publicatie naar website’:
  5. Tenslotte krijg je het publicatiescherm. Vink de juiste publicaties aan (KijkMijnHuis (oude naamgeving)) en Skarabee doet de rest om deze te publiceren.

Als je ook nieuwe bestanden wilt laten doorsturen kun je een aanpassing maken in de mediamix. Hierdoor hoeven panden niet iedere keer handmatig te worden vrijgegeven, zoals wel het geval is in bovenstaande uitleg.

Diorama content op eigen website verkrijgen

Let op: onderstaande handelingen gelden alleen nadat er met Moving Digital contact is geweest over het instellen van een API-koppeling en het tonen van content op je website.
Voor het tonen van content op je (Realworks) website kunnen de volgende stappen worden genomen:

– Bij Webdiensten ga je naar ‘Website beheer’ en naar tabblad ‘Instellingen’.
– Onder het kopje “Aanbod” zet de instelling ‘Activeer HelpMee op je website 3.0’ op ‘Ja’.
– Klik daaronder op ‘bewaar’.

Nadat daarop geklikt is, staan de instellingen aan jouw kant gereed.

Indien ook alle instellingen bij Moving Digital juist staan, zou de content op de website getoond moeten worden

Publiceren met een iFrame

Introductie

Met de iFrame laad je onze gegevens in vanaf een externe locatie (helpmee.nl). Het voordeel van de iFrame is dat het erg eenvoudig is om op je website te plaatsen. Het nadeel is dat deze gegevens niet worden geïndexeerd door zoekmachines en je bent afhankelijk van de vormgeving en indeling van Diorama.

Stap 1: ophalen objectID

Login op het makelaarsdashboard. Ga vervolgens naar het klantenoverzicht en open de detail pagina van een object.

In het blokje object informatie vind je de objectID van de woning. Dit kan zijn de “HelpMee UUID” (Diorama UUID) of de Import Identifier: ‘realworks’. In stap 2 wordt uitgelegd wat per ID de volgende te nemen stappen zijn.

Stap 2: Iframe url aanroepen

De iFrame kan aangeroepen worden vanaf de volgende URL:

https://helpmee.nl/iframe/v1/?type=[TYPE]&id=[OBJECT-ID]

In deze URL staan een aantal nader in te vullen variabelen (zie hieronder).

[TYPE]
Informatie van Diorama promoties/virals is op 2 manieren aan te roepen:

  • Op basis van het unieke ID (zie [OBJECT-ID]) afkomstig uit Diorama
    • In het geval dat je uit gaat van het unieke ID vanuit Diorama is het type “helpmee”.
      • Voorbeeld: type=helpmee
  • Op basis van het unieke ID (zie [OBJECT-ID]) afkomstig uit je softwarekoppeling
    • In het geval dat je uit gaat van het unieke ID vanuit jouw softwarekoppeling, dan is het type de naam van je softwarekoppeling.
      • Voorbeeld: type=realworks

[OBJECT-ID]
De Uuid van de promotie (viral). Dit is een unieke code die per object verschilt. Hierin zijn 2 opties; afhankelijk van de keuze die gemaakt is bij [TYPE]

  • Bij keuze type “helpmee
    • De object-id kunt je vinden in het makelaars dashboard bij een detail van een promotie onder het blokje “object informatie”.
    • Voorbeeld: id=5bc36089-560b-4890-b47f-0f3a09837f86
  • Bij keuze type softwarekoppeling zoals “realworks
    • De object ID vanuit de software koppeling, is een unieke code die per object verschilt en is alleen aanwezig indien het object is geïmporteerd. De object-id, indien aanwezig, wordt verstrekt door jouw softwareleverancier maar is ook in te zien in het makelaars dashboard. Bekijk hiervoor de detailpagina van het object onder het blokje “object informatie”.
    • Voorbeeld: id=123456

Voorbeeld URL met “standaard” Diorama ID

https://helpmee.nl/iframe/v1/?type=helpmee&id=acb796dc-510e-4b20-abee-21a6704d1074

Voorbeeld URL met softwarekoppeling “Realworks”

https://helpmee.nl/iframe/v1/?type=realworks&id=123456

Stap 3: iFrame code op je website plaatsen

Voor meer informatie over het bijwerken van de eigenschappen van een iFrame, bekijk de tutorial: http://www.w3schools.com/html/html_iframe.asp

Op basis van bovenstaande voorbeelden hebben wij in HTML een voorbeeld van de uiteindelijke code die je op jouw website kunt plaatsen:

Wil je de Homestats (voorheen: Woonplanner) koppeling uitzetten? Doorloop dan onderstaande stappen.

– Log in bij Realworks
– Kies voor Servicedesk (staat links getoond) en daaronder voor ‘Market Place’.
– Ga naar ‘Mijn producten’ (bovenste veld wanneer je de Market Place opent).
– Zoek binnen dit kopje op ‘Woonplanner’. Staat dit er niet bij? Probeer dan ‘Homestats’.
– Deactiveer de bestaande koppeling door op ‘deactiveren’ te klikken.
– Hiervan krijgen wij automatisch vanuit Realworks een melding dat de koppeling is uitgeschakeld, indien dit gelukt is.

Koppelingen aanvragen bij Realworks via de Marketplace

Het aanvragen van de Moving Digital koppelingen kan via de Market Place van Realworks. Log in de Realworks omgeving in en volg onderstaande stappen:
  • Kies voor Servicedesk (staat links getoond) en daaronder voor ‘Market Place’.
  • Scrol naar beneden; ergens komt het kopje ‘Connected partners – koppeling derden’ tevoorschijn.
  • Klik op Sitekick:
    • kies voor bestellen, ga akkoord met beide hokjes (zie onderstaande printscreen) en kies voor ‘bestellen’. Uiteraard worden er geen kosten vanuit Realworks gerekend voor het gebruik van deze module. Het contract verloopt via Moving Digital.

Deel 1: Datapoint aanvragen
Is Datapoint al aangevraagd via de Marketplace? Scrol dan direct verder naar deel 2 van deze uitleg. Zo niet, volg dan eerst onderstaande stappen:

  • Log in bij Realworks
  • Links in het menu kies je voor ‘Servicedesk’ en vervolgens ‘Marketplace’.
  • Hier staan koppelingen vermeld (staan redelijk onderaan), onder het kopje ‘Connected partners – koppeling derden’. Kies voor ‘Moving Digital – Datapoint’.
  • Na akkoord opent de API manager, daarin moeten instellingen worden opgeslagen. Zie hiervoor ‘Deel 2’ van deze uitleg en doorloop direct stap 1 t/m stap 3.

Deel 2: vrijgave regelen

Ben je via ‘Deel 1’ hier uitgekomen, dan kun je direct stap 1 t/m stap 3 volgen. Anders dien je eerst onderstaande stappen te volgen:

  • Ga binnen Realworks naar jouw profiel (klik rechtsboven op je naam) en kies voor ‘Instellingen’.
    Let op: alleen iemand met een Realworks’ bedrijfsinstellingen-profiel kan deze stappen uitvoeren. 
  • Zoek naar ‘API’; als het goed is, komt de API Manger tevoorschijn.
  • Dubbelklik daarna op ‘Moving Digital – Datapoint’ en doorloop vervolgens stap 1 t/m stap 3.
  • Stap 1. Instellingen in de API Manager (zie ook onderstaand screenshot)
    a) Een pop-up met daarin ‘Relaties vrijgeven’ is geopend.
    Zet ‘Standaard vrijgave’ op “Vrijgave”.
    b) Zet ‘Vertraging’ op “Geen”.
    c) Zet alle vinkjes daaronder aan (alle particulieren bijwerken, alle bedrijven bijwerken, alle contactpersonen bijwerken).
  • Stap 2. Rechten vrijgeven (zie ook screenshot)
    In dezelfde pop-up zit een tabblad ‘Rechten’

    a) Zorg bij ‘Rechten’ dat alle onderdelen staan; alle rechtenniveaus die er voor jouw kantoor gelden.
    b) Zet achter ‘Dagen vanaf’ het getal “14”.
    c) Zet ‘Dagen tot’ het getal “14”.
    d) Vinkje bij ‘Iedereen’ inschakelen.
    e) Het vinkje bij ‘Prive’ mag uit blijven.
  • Stap 3.Objecten (inclusief prospects) vrijgeven (zie ook onderstaande screenshots)
    a) Ga naar ‘Instellingen’ (deze vind je terug rechtsboven, onder je gebruikersaccount -> bedrijfsinstellingen) en kies voor ‘Publicatie’ (of: typ ‘publicatie’ in de zoekbalk bovenin in, dan verschijnt het juiste veld vanzelf) en kies vervolgens ‘Instellingen vrijgave’.
    b) Bij het onderdeel ‘Moving Digital – Datapoint’, zet je de instelling daarachter op ‘Vrijgave’ én vertraging op ‘Geen’.
    c) Kies voor ‘Objecten bijwerken’; een andere een pop-up opent (eenzelfde als onderstaande screenshot)
    d) Schakel daar de vinkjes in, bij WONEN, BOG én NIEUWBOUW. (Of: alleen ‘Wonen’, als de andere opties n.v.t. zijn).
    e) Kies linksboven voor ‘Alles opslaan’, via het ‘opslaan’-icoontje.


Om de proefperiode van de Duurzaamheid Widget te activeren dient er in Realworks een API aangezet te worden.
Deze kan je vinden in de Marketplace:

  • Klik aan de linkerkant op Servicedesk –> Marketplace –> helemaal naar beneden scrollen naar API’s.
  • Hier kan je vervolgens de ‘API Wonen’ bestellen.
  • Je krijgt dan de vraag of je een developer ID kunt opgeven, dit is: 424bf268-7311-4621-a332-bf34aeed8577
  • Bij ‘weergavenaam’ kun je een zelfgekozen titel opgeven (ons advies: maak hier iets van ‘Duurzaamheidwidget’ van, zodat je dit altijd duidelijk kunt terugvinden). Deze komt op objectniveau, bij het tabblad marketing, erbij te staan zodat je kunt gaan vrijgeven per pand.
    (NB: De vrijgave per pand doe je op een later moment en altijd op het tabblad ‘Marketing’, op objectniveau. Daar staat de API (Duurzaamheidwidget) dan tussen, waarvan je de instelling op ‘vrijgave’ of op ‘wacht’ kunt zetten.)
  • Bij ‘contactpersoon’ dien je een contactpersoon in te vullen, je kunt de naam van jullie accountmanager, ‘Robbert Brouwer’ hiervoor gebruiken.
  • Onderaan heb je nog een kopje met ‘onroerend goed’ met daaronder een aantal opties.
    • Bij “object level’ staat de instelling standaard op ‘Basisgegevens’. Deze graag aanpassen naar ‘alle’.

Als je bovenstaande stappen hebt doorlopen ontvangen wij een melding van Realworks en kunnen wij er verder mee aan de slag!

From Delft with love!

Meer dan 1.500 makelaars halen voordeel uit onze oplossingen. Jij ook?

Kom in contact →