Vraagzijde



Inschrijfformulier zoekers

Het is mogelijk om op je website inschrijfformulieren voor zoekers te implementeren waarmee automatisch een zoekprofiel in het Yes-co systeem aangemaakt wordt. De zoeker kan op het formulier precies aangeven wat zijn/haar wensen zijn.

Op welke websites?
De inschrijfformulieren voor zoekers zijn te gebruiken op iedere website waarbij de gebruiker zelf HTML kan plaatsen of kan laten plaatsen. Hierbij valt bijvoorbeeld te denken aan:

  • WordPress website
  • Andere CMS gebaseerde website
  • Google sites

Werking
Nadat een inschrijfformulier vanaf de website verzonden is, komt deze binnen in het Yes-co systeem als een geavanceerd soort e-mail bericht. Het inschrijfformulier voor zoekers wordt getoond in de ‘ongekoppelde dossier items container’ op de home pagina.
Het inschrijfformulier kan nu geopend, verwerkt of verwijderd worden.

Verwerken
Door het verwerken van het inschrijfformulier wordt automatisch een zoekopdracht aangemaakt waarbij de ingegeven voorkeuren verwerkt zijn. Verder kan je ook bepalen welke tags er aan de relatie of een project komen te hangen. Wanneer de project_tags of relation_tags in het formulier voorkomen worden deze standaard al geselecteerd.
Bij het verwerken van een formulier worden dus de volgende zaken geregeld:

  • Het project voor de zoekopdracht  wordt automatisch aangemaakt
  • Eventuele project_tags worden gekoppeld aan het gekoppelde project
  • Eventuele relation_tags worden gekoppeld aan de gekoppelde relatie

Na het verwerken is het formulier verdwenen uit de ‘ongekoppelde dossier items’ en staat in het tabblad ‘ Overzichten’ onder ‘ Formulier/e-mail’ onder verwerkte formulieren. Je kan hierbij op datum van het formulier selecteren.

In het tabblad ‘Overzichten’  kan je ook een overzicht krijgen van de onverwerkte formulieren.

Stappen
Om een inschrijfformulier voor zoekers op een website te gaan gebruiken, dienen de volgende stappen doorlopen te worden:

  1. Het zoeksysteem moet zijn ingeschakeld in je Yes-co systeem
  2. Bij het activeren van de inschrijfformulieren voor zoekers applicatie in de App Market, heb je een Yes-co key ontvangen. Deze key zorgt ervoor dat het formulier bij het desbetreffende Yes-co systeem wordt afgeleverd. Je moet zelf de Yes-co key op de juiste plek in het voorbeeld formulier plaatsen (zie het voorbeeldformulier hieronder)
  3. Maak indien gewenst het formulier op in je eigen huisstijl (dit kan bijvoorbeeld je designer voor je doen)
  4. Plaats de HTML van gemaakte formulier op website (eventueel velden als bijvoorbeeld project_id dynamisch laten vullen)

Opbouw formulier

Een formulier bestaat uit plain HTML. Voordat een voorbeeld formulier getoond wordt, zie je hieronder eerst een beschrijving van de velden waaruit een formulier kan bestaan:

 

NaamStandaard waardeBeschrijving
yesco_keyKey van het Yes-co systeem
developer_modefalsedeveloper_mode false Te gebruiken om formulier te testen. Als dit op true staat, wordt er na het versturen een overzicht getoond van eventuele fouten. Het formulier wordt niet opgeslagen!
thank_you_pageURL van formulierPagina om te tonen na versturen van het formulier. Indien niet opgegeven wordt de gebruiker terug gestuurd naar de URL waar het formulier staat.
titleTitel van het formulier
tags[]tags die aan het formulier gekoppeld moeten worden
project_tags[]tags die aan het bijbehorende project gekoppeld dienen te worden
relation_tags[]tags die aan de bijbehorende relatie gekoppeld dienen te worden.
sourceWebsiteHet systeem waarop het formulier staat.
office[api-object-id]API Object ID van vestiging
person[lastname]Achternaam van de relatie
person[firstname]Voornaam van de relatie
person[email]E-mail adres van de relatie
searchprofile[city][]plaatsnamen waarbinnen gezocht kan worden
searchprofile[price-min]Minimum vraagprijs
searchprofile[price-max]Maximale vraagprijs
searchprofile[woonhuis][soort][Soort woonhuis
searchprofile[woonhuis][type][]Type woonhuis
searchprofile[woonhuis][kenmerk][]Kenmerk woonhuis
searchprofile[appartement][soort][]Soort appartement
searchprofile[bouwjaar-min]Bouwjaar vanaf
searchprofile[bouwjaar-max]Bouwjaar t/m
searchprofile[aantalkamers]Minimum aantal kamers
searchprofile[woonoppervlakte]Minimale woonoppervlakte
searchprofile[perceeloppervlakte]Minimale perceeloppervlakte
searchprofile[tuin]Aanwezigheid tuin (1 = ja, 0 = geen, leeg = geen voorkeur)
searchprofile[tuin]Aanwezigheid garage (1 = j 0 = geen, leeg= gen voorkeur)
searchprofile[einddatum]Eind datum (dd-mm-YYYY) van zoekprofiel. Zoeker wordt dan automatisch uitgeschreven.
searchprofile[opmerkingen]Vrije invoer voor additionele woonwensen


Spam validatie
Om spam te voorkomen kunnen de formulieren enkel verstuurd worden als de cliënt javascript ondersteuning heeft. Desgewenst kan de HTML van het formulier aangepast worden zodat er geen javascript ondersteuning nodig is om het formulier te versturen, dit is echter geheel op eigen risico.

Voorbeeld formulier

Hieronder wordt een voorbeeld formulier getoond met bijbehorende HTML. Je kan deze HTML kopiëren en gebruiken of zelf de HTML aanpassen.

——————————————————————————————————————-
<form method=”post” action=”#” onsubmit=”this.action = ‘http://api.yes-co.com/1.0/response’;”>

<!– Yes-co systeem key, te genereren in App Market, verplicht! –>
<input type=”hidden” name=”yesco_key” value=””>

<!– Gebruik developer_mode om de werking van het formulier te checken –>
<input type=”hidden” name=”developer_mode” value=”true”>

<!– De pagina die getoond moet worden na het versturen van het formulier –>
<input type=”hidden” name=”thank_you_page” value=”https://www.yes-co.nl”>

<!– De titel van het formulier –>
<input type=”hidden” name=”title” value=”Test formulier”>

<!– De tags die aan het gekoppelde project gehangen moeten worden –>
<input type=”hidden” name=”project_tags” value=”vul waarde in”>

<!– De tags die standaard aan de gekoppelde relatie gehangen moeten worden –>
<input type=”hidden” name=”relation_tags[]” value=”via website”>

<!– De afkomst van het formulier –>
<input type=”hidden” name=”source” value=”Website”>

<!– De einddatum van de zoekopdracht –>
<input type=”hidden” name=”searchprofile[einddatum]” value=”31-12-2011″>

<!– Begin voornaam van relatie –>
<div>
<label>Voornaam:</label>
<input type=”text” name=”person[firstname]” value=””>
</div>
<!– Einde achternaam van relatie –>

<!– Begin achternaam van relatie –><
<div>
<label>Achternaam:</label>
<input type=”text” name=”person[lastname]” value=””>
</div>
<!– Einde achternaam van relatie –>

<!– Begin e-mail adres van relatie –>
<div>
<label>E-mail:</label>
<input type=”text” name=”person[email]” value=””>
</div>
<!– Einde e-mail adres van relatie –>

<!– Begin plaatsnamen binnen zoekgebied –>
<div>
<label>Plaatsen:</label>
<select name=”searchprofile[city][]” multiple size=”3″>
<option value=”ALKMAAR”>ALKMAAR</option>
<option value=”AMSTERDAM”>AMSTERDAM</option>
</select>
</div>
<!– Einde plaatsnamen binnen zoekgebied –>

<!– Begin Minimum vraagprijs –>
<div>
<label>Prijs vanaf:</label>
<select name=”searchprofile[price-min]”>
<option value=”0″>0</option>
<option value=”50000″>50.000</option>
<option value=”75000″>75.000</option>
<option value=”100000″>100.000</option>
<option value=”125000″>125.000</option>
<option value=”150000″>150.000</option>
<option value=”175000″>175.000</option>
<option value=”200000″>200.000</option>
<option value=”225000″>225.000</option>
<option value=”250000″>250.000</option>
<option value=”275000″>275.000</option>
<option value=”300000″>300.000</option>
<option value=”325000″>325.000</option>
<option value=”350000″>350.000</option>
<option value=”375000″>375.000</option>
<option value=”400000″>400.000</option>
<option value=”450000″>450.000</option>
<option value=”500000″>500.000</option>
<option value=”550000″>550.000</option>
<option value=”600000″>600.000</option>
<option value=”650000″>650.000</option>
<option value=”700000″>700.000</option>
<option value=”750000″>750.000</option>
<option value=”800000″>800.000</option>
<option value=”900000″>900.000</option>
<option value=”1000000″>1.000.000</option>
<option value=”1250000″>1.250.000</option>
<option value=”1500000″>1.500.000</option>
<option value=”2000000″>2.000.000</option>
</select>
</div>
;<!– Einde Minimum vraagprijs –>

<!– Begin Maximum vraagprijs –>
<div>
<label>Prijs tot:</label>
<select name=”searchprofile[price-max]”>
<option value=”0″>0</option>
<option value=”50000″>50.000</option>
<option value=”75000″>75.000</option>
<option value=”100000″>100.000</option>
<option value=”125000″>125.000</option>
<option value=”150000″>150.000</option>
<option value=”175000″>175.000</option>
<option value=”200000″>200.000</option>
<option value=”225000″>225.000</option>
<option value=”250000″>250.000</option>
<option value=”275000″>275.000</option>
<option value=”300000″>300.000</option>
<option value=”325000″>325.000</option>
<option value=”350000″>350.000</option>
<option value=”375000″>375.000</option>
<option value=”400000″>400.000</option>
<option value=”450000″>450.000</option>
<option value=”500000″>500.000</option>
<option value=”550000″>550.000</option>
<option value=”600000″>600.000</option>
<option value=”650000″>650.000</option>
<option value=”700000″>700.000</option>
<option value=”750000″>750.000</option>
<option value=”800000″>800.000</option>
<option value=”900000″>900.000</option>
<option value=”1000000″>1.000.000</option>
<option value=”1250000″>1.250.000</option>
<option value=”1500000″>1.500.000</option>
<option value=”2000000″>2.000.000</option>
</select>
</div>
<!– Einde Maximum vraagprijs –>

<!– Begin Soort woonhuis –>
<div>
<label>Soort woonhuis</label>
<select name=”searchprofile[woonhuis][soort][]” multiple size=”3″>
<option value=”bungalow”>Bungalow</option>
<option value=”eengezinswoning”>Eengezinswoning</option>
<option value=”grachtenpand”>Grachtenpand</option>
<option value=”herenhuis”>Herenhuis</option>
<option value=”landgoed”>Landgoed</option>
<option value=”landhuis”>Landhuis</option>
<option value=”stacaravan”>Stacaravan</option>
<option value=”villa”>Villa</option>
<option value=”woonboerderij”>Woonboerderij</option>
<option value=”woonboot”>Woonboot</option>
<option value=”woonwagen”>Woonwagen</option>
</select>
</div>
<!– Einde Soort woonhuis –>

<!– Begin Type woonhuis –>
<div>
<label>Type woonhuis</label>
<select name=”searchprofile[woonhuis][type][]” multiple size=”3″>
<option value=”2-onder-1-kapwoning”>2-onder-1-kapwoning</option>
<option value=”eindwoning”>Eindwoning</option>
<option value=”geschakelde 2-onder-1-kapwoning”>Geschakelde 2-onder-1-kapwoning</option>
<option value=”geschakelde woning”>Geschakelde woning</option>
<option value=”halfvrijstaande woning”>Halfvrijstaande woning</option>
<option value=”hoekwoning”>Hoekwoning</option>
<option value=”tussenwoning”>Tussenwoning</option>
<option value=”vrijstaande woning”>Vrijstaande woning</option>
</select>
</div>
<!– Einde Type woonhuis –>

<!– Begin Kenmerk woonhuis –>
<div>
<label>Kenmerk woonhuis</label>
<select name=”searchprofile[woonhuis][kenmerk][]” multiple size=”3″>
<option value=”bedrijfs- of dienstwoning”>Bedrijfs- of dienstwoning</option>
<option value=”dijkwoning”>Dijkwoning</option>
<option value=”drive-in woning”>Drive-in woning</option>
<option value=”hofjeswoning”>Hofjeswoning</option>
<option value=”kwadrantwoning”>Kwadrantwoning</option>
<option value=”paalwoning”>Paalwoning</option>
<option value=”patiowoning”>Patiowoning</option>
<option value=”semi-bungalow”>Semi-bungalow</option>
<option value=”split-level woning”>Split-level woning</option>
<option value=”waterwoning”>Waterwoning</option>
<option value=”wind/watermolen”>Wind/watermolen</option>
</select>
</div>
<!– Einde Kenmerk woonhuis –>

<!– Begin Soort appartement –>
<div>
<label>Soort appartement</label>
<select name=”searchprofile[appartement][soort][]” multiple size=”3″>
<option value=”beneden + bovenwoning”>Beneden + bovenwoning</option>
<option value=”benedenwoning”>Benedenwoning</option>
<option value=”bovenwoning”>Bovenwoning</option>
<option value=”galerijflat”>Galerijflat</option>
<option value=”maisonnette”>Maisonnette</option>
<option value=”penthouse”>Penthouse</option>
<option value=”portiekflat”>Portiekflat</option>
<option value=”portiekwoning”>Portiekwoning</option>
</select>
</div>
<!– Einde Soort appartement –>

<!– Begin Bouwjaar vanaf –>
<div>
<label>Min bouwjaar</label>
<input type=”text” value=”” name=”searchprofile[bouwjaar-min]” maxlength=”4″>
</div>
<!– Einde Bouwjaar vanaf –>

<!– Begin Bouwjaar t/m –>
<div>
<label>Max bouwjaar</label>
<input type=”text” value=”” name=”searchprofile[bouwjaar-max]” maxlength=”4″>
</div>
<!– Einde Bouwjaar t/m –>

<!– Begin Minimum aantal kamers –>
<div>
<label>Min aantal kamers</label>
<input type=”text” value=”” name=”searchprofile[aantalkamers]” maxlength=”2″>
</div>
<!– Einde Minimum aantal kamers –>

<!– Begin Minimale woonoppervlakte –>
<div>
<label>Min woonoppervlakte</label>
<input type=”text” value=”” name=”searchprofile[woonoppervlakte]” maxlength=”3″>
</div>
<!– Einde Minimale woonoppervlakte –>

<!– Begin Minimale perceeloppervlakte –>
<div>
<label>Min perceeloppervlakte</label>
<input type=”text” value=”” name=”searchprofile[perceeloppervlakte]” maxlength=”3″>
</div>
<!– Einde Minimale perceeloppervlakte –>

<!– Begin Aanwezigheid tuin –>
<div>
<label>Tuin</label>
<select name=”searchprofile[tuin]”>
<option value=””>Geen voorkeur</option>
<option value=”ja”>Ja</option>
<option value=”nee”>Nee</option>
</select>
</div>
<!– Einde Aanwezigheid tuin –>

<!– Begin Aanwezigheid garage –>
<div>
<label>Garage</label>
<select name=”searchprofile[garage]”>
<option value=””>Geen voorkeur</option>
<option value=”ja”>Ja</option>
<option value=”nee”>Nee</option>
</select>
</div>
<!– Einde Aanwezigheid garage –>

<!– Begin Vrije invoer voor additionele woonwensen –>
<div>
<label>Opmerkingen:</label>
<textarea name=”searchprofile[opmerkingen]”></textarea>
</div>
<!– Einde Vrije invoer voor additionele woonwensen –>

<!– Begin knop om formulier te versturen –>
<div>
<input type=”submit” value=” Versturen “>
</div>
</form>
<!– Start javascript to validate the form –>
<script type=”text/javascript” src=”http://api.yes-co.com/1.0/embed/js/response-forms.js”></script>

</div>

</body></html>

——————————————————————————————————————-


Zoekprofielen

Via het tabblad Vraagzijde kun je, naast het geautomatiseerd aanmaken via een webformulier, ook handmatig nieuwe zoekers aanmaken (bijvoorbeeld rechtstreeks tijdens een telefoongesprek met een geïnteresseerde nieuwe klant).

Klik hiervoor op ‘zoekprofiel aanmaken’ en vul vervolgens alle velden in. Je hebt hierbij de keuze voor ‘automatisch’ of ‘maatwerk’. Als je voor automatisch kiest, zal het systeem zelf geschikte projecten matchen en versturen. Wil je liever nog even controleren of het gematchte aanbod echt bij jouw klant past en dit vervolgens laten versturen, dan kun je kiezen voor maatwerk.

Als je een zoekprofiel hebt ingevoerd, wil je graag direct zien welk actueel aanbod hierbij matcht en dit eventueel meegeven.

Op basis van de ingevoerde wensen wordt binnen het zoekprofiel in het tabblad Vraagzijde direct de actuele zoekresultaten getoond. Door alle objecten of een deel hiervan te selecteren kan je direct de detaillijst uitdraaien of een export maken. Geef de resultaten hiervan direct aan je klant mee.

Update 2017: Recentelijk zijn er een aantal nieuwe zoekvelden toegevoegd aan het tabblad Woonruimte in het zoekprofiel. Dit zijn: bijzonderheden, ligging, onderhoud binnen en buiten, verwarming, aantal slaapkamers en recreatiewoning. Op deze nieuwe variabelen reageert de actuele zoekresultaten nog niet. Dit zal later volgen.

 

Beëindigen zoekopdracht:

Door een einddatum in te vullen in het tabblad Algemeen bij de zoeker stopt de opdracht per die datum.


Zoeken in vraagzijde

Als je een zoekprofiel hebt ingevoerd, wil je graag direct zien welk actueel aanbod hierbij matcht en dit eventueel meegeven.

Op basis van de ingevoerde wensen wordt binnen het zoekprofiel in het tabblad Vraagzijde direct de actuele zoekresultaten getoond. Door alle objecten of een deel hiervan te selecteren kan je direct de detaillijst uitdraaien of een export maken. Geef de resultaten hiervan direct aan je klant mee.

Update 2017: Recentelijk zijn er een aantal nieuwe zoekvelden toegevoegd aan het tabblad Woonruimte in het zoekprofiel. Dit zijn: bijzonderheden, ligging, onderhoud binnen en buiten, verwarming, aantal slaapkamers en recreatiewoning. Op deze nieuwe variabelen reageert de actuele zoekresultaten nog niet. Dit zal later volgen.