20 · Brieven aan het eerste kantoor en aan Realworks

Twee teksten die alleen E kan versturen, klaar om in te vullen. Herzien op R18 §8 (E's besluiten: nooit om de makelaar heen én nooit gegevens van bewoners of bezoekers; het fangetal deelt alleen de eigenaar; makelaar-matching, niet om prijs). Geen juridisch advies; de deelafspraak zelf gaat eerst naar de jurist (R21).

Keuring door de regie (24 september, avond)

Geschreven door een Opus-agent in opdracht van de research-sessie, gekeurd door de regie · 24 september 2026 · op basis van R17 (§1.1, §2, §3.6, §5, §5.1, §8), R18 (§2.2 tot en met §2.4, §3.3, §5, §7, §8) en OVERDRACHT §4. Tussen rechte haken: in te vullen door E.

A · Aan het eerste kantoor

De mail (Van Doorn Makelaardij, Poortstraat 49)

Onderwerp: Een app in Wittevrouwen die nooit om de makelaar heen gaat

Geachte [naam contactpersoon],

Mi casa su casa gaat nooit om de makelaar heen, en geeft nooit gegevens van bewoners door. Dat zet ik voorop, omdat ik u vraag om iets waar u terecht zuinig op bent: uw aanbod.

Ik ben [voornaam achternaam], [functie] van Mi casa su casa in Utrecht. Wij bouwen een app waarin een huis met zijn bewoner praat, over zijn stenen, zijn straat en zijn geschiedenis. Wie een huis mooi vindt, geeft het een hart, ook als het niet te koop staat. Een prijs of een waarde noemen wij nooit. Dat is uw vak.

Wij beginnen in Wittevrouwen, en u zit daar midden in, aan de Poortstraat. Daarom schrijf ik u als eerste.

Wat het u oplevert, in het kort. Op de dag dat u een woning online zet, horen de mensen die dat huis bewaarden het, met een link naar uw eigen site. Staat een huis via u te koop, dan loopt elke reactie via u. En later: een eigenaar die aan verkopen denkt, leest de voorstellen van kantoren die zijn buurt kennen, en kiest zelf. Niet om prijs.

In de proefperiode kost het u niets, en wij rekenen nooit per adres of per aanvraag. De voorwaarden daarna spreken we samen af.

Eerlijk is eerlijk: wij staan aan het begin, en het publiek in de buurt bouwen wij nu op. Daarom vraag ik geen geld en geen exclusiviteit. Ik zoek één kantoor in Oost dat drie maanden met ons meedoet, en na zes weken samen met ons de aantallen bekijkt.

Alles staat op één pagina: [link naar de één-pagina]

Mag ik een half uur bij u langskomen? Ik pas mij aan uw agenda aan.

Met vriendelijke groet,

[voornaam achternaam] Mi casa su casa, Utrecht [telefoon] · [e-mailadres]

Variant-alinea voor Molenbeek Makelaars (Emmalaan 39)

Vervangt de derde alinea ("Wij beginnen in Wittevrouwen …"). Richt de mail aan de vestiging Utrecht.

Wij beginnen in Utrecht-Oost, rond het Wilhelminapark. U zit om de hoek, aan de Emmalaan, en kent die straten als geen ander. Daarom schrijf ik u als eerste.

De één-pagina

Een huis dat praat, en nooit om u heen gaat

Voorstel aan makelaars in Utrecht-Oost · concept, september 2026

Wat Mi casa is Een app waarin een huis met zijn bewoner praat, over zijn stenen, zijn straat en zijn geschiedenis. Wie een huis mooi vindt, geeft het een hart, ook als het niet te koop staat; alleen de eigenaar ziet hoeveel, nooit wie. Een prijs of waarde noemen wij nooit: dat is uw vak.

Wat u krijgt

  1. Wij gaan nooit om u heen en geven nooit gegevens van bewoners door. Staat een huis via u te koop, dan loopt elke reactie via uw advertentie. Niemand krijgt van ons gegevens over eigenaren, bezoekers of gesprekken, u ook niet. Vastgelegd in de app en in de afspraak.
  2. De eigenaar kiest zelf zijn makelaar. Later: denkt een eigenaar aan verkopen, dan stellen kantoren die zijn buurt kennen zich voor. Hij kiest, niet om prijs en zonder ranglijst. Pas na zijn keuze weet u wie hij is.
  3. Het vel bij de sleutel. Bij de overdracht geeft u de koper een A5-vel over zijn huis; wij drukken het. Kiest hij zelf mijn makelaar, dan onthoudt het huis dat.
  4. Warm publiek naar uw eigen site. Op uw publicatiedag krijgen mensen die het huis bewaarden één bericht, met uw naam en een link naar uw site. U ziet hoe vaak er is doorgeklikt, vanaf vijf. Hoeveel mensen van een huis dromen, weet alleen de eigenaar; dat vertelt hij u zelf, als hij wil.
  5. Geen kosten in de proef. Nooit per adres of per aanvraag. Wat uw software voor de koppeling rekent, betalen wij tijdens de proef. De voorwaarden daarna spreken we samen af.

Wat wij nooit doen

Wat wij u vragen

  1. Zet ons aan in uw software. In Realworks: de Wonen API bestellen in de Marketplace, ons developer-ID invullen en per woning vrijgeven, alle standen tot en met verkocht. Geen koppeling? Dan vult u het met de hand in.
  2. Meld uw verkopers dat hun woning ook via Mi casa zichtbaar wordt; wij leveren de zin. Zegt iemand nee, zet dan die vrijgave uit.
  3. Toestemming voor uw naam en logo bij het huis.
  4. Geef het vel mee bij de sleutel.

De eerste stap Drie maanden als eerste kantoor in Oost. Eerst een gesprek, daarna de afspraak op papier. Na zes weken bekijken we samen de aantallen.

Stoppen kan altijd. Zet ons uit; binnen 24 uur staat niets meer van uw aanbod bij ons.

B · Aan Realworks

De mail

Aan: info@realworks.nl (of het contact in het Realworks Developers Portal) Onderwerp: Developer-ID voor de Wonen API v3 en vragen over Connected Partner

Geachte heer, mevrouw,

Wij zijn Mi casa su casa uit Utrecht ([bedrijfsnaam], KvK [nummer]): een app waarin bewoners hun huis volgen. Staat een huis dat iemand bewaarde via een makelaar te koop, dan melden wij dat op de publicatiedag, met een link naar de advertentie.

Wij ontvangen alleen adres, status, statusdatum, publicatiedatum en link. Geen foto's, prijzen, teksten of relatiegegevens, en wij schrijven niets terug. De makelaar geeft ons vrij per kantoor in de API Manager en per woning via de publicatie. Wij willen de Wonen API v3 gebruiken, met webhook.

Wij vragen graag een developer-ID aan. Onze vragen:

  1. Is registratie op developers.realworks.nl genoeg voor een developer-ID, of keurt u ons account eerst goed? Wat hebt u van ons nodig?
  2. Wat zijn de voorwaarden om Connected Partner te worden, en wat kost dat ons?
  3. Wat betaalt een makelaar voor de Wonen API en voor de activatie? Is dat anders bij een Connected Partner?
  4. Welk niveau van vrijgave is genoeg voor alleen de vijf gegevens hierboven?
  5. Levert de Wonen API de URL van de advertentie op de site van de makelaar mee?
  6. Hoe komt "ingetrokken" door: als status, of verdwijnt het object?
  7. Zijn webhooks ondertekend, en zo ja, hoe controleren wij dat?

Wie is bij u ons aanspreekpunt voor deze vragen?

Met vriendelijke groet,

[voornaam achternaam], [functie] Mi casa su casa, Utrecht [telefoon] · [e-mailadres]

Controlelijst voor E

  1. Eerst registreren op developers.realworks.nl (achter login), op naam van het bedrijf en met een vast mailadres van het bedrijf: daar komen straks de tokens. Staat het developer-ID daarna al in het Developer Dashboard, schrap dan vraag 1. Het ID zelf is geen geheim.
  2. Vooraf lezen: faq.realworks.nl/article/hoe-werkt-de-api-manager, …/waar-kan-ik-een-api-koppeling-bestellen en …/objecten-doorzetten-naar-atrium-database-van-vbo (een Connected Partner zonder kosten).
  3. Bij de hand: bedrijfsnaam, KvK-nummer, adres, het vaste mailadres, de site en deze mail.
  4. Versturen naar info@realworks.nl of via het contact in het portal; bellen kan op 020 412 0120.
  5. Vraagt Realworks om IP-adressen of een webhookadres: vraag die aan de regie, verzin ze niet.
  6. Nooit een token, wachtwoord of sleutel in een mail, chat, Trello-kaart of document plakken, ook niet voor de regie.
  7. Het token komt per mail zodra een makelaar ons aanzet. Laat het daar staan, stuur het niet door, en meld de regie alleen dát het er is. Het gaat alleen via het kluisscript (leest van het toetsenbord, nooit via een scherm) de kluis op de server in; dat script komt in fase 2.
  8. Nooit namens een makelaar in zijn Realworks werken: hij bestelt en geeft zelf vrij.
  9. Teken niets (Connected Partner, voorwaarden) voordat regie en jurist het zagen. Nooit akkoord met rekenen per adres, of met het ontvangen van prijzen, foto's of relatiegegevens.

Wat de agent zelf aanwees om na te kijken

  1. Open plekken: naam en functie van E, bedrijfsnaam en KvK, de contactpersoon bij het kantoor, en de link naar de één-pagina. Die pagina bestaat nog niet en moet zonder login te openen zijn: de makelaar heeft geen Authentik-account.
  2. (afgehandeld op 29-09, zie de keuring bovenaan) De agent wees erop dat twee zinnen advies waren uit R18 §7 en bevestiging van E nodig hadden. E besliste: matching wordt genoemd zonder juristenzin (P10); besluit 7 is een heroverweging (P11, open), en daarom staat er in de brief geen nul-kosten-belofte en geen jaartal meer.
  3. "Vastgelegd in de app" klopt pas als fase 0 staat (bieden en solliciteren uit bij makelaarsaanbod, het invoerscherm als "eenvoudige pagina"); "doorgeklikt, vanaf vijf" is fase 1. Staat dat er bij verzending niet, zet die zinnen in de toekomende tijd.
  4. Het vel bij de sleutel: R18 §2.2 punt 3 zet "de makelaar van toen" later bovenaan, maar §8.2 wil willekeurige volgorde en geen aanbevolen kantoor. Ik schreef alleen "het huis onthoudt dat"; wat die keuze later doet, beslist de regie.
  5. Realworks, nagelezen op 24-09 (realworks.nl/api en twee FAQ's): registratie lijkt zelfbediening op het portal, het token gaat per mail naar de ontwikkelaar, en de API Manager kent vrijgaveniveaus (basis-, object-, transactie- en relatiegegevens), vandaar vraag 4. Het portal zelf (achter login) en een apart adres voor ontwikkelaars zag ik niet; info@realworks.nl is het algemene adres. Dat Van Doorn Realworks gebruikt, is eigen controle (D, R17); het systeem van Molenbeek is onbekend. Daarom noemt de mail aan het kantoor geen systeem; de één-pagina noemt Realworks alleen als voorbeeld.