AI-woningbeschrijvingen

De AI-assistent in Tesoro CRM helpt u sneller woningbeschrijvingen te maken door vertaalde advertentieteksten te genereren en concurrerende merknamen uit geïmporteerde beschrijvingen te verwijderen. Beide functies zijn beschikbaar voor individuele woningen en in bulk via batchbewerkingen.

AI moet ingeschakeld zijn

Voordat u een AI-beschrijvingsfunctie kunt gebruiken, moet een beheerder AI inschakelen via Settings → My Company → AI Settings. Als AI is uitgeschakeld, wordt elk AI-verzoek afgewezen met de melding: “Your company has turned off the AI functionality.”

---

Woningbeschrijvingen vertalen

De AI-vertaalfunctie genereert woningtitels en -beschrijvingen in één of meerdere talen tegelijk. U opent deze functie vanuit het AI Translation-paneel op het bewerkingsformulier van de woning.

1. Open een woning en ga naar het bewerkingsformulier.

   Navigeer naar een woningrecord en klik op Edit. Het AI Translation-paneel verschijnt in het formulier, met een component genaamd AiTranslationForm.

2. Selecteer een prompttemplate.

   Gebruik de Choose Prompt-dropdown bovenaan het AI-paneel. Deze dropdown toont alle prompttemplates van het type “Translation” die zijn aangemaakt in Settings → AI Prompt. Alleen templates met een niet-lege prompttekst worden getoond.

3. Controleer en bewerk de prompt.

   Zodra u een template selecteert, verschijnt de prompttekst in de rich text editor hieronder. Als de template placeholder-tags gebruikt, worden deze automatisch vervangen door werkelijke waarden:

   Placeholder	Vervangen door
   {{ ai.source_language }}	De naam van de geselecteerde brontaal
   {{ ai.target_language }}	De namen van alle geselecteerde doeltalen
   {{ property.title }}	De huidige woningtitel
   {{ property.description }}	De huidige woningbeschrijvingstekst

   U kunt de prompttekst vrij bewerken voordat u deze naar de AI stuurt.

4. Schakel optioneel aanvullende context in.

   Klik op de huisicoon-knop in de rechterbovenhoek van het AI-paneel om aanvullende context in of uit te schakelen. Wanneer aanvullende context is ingeschakeld (de knop wordt blauw), ontvangt de AI extra woninggegevens naast uw prompt om nauwkeurigere beschrijvingen te produceren.

   De aanvullende context bevat deze woningvelden (wanneer ze waarden bevatten):

   • Woningtype (appartement, villa, perceel, etc.)
   • Aantal slaapkamers, badkamers en toiletten
   • Verdieping en verdiepingsnummer
   • Prijs en valuta
   • Staat
   • Type uitzicht
   • Kenmerken en extra voorzieningen
   • Nieuwbouwstatus
   • Kadastrale gegevens

   Wanneer aanvullende context gebruiken

   Schakel aanvullende context in wanneer u wilt dat de AI een beschrijving vanaf nul schrijft of een dunne advertentie verrijkt. Als u alleen een eenvoudige vertaling van bestaande tekst nodig hebt, kunt u het uitgeschakeld laten.

5. Kies uw bron- en doeltalen.

   Selecteer de brontaal (de taal van uw huidige inhoud) uit de eerste dropdown. Selecteer vervolgens één of meer doeltalen uit de multi-select dropdown. De AI genereert een aparte titel en beschrijving voor elke doeltaal.

6. Klik op Send.

   De AI verwerkt uw verzoek en retourneert vertalingen. Een succesmelding bevestigt wanneer de beschrijvingen zijn gegenereerd.

7. Controleer de gegenereerde inhoud.

   Nadat de AI heeft geantwoord, verschijnt er een Description-sectie onder het formulier. Gebruik de taaldropdown om te wisselen tussen de gegenereerde vertalingen. Elke vertaling bevat een Title- en Description-veld dat u kunt bewerken.

8. Klik op Insert om op te slaan.

   Als u tevreden bent met een vertaling, klik dan op Insert om de gegenereerde titel en beschrijving toe te passen op het woningrecord. Dit werkt de advertentie-inhoud van de woning bij voor de geselecteerde taal.

---

Merknamen verwijderen uit woningbeschrijvingen

Wanneer u woningbeschrijvingen importeert van andere portalen of concurrerende kantoren, bevatten die beschrijvingen vaak verwijzingen naar de oorspronkelijke kantoornaam, platformnaam of contactinstructies die niet in uw advertenties thuishoren. De unbrandingfunctie verwijdert deze verwijzingen automatisch.

Unbranding is beschikbaar via de batchupdate-functie op de woningoverzichtspagina, niet als een knop op individuele woningrecords.

1. Ga naar het Property-overzicht.

   Navigeer naar de hoofdwoningenlijst in het CRM.

2. Selecteer de woningen die u wilt ontdoen van merknamen.

   Gebruik de selectievakjes om één of meer woningen te selecteren. U kunt alle woningen op de huidige pagina selecteren of specifieke woningen kiezen.

3. Open het batchupdate-paneel en kies Unbrand.

   Selecteer in het batchbewerkingsgedeelte Unbrand als actieoptie.

4. Selecteer een unbrand-prompttemplate.

   Kies een AI-prompttemplate van het type “Unbrand” uit de dropdown. Deze template vertelt de AI naar welk soort branding moet worden gezocht en wat verwijderd moet worden.

5. Voer de batchbewerking uit.

   Verzend de batchupdate. Het systeem plaatst een unbrandingtaak in de wachtrij voor elke geselecteerde woning. U ziet een informatiemelding: “Unbranding in progress.”

   De AI verwerkt elke woningbeschrijving op de achtergrond en verwijdert vermeldingen van andere makelaarskantoren, platformen en neem-contact-op-instructies, terwijl alle woninggerelateerde informatie intact blijft.

Unbranding behoudt HTML

Als uw woningbeschrijvingen HTML-opmaak bevatten (koppen, alinea’s, lijsten, vetgedrukte tekst, links), behoudt de AI alle HTML-tags en -attributen. Alleen de tekstinhoud binnen de tags wordt aangepast.

---

AI-prompttemplates beheren

Prompttemplates zijn de instructies die bepalen wat de AI genereert. U beheert ze via Settings → AI Prompt.

Beheerderstoegang vereist

De AI Prompt-instellingenpagina vereist de Admin-rol en een actief abonnement.

Templatestructuur

Elke prompttemplate heeft de volgende velden:

Veld	Beschrijving	Limieten
Title	Een korte naam om de template te identificeren	3 tot 100 tekens
Prompt	De instructietekst die naar de AI wordt gestuurd	3 tot 8.000 tekens
Type	Translation of Unbrand	Verplicht
Group	De groep waartoe deze template behoort	Verplicht (de groep moet bestaan)
Additional Context	Of extra woninggegevens moeten worden meegestuurd	Aan of uit (standaard uit)

Templates organiseren in groepen

Templates worden georganiseerd in groepen om ze overzichtelijk te houden. U kunt groepen aanmaken, hernoemen en verwijderen vanuit de AI Prompt-instellingenpagina. Elke template moet tot een groep behoren — u kunt geen template aanmaken zonder er een te selecteren.

Werken met templates

Aanmaken

Klik op de aanmaakknop op de AI Prompt-instellingenpagina. Vul de titel in, selecteer een groep, kies het type (Translation of Unbrand) en schrijf uw prompt. U kunt aanvullende context in- of uitschakelen. Klik op Save om de template aan te maken.

Bewerken

Klik op een template om deze te bekijken en klik vervolgens op Edit. U kunt de titel, prompttekst, groep en aanvullende-contextinstelling wijzigen. Het type kan na aanmaak niet meer worden gewijzigd.

Dupliceren

Selecteer een template en gebruik de Duplicate-actie om een kopie te maken. Dit is handig wanneer u een variatie op een bestaande prompt wilt maken zonder helemaal opnieuw te beginnen.

Verwijderen

Selecteer één of meer templates en gebruik de Delete-actie. Verwijderde templates worden soft-deleted en kunnen mogelijk worden hersteld.

---

Batchvertaling

Naast het vertalen van individuele woningen kunt u beschrijvingen voor meerdere woningen tegelijk vertalen via de batchupdate-functie vanuit het woningoverzicht.

1. Selecteer woningen uit de woningenlijst met de selectievakjes.

2. Kies Translation als batchactie-optie.

3. Selecteer een vertaalprompttemplate en configureer de bron- en doeltalen.

4. Verzend de batchbewerking. Het systeem plaatst een vertaaltaak in de wachtrij voor elke geselecteerde woning. U ziet een informatiemelding: “Translation in progress.”

De batchvertaling verwerkt woningen op de achtergrond via dezelfde AI-pipeline als individuele vertalingen.

---

Hoe vertaling achter de schermen werkt

Wanneer u een vertaalverzoek verstuurt, gebeurt het volgende:

1. Het systeem controleert of AI is ingeschakeld voor uw bedrijf. Zo niet, dan wordt het verzoek afgewezen.
2. Uw prompttekst, brontaal en doeltalen worden naar de AI-provider gestuurd (OpenAI, DeepSeek of OpenRouter, afhankelijk van de systeemconfiguratie).
3. Als aanvullende context is ingeschakeld, laadt het systeem het woningrecord en voegt belangrijke woningvelden als gestructureerde data toe aan de prompt.
4. De AI retourneert een JSON-array met een vertaalde titel en beschrijving voor elke gevraagde taal.
5. Het antwoord wordt in het CRM weergegeven zodat u het kunt controleren, bewerken en invoegen.

De AI krijgt de instructie om eventuele HTML-opmaak in de oorspronkelijke inhoud te behouden, gestructureerde JSON-output te retourneren en nooit eigen commentaar of uitleg in het antwoord op te nemen.

---

Volgende stap

Leer hoe het geautomatiseerde leadverwerkingssysteem leads vastlegt en aanmaakt vanuit e-mails van woningportalen.

AI-leadverwerking Hoe Tesoro CRM automatisch leads extraheert uit inkomende e-mails van woningportalen met behulp van AI.