SlectoSlectoGuided selling
Start gratis
Slecto handleiding

Alles over Slecto, van eerste import tot automatische opvolging.

Deze documentatie is bedoeld als complete productgids voor gebruikers, beheerders en technische teams. Gebruik de inhoud om Slecto in te richten, keuzehulpen te bouwen, productadvies te verklaren, embeds te plaatsen en marketing op basis van intentie te starten.

Alles over Slecto staat hier bij elkaar, van eerste import tot automatische opvolging en dagelijkse optimalisatie.

Start gratisNaar dashboard
Slecto flowbuilder documentatie visual

In deze documentatie

StartenBegrippenDashboardProductdataFlowbuilderMatchingEmbedAnalyticsMarketingSecurityProblemen

Shopify Help Center

Werk taakgericht

Grote productdocs ordenen rond concrete admin-onderdelen en taken. Slecto gebruikt daarom secties per workflow: importeren, mappen, bouwen, publiceren, meten en opvolgen.

Bron openen

Intercom Help

Maak categorieën herkenbaar

Helpcenters werken met vaste categorieën zoals Getting Started, Reports, Apps & Integrations en Security. Slecto vertaalt dit naar dashboard, integraties, analytics, marketing en veiligheid.

Bron openen

Developer documentation patterns

Splits handleiding en referentie

Developer docs combineren gidsen met technische referentie. Daarom bevat deze pagina zowel stappenplannen als routes, API-endpoints, embed-snippets en datalagen.

Bron openen

Starten

De aanbevolen volgorde voor een werkende keuzehulp.

Slecto werkt het best wanneer productdata, mappings, flowlogica, publicatie en meting in deze volgorde worden opgebouwd.

1

Account en organisatie

Registreer, maak of kies je organisatie en controleer onder Instellingen de naam, website, branding, logo en toegang.

Open stap
2

Producten importeren

Koppel PrestaShop, WooCommerce of CSV. Slecto normaliseert titel, prijs, afbeelding, product-URL, categorie, attributes en features.

Open stap
3

Velden mappen

Vertaal bronvelden naar bruikbare adviesvelden zoals materiaal, kwaliteit, levertijd, isolatie, voorraadstatus of categorie.

Open stap
4

Keuzehulp bouwen

Maak vragen, antwoordroutes, regels, resultaatnodes, CTA's, result features en eventueel e-mail capture.

Open stap
5

Publiceren en embedden

Publiceer de keuzehulp, kopieer de embed-snippet en plaats deze inline, als popup-button of floating launcher in de webshop.

Open stap
6

Meten en opvolgen

Gebruik analytics, contactinbox, resultaatmails, audience, templates, campagnes en automations om te verbeteren.

Open stap

Begrippen

De woorden die overal in Slecto terugkomen.

Gebruik deze referentie wanneer je een scherm, flow, event of marketingonderdeel wilt begrijpen.

Organization

De tenant/workspace waarin alle producten, keuzehulpen, contacten, analytics en marketingdata staan.

Product source

Een gekoppelde catalogusbron zoals PrestaShop, WooCommerce of CSV.

Product

Een genormaliseerd artikel met titel, prijs, URL, afbeelding, categorie, attributes, features en actieve status.

Field mapping

Een vertaling van bronveld naar Slecto veld, zodat regels dezelfde data kunnen gebruiken.

Guide

Een keuzehulp of product finder met status draft, published of archived.

Flow node

Een bouwblok in de flowbuilder: start, info, question, condition, subflow, result, redirect of CTA.

Answer

Een antwoord of invoerveld binnen een vraag. Antwoorden kunnen routing en matchingregels activeren.

Rule

Een matchregel: filter, score, exclude, boost of tag.

Result feature

Extra resultaatlogica: note, badge of pin_product op basis van antwoord of productveld.

Embed key

Publieke sleutel waarmee de widgetroute en embedscript de juiste gepubliceerde keuzehulp laden.

Analytics event

Meetpunt zoals widget_view, guide_started, question_answered, guide_completed, product_clicked of result_email_requested.

Contact submission

Een ingevulde e-mail- of offerteaanvraag met antwoorden, flowpad, aanbevelingen en mailstatus.

Marketing profile

Een afgeleid contactprofiel over submissions heen met consent, leadscore, lifecycle en intentie.

Template

Een bewerkbare e-mail in Email Studio met blokken, tokens en preflight checks.

Campaign

Een eenmalige of geplande marketingmail naar mailbare profielen.

Automation

Een opvolgflow met triggers, conditions, waits, send email nodes, actions en exits.

Dashboard

Wat elk dashboardonderdeel doet.

Het dashboard is operationeel opgezet: eerst data en flows, daarna meten en opvolgen.

Open
Overzicht
Dagelijkse commandopost voor flows, leads, geplande campagnes en live activiteit.
  • Toont vandaag ingevulde flows, verzonden mails, geplande campagnes en actieve keuzehulpen of automations.
  • Bevat een kalender met contactmomenten, maildeliveries, geplande campagnes en relevante analytics-events.
  • Geeft snelle acties voor keuzehulp maken, producten importeren, campagne plannen en automation bouwen.
Open
Producten
Universele productlaag waar de matching engine op draait.
  • Producten komen uit PrestaShop, WooCommerce of CSV en worden opgeslagen per organisatie.
  • Belangrijke velden zijn titel, prijs, valuta, afbeelding, product-URL, categorie, merk, SKU, voorraadstatus en levertijd.
  • Attributes en features bewaren rijke brondata voor regels, scorelogica en productadvies.
  • Producten kunnen actief of inactief zijn. Inactieve producten worden niet aanbevolen.
Open
Keuzehulpen
Beheer alle adviesflows, statussen, builders, previews en embeds.
  • Elke keuzehulp heeft een titel, beschrijving, slug, embed key, thema, instellingen en flowdefinitie.
  • Je kunt bouwen, previewen, embedden, publiceren, archiveren, dupliceren en verwijderen.
  • Een gepubliceerde guide is publiek opvraagbaar via widget en embedscript.
Open
Audience submissions
Inbox voor bezoekers die hun e-mailadres of offertegegevens achterlaten.
  • Contact submissions bevatten e-mail, consent, antwoorden, antwoorddetails, flowpad, aanbevelingen, result features en timing.
  • Mailstatussen tonen of resultaatmail of offertebevestiging is verzonden, mislukt of overgeslagen.
  • Exports zijn beschikbaar als CSV voor automation, CSV met recommendations, JSON en Excel XML.
Open
Marketing
Audience, templates, campaigns, automations en delivery rond guided-selling intentie.
  • Marketing bouwt profielen uit contact submissions en bewaakt consent en suppression.
  • Email Studio gebruikt Slecto-data zoals beste match, top 3 aanbevelingen en antwoord-samenvatting.
  • Automation Studio volgt bezoekers automatisch op met triggers, waits, conditions en e-mails.
Open
Mappings
Vertaal catalogusvelden naar stabiele adviesvelden.
  • Bronvelden komen uit productvelden, attributes en features.
  • Target fields zijn onder meer productType, qualityLevel, material, glassType, insulationLevel, stockStatus, deliverySpeed, customMade en category.
  • Transforms zijn none, lowercase, uppercase, boolean, number en split.
  • Display names bepalen hoe velden herkenbaar in de flow editor verschijnen.
Open
Integraties
Beheer bronnen, syncs en toekomstige commerce-koppelingen.
  • PrestaShop, WooCommerce en CSV zijn configureerbaar.
  • Shopify en Custom API staan voorbereid als toekomstige integraties.
  • Bronnen kunnen worden geactiveerd, gepauzeerd, geresynct of ontkoppeld.
Open
Instellingen
Organisatiebranding, e-maildelivery, teamtoegang en mailtemplates.
  • Beheer organisatienaam, website, logo, logozichtbaarheid, Slecto-branding en brand color.
  • Configureer resultaatmail, offertebevestiging, fallback SMTP of eigen SMTP accounts.
  • Owners en admins beheren leden, uitnodigingen en rollen.

Productdata en integraties

Slecto adviseert alleen goed als de catalogus goed staat.

Productdata vormt de basis voor matching. Importeer producten, normaliseer velden en maak mappings voordat je complexe flows bouwt.

PrestaShop
Vul shop URL, webservice API key, language ID en active-only instelling in. Test eerst de verbinding en start daarna een achtergrondimport.
WooCommerce
Vul shop URL, consumer key en consumer secret in. Credentials worden gebruikt om producten op te halen en later opnieuw te synchroniseren.
CSV
Plak CSV-inhoud, kies het scheidingsteken en start import. Handig voor testen, kleine catalogi of bronnen zonder API.
Importregels
Praktische afspraken voor betrouwbare productdata.
  • Gebruik echte productdata. Slecto vult dashboards en widgets niet met voorbeelddata.
  • Start met een beperkte categorie wanneer je de eerste keuzehulp bouwt.
  • Zet producten die niet aanbevolen mogen worden op inactief.
  • Controleer na import de preview, producttabel en mappingopties.
  • Gebruik mappings voor velden die meerdere namen of bronstructuren kunnen hebben.
  • Bewaar API keys en SMTP secrets nooit als publieke NEXT_PUBLIC variabelen.

Flowbuilder

Bouw advies alsof je een gesprek ontwerpt.

De flowbuilder gebruikt React Flow met nodes, edges, live test mode, undo/redo, subflows, result features en directe opslag naar de guide.

Start

Beginpunt van de widget.

Info

Uitleg, intro, tussenstap of context zonder directe matching.

Question

Vraag met single choice, multiple choice, boolean, range of text.

Condition

Vertakking op basis van gekozen antwoord of ingevulde vraagwaarde.

Subflow

Herbruikbare keuzehulp die inline binnen een andere flow wordt aangeroepen.

Result

Toont aanbevelingen uit de matching engine en kan e-mail capture of offerteaanvraag bevatten.

Redirect

Stuurt naar een externe URL, optioneel automatisch en met antwoorden in query parameters.

CTA

Losse actie naar product, offerte, contact of andere vervolgstap.

Vraagtypes
Kies het type dat past bij de beslissing van de bezoeker.
TypeGebruik
single_choice

Een bezoeker kiest precies een antwoord.

multiple_choice

Een bezoeker kan meerdere voorkeuren combineren.

boolean

Ja/nee keuze voor harde beslissingen.

range

Numerieke invoer zoals budget, maat, capaciteit of afstand.

text

Vrije tekst voor context of offerteaanvragen.

Resultaat en capture
Result nodes combineren advies, CTA en optionele formulierlogica.
  • ResultLimit bepaalt hoeveel producten standaard worden getoond.
  • Scores en redenen kunnen zichtbaar of verborgen zijn.
  • E-mail capture kan resultaatmail of offerteaanvraag zijn.
  • ResultDisplay kan immediate, after_capture of hidden zijn.
  • Bij after_capture kan een opt-out knop zoals Nee bedankt de resultaten tonen zonder contactsubmission.
  • Marketing consent is optioneel en staat los van de transactionele resultaatmail.
  • Result features voegen notes, badges of vaste productposities toe.

Matching

De matching engine is uitlegbaar en regelgestuurd.

AI bepaalt de ranking niet. Producten worden gefilterd, uitgesloten, gescoord, geboost en daarna gesorteerd op hoogste score.

Regeltypes
Gebruik harde regels alleen wanneer iets echt verplicht is.
TypeWerking
filter

Harde voorwaarde. Producten die niet voldoen vallen af.

exclude

Harde uitsluiting. Producten die matchen op de regel worden verwijderd.

score

Geeft punten wanneer een product aan de voorkeur voldoet.

boost

Geeft extra sterke scorepunten bovenop normale scoring.

tag

Markeert een match zonder score te geven, nuttig voor segmentatie of uitleg.

Operators
Operators vergelijken productvelden met antwoordwaarden of vaste waarden.
OperatorWerking
equals

Waarde is gelijk aan de regelwaarde.

not_equals

Waarde is niet gelijk aan de regelwaarde.

contains

Tekst of lijst bevat de regelwaarde.

greater_than

Numerieke waarde is groter dan de regelwaarde.

less_than

Numerieke waarde is kleiner dan de regelwaarde.

closest_to

Kiest het product dat het dichtst bij een numerieke invoer ligt.

in

Waarde zit in een lijst.

not_in

Waarde zit niet in een lijst.

Rankingvolgorde
Zo komt Slecto van antwoorden naar aanbevelingen.
Stap 1

Actieve producten

Stap 2

Filters toepassen

Stap 3

Excludes verwijderen

Stap 4

Scores en boosts tellen

Stap 5

Result features toepassen

Embed en widget

Plaats Slecto als advieslaag in je webshop.

De embed plaatst een iframe naar de publieke widgetroute. De widget haalt alleen gepubliceerde guides op en registreert events wanneer analytics actief is.

Standaard embed
Toont de keuzehulp direct in de pagina. Gebruik dit op categoriepagina's, adviespagina's of product finder pagina's.
<div data-slecto-guide="EMBED_KEY"></div>
<script async src="https://uw-slecto-domein.nl/api/embed/EMBED_KEY/script"></script>
Button + popup
Toont eerst een knop en opent de keuzehulp in een modal overlay. Geschikt wanneer de pagina al druk is.
<div data-slecto-guide="EMBED_KEY" data-slecto-mode="button" data-slecto-button-label="Open keuzehulp"></div>
<script async src="https://uw-slecto-domein.nl/api/embed/EMBED_KEY/script"></script>
Floating launcher
Plaats een vaste knop rechtsonder. Handig voor brede categorieën waar bezoekers op elk moment advies kunnen willen.
<div data-slecto-guide="EMBED_KEY" data-slecto-mode="floating" data-slecto-button-label="Productadvies nodig?"></div>
<script async src="https://uw-slecto-domein.nl/api/embed/EMBED_KEY/script"></script>
Cookie- en consentstandaard
Slecto toont in embedded keuzehulpen geen eigen cookiebanner en biedt hiervoor geen keuze in de embed-UI.
  • De website waarop de keuzehulp wordt geplaatst blijft verantwoordelijk voor cookiebanner, privacycopy, CMP-configuratie en wettelijke grondslag.
  • Het embedscript leest standaard bekende hostsignalen zoals Cookiebot, Usercentrics, window.SlectoConsent, window.slectoConsent en expliciete data-slecto-consent-* attributen.
  • Zonder geldig hostsignaal draait de keuzehulp functioneel door, maar blijven analytics, marketingtracking en embed-opslag uit.
  • Dit volgt de gebruikelijke embedpraktijk: de klant plaatst het script in de eigen website en regelt consent centraal via de eigen website of CMP, in plaats van per widget een extra banner of keuze te tonen.

Analytics

Meet waar bezoekers starten, afhaken en doorklikken.

Slecto meet widgetgedrag per sessie, guide en product. Gebruik filters op periode, guide, product en eventtype om flows te verbeteren.

Beschikbare metrics
De dashboardstatistieken worden uit events berekend.
  • Views en unieke sessies.
  • Gestarte en voltooide flows.
  • Completion rate ten opzichte van starts.
  • Product clicks, quote clicks en resultaatmail-aanvragen.
  • Dropoff per vraag.
  • Populairste antwoorden.
  • Top producten op basis van CTA-clicks.
Events
Dit zijn de eventtypes die Slecto registreert.
EventBetekenis
widget_view

Widget geladen en zichtbaar voor bezoeker.

guide_started

Bezoeker start de keuzehulp.

question_answered

Een vraag is beantwoord.

question_skipped

Een vraag is overgeslagen.

guide_completed

De flow is afgerond en resultaten zijn bereikt.

product_clicked

Bezoeker klikt naar een aanbevolen product.

quote_clicked

Bezoeker klikt naar offerte of verkoopactie.

quote_requested

Bezoeker verstuurt een offerteaanvraag.

result_email_requested

Bezoeker vraagt resultaatmail of formulierverwerking aan.

email_capture_skipped

Bezoeker slaat het e-mailformulier over.

result_feature_clicked

Bezoeker klikt op een extra resultaatlink of -knop.

Marketing en e-mail

Volg leads op met de intentie die ze zelf hebben gegeven.

Slecto gebruikt zero-party data uit keuzehulpen om profielen, templates, campagnes en automations concreet te maken.

Open
Audience
Profielen opgebouwd uit submissions, intentie en consent.
  • Profielen worden genormaliseerd op e-mailadres binnen dezelfde organisatie.
  • Velden zijn onder meer lifecycle stage, lead score, marketing consent, suppression, laatste guide en top recommendation snapshot.
  • Suppression wint altijd van consent.
Open
Templates en Email Studio
Blok-gebaseerde e-mails met Slecto dynamic content.
  • Ondersteunt result_email, quote_confirmation, marketing_follow_up, nurture en re_engagement.
  • Blokken zijn brand header, title, paragraph, button, image, divider, best match product, top recommendations, answer summary en legal footer.
  • Tokens kunnen contact-, organisatie-, guide-, recommendation-, answer-, preference- en unsubscribe-data gebruiken.
Open
Campagnes
Eenmalige of geplande mails naar guided-selling leads.
  • Campagnes hebben status draft, scheduled, sending, sent, paused, cancelled, failed of archived.
  • Voor verzenden zijn mailbare profielen, template, consent, suppression en delivery readiness nodig.
  • UTM source, medium en campaign kunnen worden ingesteld voor attributie.
Open
Automations
Node-based opvolging met triggers, conditions, waits en acties.
  • Nodes zijn trigger, condition, wait, send_email, action en exit.
  • Voorbeelden: productadvies follow-up, high-intent no click, quote request follow-up, category nurture en re-engagement.
  • Re-entry staat standaard uit en heeft een cooldown nodig wanneer je het inschakelt.
Open
Delivery
Verzendmethode, limits, suppression en compliance checks.
  • Custom SMTP of Slecto fallback mail kan gebruikt worden, afhankelijk van configuratie.
  • SMTP tests schrijven verificatiestatus en eventuele foutmelding weg.
  • Marketingmails moeten unsubscribe en suppression respecteren.
Cronjobs en workers
Marketingmails en automations worden via worker endpoints verwerkt.
  • POST /api/marketing/workers/send verwerkt due send jobs in batches.
  • POST /api/marketing/workers/automations verwerkt actieve automation-runs.
  • Gebruik de header x-slecto-worker-secret wanneer MARKETING_WORKER_SECRET is ingesteld.
  • Marketing verzending loopt via queue, retries en delivery logs, niet als directe bulkactie in de browser.

Security, privacy en rollen

Slecto is multi-tenant en houdt publieke widgetdata strikt gescheiden.

De belangrijkste veiligheidsregels zijn ingebouwd in Supabase, server actions, veilige URL-validatie, encrypted secrets en consent/suppression logic.

Rollen
Rollen bepalen wie data beheert of alleen bekijkt.
RolRechten
owner

Volledig beheer van organisatie, leden, instellingen, marketing en verzending.

admin

Operationeel beheer van flows, producten, marketing en toegang.

editor

Bouwen en aanpassen waar toegestaan.

viewer

Alleen lezen, bedoeld voor rapportage en meekijken.

Belangrijke waarborgen
Checklist voor beheerders en technische teams.
  • Supabase Auth en Postgres zijn de bron van waarheid.
  • Row Level Security beperkt data per organization_id.
  • Authenticated users zien alleen organisaties waar ze lid van zijn.
  • Publieke bezoekers kunnen alleen published guides via embed key ophalen.
  • Productdata voor widgets loopt via security-definer RPC's en toont alleen actieve producten van de juiste organisatie.
  • Service-role keys, SMTP secrets en database URLs horen alleen in server-env of secret manager.
  • Productimporten en SMTP-hosts moeten in productie publieke hostnamen gebruiken. Localhost, private IP-ranges en URL-credentials worden geblokkeerd.
  • SMTP-wachtwoorden worden versleuteld opgeslagen met EMAIL_CREDENTIAL_SECRET.
  • Embedded widgets tonen geen eigen Slecto cookiebanner. De hostwebsite of CMP levert consent; zonder geldig signaal blijven analytics en marketingtracking uit.
  • Marketing consent staat los van transactionele resultaatmail. Standaard is expliciete opt-in of een andere aantoonbare klantgrondslag vereist.
  • Unsubscribe en preference center werken zonder login en blokkeren toekomstige marketingmails.

Routes en API

De belangrijkste publieke en worker-routes.

Dashboardroutes vragen login. Publieke routes zijn bedoeld voor widget, tracking, preferences en unsubscribe.

MethodeRouteDoel
GET
/widget/[embedKey]

Publieke widgetpagina in iframe.

GET
/api/embed/[embedKey]/script

Embedscript dat iframe, popup of floating launcher injecteert.

GET
/api/widget/[embedKey]

Publieke widgetdata voor gepubliceerde guides.

POST
/api/widget/[embedKey]/email

Resultaatmail, offerteaanvraag en contact submission verwerken.

POST
/api/analytics/track

Publieke analytics-events registreren.

GET
/preferences/[token]

Publiek preference center zonder login.

GET
/unsubscribe/[token]

Publieke uitschrijfpagina zonder login.

POST
/api/marketing/preferences/[token]

Voorkeuren opslaan.

POST
/api/marketing/unsubscribe/[token]

Uitschrijven en suppression toepassen.

GET
/api/marketing/open/[token]

Open tracking pixel.

GET
/api/marketing/click/[token]

Click tracking en veilige redirect.

POST
/api/marketing/workers/send

Due marketing send jobs verwerken.

POST
/api/marketing/workers/automations

Due automation runs verwerken.

Troubleshooting

Veelvoorkomende problemen en snelle controles.

Loop deze checks door voordat je verder zoekt. De meeste problemen zitten in status, publicatie, mapping, delivery of environment.

Geen producten zichtbaar
  • Controleer of de importjob op success staat.
  • Controleer of producten active zijn.
  • Controleer of de bron niet gepauzeerd is.
  • Controleer of Slecto geen private netwerk-URL blokkeert in productie.
Matching geeft weinig of geen resultaten
  • Gebruik filters alleen voor harde eisen.
  • Gebruik score of boost voor voorkeuren.
  • Controleer of rule fields exact overeenkomen met product attributes of features.
  • Gebruik de live test mode en bekijk welke regels producten laten afvallen.
Embed toont niets
  • Publiceer de guide.
  • Controleer de embed key.
  • Plaats zowel de data-slecto-guide div als het script.
  • Controleer CSP, scriptblokkades en of de app URL klopt.
Resultaatmail mislukt
  • Zet e-maildelivery actief in Instellingen.
  • Controleer SMTP-host, poort, secure-instelling, gebruikersnaam en wachtwoord.
  • Test de SMTP-verbinding.
  • Controleer EMAIL_CREDENTIAL_SECRET en fallback SMTP-envs.
Campagne verzendt niet
  • Controleer marketing readiness.
  • Controleer of er profielen met marketing consent zijn.
  • Controleer suppression, template status, delivery setup en worker cron.
  • Roep worker endpoints aan met x-slecto-worker-secret wanneer MARKETING_WORKER_SECRET is ingesteld.

Gebruik als werkdocument

Werk van data naar advies, en van advies naar opvolging.

Begin klein met een categorie waar bezoekers vaak twijfelen. Zodra productdata, regels en analytics kloppen, schaal je dezelfde aanpak naar meer categorieën, campagnes en automations.

Eerste keuzehulp bouwenVraag stellen