De widget insluiten
Stem, leiderschap en doorzettingsvermogen
De widget is meer dan alleen een chatvenster. Hij legt leads direct vast, zet spraak om in tekst, blijft behouden als je de pagina vernieuwt en laat live zien dat er iemand aanwezig is zodra een medewerker het gesprek overneemt. Op deze pagina vind je uitleg over alle functies en hoe je ze kunt instellen.
Gesprekspersistentie
Elke bezoeker krijgt een anon_id (een willekeurige tekenreeks die bij
het eerste bezoek naar localStorage wordt geschreven). Bij het herladen roept de widget
/v1/widget/init aan met dezelfde anon_id en de
server gaat verder met het meest recente gesprek als dat minder dan 24 uur
oud is.
Het init-antwoord bevat de laatste 30 berichten, met het oudste bericht bovenaan, zodat het
chatlog weer wordt opgebouwd in de volgorde waarin de bezoeker het achterliet. (Vroeger werden de eerste 30 berichten verzonden, waardoor een terugkerende bezoeker met een lang chatgesprek
zijn laatste antwoorden niet zag.) De knop „Gesprek wissen“
(in de koptekst van de widget) schrijft een cleared_at-tijdstempel
op de gespreksregel — eerdere berichten blijven in de database staan voor
analyses en leadkoppeling, maar worden niet meer aan de bezoeker getoond. Ook
wordt de LLM-geschiedeniscache aan de serverzijde gewist, zodat de volgende beurt echt
in een nieuwe context begint in plaats van stilletjes door te gaan met het gewiste
gesprek.
Nu begint een reset ook een nieuw gespreksrecord voor dezelfde bezoeker: het eindpunt stuurt zijn id en een widget-token terug, de widget gaat daarin verder, en bij het herladen wordt het hervat (init kiest het nieuwste gesprek van de bezoeker). Dus elke reset wordt vermeld, beoordeeld en geteld als een apart gesprek; voorheen telden zes testsessies na „Reset“ mee als één gesprek van 60 berichten. De enige uitzondering is een gesprek dat een operator heeft opgeëist: dat wordt ter plekke gewist, zodat de operator nooit in een leeg gesprek terechtkomt. Omdat het ter plekke wordt gewist, vergeet het ook wat de AI ervan onthouden had — wat de bezoeker zei dat hij nodig had en de besproken producten — zodat het volgende antwoord nooit verwijst naar „je eerdere opmerking“. Een nieuw gesprek begint sowieso leeg.
Een reset kost nooit meer dan /init zou kosten. Het nieuwe token
behoudt de vervaldatum van het oude token, dus door te resetten kun je een sessie niet langer dan
60 minuten in stand houden. De maandelijkse gesprekslimiet van de werkruimte
geldt. Een bezoeker krijgt op deze manier maximaal tien nieuwe gesprekken per uur
(ConversationClearController::RESETS_PER_HOUR; elke reset
deelt een nieuw token uit, dus de beperking per token alleen zou dit niet
beperken). Als een van deze limieten wordt overschreden, wordt het gesprek ter plekke gewist, net als
voorheen.
De balk, het paneel en de bol
De widget is een zwevende balk — een altijd zichtbaar schrijfvenster dat onderaan de pagina vastzit, zodat een bezoeker meteen een plek ziet om te typen zonder eerst iets te hoeven openen. Zodra een gesprek begint, verschijnt het antwoordpaneel erboven met de koptekst, de berichtenthread en de kaarten; de balk blijft eronder staan. Zolang er nog geen berichten zijn, delen de begroeting, de startprompt-chips en de balk één kaart.
Als je via het ⋯-menu van de balk sluit, wordt alles samengevouwen tot een klein rond bolletje in de hoek. Er verschijnt een ‘ongelezen’-badge op het bolletje als er een antwoord binnenkomt terwijl het gesloten is, samen met een geluidssignaal (één per sessie) en de begroetingsteaser kan ernaast weer verschijnen om de bezoeker terug te halen.
Opeenvolgende berichten van dezelfde auteursgroep: de avatar wordt één keer per run weergegeven (bij het laatste bericht, waar de staart van de ballon zit) en de herhaalde avatarvakjes blijven in de lay-out staan, zodat elke ballon in een groep dezelfde linkerrand behoudt.
De hele stapel — paneel, tussenruimte en launcher — heeft samen een maximale hoogte
van calc(100dvh - 100px), en het paneel is het enige onderdeel
dat mag krimpen. Door alleen het paneel te beperken, kan het voorbij de onderkant
van een kort venster lopen en de composer en launcher onder de vouw verbergen.
Venstergrootte & uitvouwen
Het chatpaneel opent op een prettige hoogte die meegroeit met het scherm, in plaats van te krimpen om in de inhoud te passen. Een gloednieuw of kort gesprek opent niet langer als een krap vakje, en de startprompts staan boven een berichtenthread die altijd genoeg ruimte heeft om te ademen (de thread neemt de verticale speling op, niet de prompts).
Met een uitvouwknop in de koptekst van het paneel kun je het venster vergroten tot bijna volledig scherm (en een tikje breder) voor langere gesprekken, en het daarna weer samenvouwen. Deze instelling geldt per sessie en is puur aan de clientzijde — er wordt niets opgeslagen. Op telefoons vult de hoogte al het grootste deel van het scherm, dus als je uitvouwt, wordt het paneel daar vooral breder.
De breedte van het paneel volgt de door jou ingestelde bar_width-themawaarde
als je die hebt ingesteld; anders gebruikt het de eigen
388px-standaard van het paneel (bar_width was afgestemd op de
oudere composer over de volledige breedte, en de standaardbreedte van 560px maakt het chatpaneel
breder dan de bedoeling is). De uitgevouwen modus heeft een maximale breedte van 760px
(of calc(100vw - 24px) op smalle schermen). De koptekst
blijft vastgepind, zodat ‘Sluiten’ en ‘Uitvouwen’ altijd bereikbaar zijn.
Themakleuren & contrast
Je kiest één accentkleur; de widget bepaalt de rest. Tekst en pictogrammen die op de accentkleur worden weergegeven (koptekst, de spreekballonnen van je bezoekers, de launcher, de verzendknop) wisselen tussen wit en bijna-zwart op basis van de gemeten helderheid van de accentkleur, zodat een lichte accentkleur zoals amber geen onleesbare witte tekst meer oplevert. De accentkleur die als tekst op het paneeloppervlak wordt gebruikt (snelantwoord-chips, kaartknoppen ) wordt verschoven naar de tegenovergestelde kleur van de achtergrond totdat deze voldoet aan de WCAG AA 4,5:1-contrastverhouding — puur amber op wit is slechts 1,9:1.
Beide berekeningen worden één keer per accent en kleurenschema uitgevoerd en vervolgens in de cache opgeslagen, zodat ze bij volgende weergaven niets kosten. Kleuren voor succes, waarschuwingen en fouten blijven onafhankelijk van je accent, dus een groen accent kan een waarschuwingsbanner nooit dubbelzinnig maken.
Spraakmicrofoon
Met een microfoonknop in het invoerveld kunnen bezoekers dicteren in plaats van
te typen. De widget maakt gebruik van de ingebouwde
SpeechRecognition
-API van de browser — geen spraakmodel aan de serverzijde. Tijdens
het opnemen toont de microfoon een sonar-ring-animatie; nogmaals klikken stopt
de opname en voegt het transcript in het invoervak in (aangevuld als er
al tekst staat, zodat je kunt dicteren, bewerken en daarna weer verder dicteren).
Browsers zonder SpeechRecognition (Firefox, oudere Safari)
tonen de microfoonknop niet. Er is geen alternatief — de functie is
opportunistisch.
Stadia van de typindicator
Het zwevende ballonnetje vertelt wat de server aan het doen is in plaats van een statische "Bezig met...": Je site doorzoeken… tijdens het ophalen, Bezig met… terwijl de LLM aan het samenstellen is, en een toolspecifiek label wanneer een tool draait — Je bestelling controleren…, Je ticket aanmaken…, Het juiste artikel zoeken…, Je doorverbinden met een medewerker… (onbekende tools tonen Er wordt aan gewerkt…). Labels verdwijnen zodra het eerste token binnenkomt.
Ze in de stem van je agent verwerken
De twee belangrijkste fasen klinken als machinaal taalgebruik — wat een operator ook hardop zei: zijn agent heet Guus, en hij wilde dat er in het tekstballonnetje "Guus zoekt de juiste informatie voor je op." zou staan in plaats van "Zoek op je site…". Beide fasen kun je per agent aanpassen onder Persoonlijkheid › Wachtberichten : Tijdens het zoeken in je content en Tijdens het schrijven van het antwoord , 80 tekens elk.
Een leeg veld behoudt de standaardtekst die we meeleveren, wat ook de vertaalde tekst is — dus een agent die nog nooit is aangepast, gedraagt zich precies zoals altijd. Je eigen zin krijgt, zoals het hoort, voorrang boven de vertaling: als iemand een Nederlandse zin schrijft, bedoelt hij die zin, niet onze vertaling ervan, dus wordt die aan elke bezoeker in elke taal getoond. Een agent die echt twee talen ondersteunt, kan deze velden beter leeg laten.
Toollabels (Je bestelling wordt gecontroleerd… en dergelijke) zijn niet bewerkbaar — ze worden per tool op de server ingesteld, en een verkeerde zou een verkeerde melding geven over wat de agent daadwerkelijk doet.
Technisch gezien is dit een overschrijving die wordt samengevoegd met het kopieerwoordenboek dat de
widget ontvangt bij /v1/widget/init, dus niets in de
widgetbundel weet dat de instelling bestaat en er is geen hercompilatie nodig.
Markup die in het veld wordt geplakt, wordt verwijderd: de tekstballon geeft de tekst weer.
Stroomstabiliteit
Als de SSE-verbinding halverwege een beurt wegvalt zonder een done-gebeurtenis
(meestal doordat een proxy met proxy_read_timeout een inactieve
stream afsluit tijdens een trage modelbeurt), beschouwt de widget dit als een mislukte
poging: hij probeert het onopvallend maximaal drie keer opnieuw en, als elke
poging mislukt, toont hij een herhalingsknop — de ballon blijft nooit voor
altijd op „Bezig met denken…“ staan.
Lead-registratie
De lead-mail, en wie die krijgt
Nu staat in de e-mail ‘Nieuwe lead’ waar de lead over ging: de laatste vraag van de bezoeker als reden voor contact, de laatste acht rondes van het gesprek (bezoeker / assistent), de medewerker, de website en de exacte pagina waar de bezoeker op zat, plus een link naar het volledige gesprek. Slack-meldingen bevatten de vraag ook.
Ontvangers stel je per medewerker in onder Leadregistratie › Wie wordt op de hoogte gebracht van een nieuwe lead: maximaal tien extra adressen (ze hebben geen account nodig — de e-mail gaat rechtstreeks naar hen), een schakelaar om aan te geven of de werkruimte-eigenaren en beheerders het nog steeds ontvangen (standaard aan, wat wat elke medewerker vroeger deed), en een schakelaar om de conversatie in de e-mail op te nemen — zet die uit als de e-mail naar inboxen gaat die geen chatinhoud mogen zien. Een medewerker die niets heeft ingesteld gedraagt zich precies zoals voorheen.
De widget kan contactgegevens direct verzamelen zonder dat de bezoeker het gesprek hoeft te verlaten. Het vastleggen van leads wordt geactiveerd wanneer:
- Een gedragsregel van
kind=lead_captureklopt. - De bezoeker expliciet vraagt om gecontacteerd te worden (“kan iemand me bellen?”, “stuur me een offerte per e-mail”).
- Je koppelt een CTA-knop aan de actie van
lead_capture.
De formuliervelden worden per agent ingesteld. Standaard is dat naam + e-mail;
je kunt telefoonnummer, bedrijf en aangepaste velden toevoegen. Ingediende leads worden
via POST verzonden naar /v1/widget/leads (met een limiet per JWT) en
verschijnen direct in /app/leads (de leadlijst per werkruimte).
De bevestiging "Bedankt — we nemen snel contact met je op" verdwijnt automatisch
na 5 seconden en heeft een duidelijke × voor bezoekers die het
eerder weg willen hebben.
Wanneer het formulier wordt aangeboden, en hoe
Vier triggers, allemaal per agent onder Leadregistratie › Wanneer het vraagt:
- Na interactie — drie berichten van de bezoeker, of een aankoopsignaal, wat het eerst komt. Dit is de standaardinstelling.
- Een koopsignaal in wat de bezoeker typt: prijs, offerte, contact, demo, een telefoontje. De signaallijst omvat Engels, Nederlands, Duits en Frans — vroeger was het alleen Engels, waardoor voor een Nederlandse winkel deze trigger nooit afging („offerte”, „prijs”, „terugbellen” waren daarvoor onzichtbaar). Elke lijst wordt bij elk bericht vergeleken, dus ook Engelssprekende bezoekers van een Nederlandse webwinkel vallen hieronder. In een webwinkel (sitetype e-commerce) zijn woorden als prijs, kosten, korting, betaling en bestelling vragen over het winkelen, geen aankoopsignalen: „Verzenden naar België, kosten en duur?“ opent het formulier niet meer. Woorden als contact, offerte, bel-me-terug, mens en afspraak doen dat nog wel.
- Het eigen oordeel van de agent in de Advisor-modus: hij
schrijft één regel in zijn eigen stijl en opent het formulier
(
<lead-form/>). Nu volgt die markering de regels van de agent: na een expliciete vraag van een bezoeker (contact, een offerte, bel me) opent het het formulier, tenzij er al een lead is vastgelegd; wanneer de agent het zelf toevoegt, doet het niets bij Nooit en ook nooit na een vastgelegde lead. - Stilte na een echt gesprek — nieuw. Na minstens drie berichten van de bezoeker en een antwoord, als er een tijdje niets wordt getypt (standaard 45 seconden, 20–180), vraagt de agent één keer of ze gecontacteerd willen worden. Dit draait volledig in de browser: inactiviteit is iets wat alleen de browser kan zien, en daarop letten kost de server niets. De timer begint opnieuw bij elke toetsaanslag en elk nieuw bericht, dus het wordt alleen geactiveerd bij echte stilte.
Vraag het eerst. Een formulier dat midden in een chat verschijnt, komt over als een eis. Als Introduce it with a message first is ingeschakeld, stuurt elke trigger aan de serverzijde in plaats daarvan één regel – die van jou, of de vertaalde standaardtekst: “Wil je dat we hierover contact met je opnemen? Je kunt hier je gegevens achterlaten.” — met een knop Mijn gegevens achterlaten en een ‘Nee, bedankt ’. Het formulier opent pas als de bezoeker op de knop tikt. De stilte-trigger vraagt altijd eerst; dat is juist het punt ervan. Een bezoeker die weigert, wordt in dat gesprek niet meer gevraagd, via welk pad dan ook, en het formulier dat via een andere route opent (een CTA, de fallback voor offline-overdracht, de adviseur) trekt de uitnodiging in. Het sluiten van het formulier met Sluiten wordt ook onthouden : een later antwoord zorgt er niet voor dat het op die pagina weer opent; alleen als de bezoeker zelf op een CTA of de uitnodiging tikt, gaat het nog open.
Eén keer per gesprek . Wat de aanleiding ook was – interactie, een koopsignaal of de eigen markering van de medewerker – het formulier (of de uitnodiging) wordt één keer per gesprek aangeboden. Daarna verschijnt het alleen weer als de bezoeker er in zijn bericht om vraagt: om gecontacteerd te worden, voor een offerte, een terugbelverzoek of een afspraak („Kunt u mij terugbellen?”, „Ik wil een offerte”). Een latere vraag over de prijs of een aankoopvraag zorgt er niet voor dat het terugkomt. Vroeger kon het elke vijf berichten van de bezoeker terugkomen.
'Eerst introduceren met een bericht' staat standaard aan, omdat het formulier na de uitnodigingszin verschijnt, tenzij je dat uitschakelt. Alleen de Nederlandse, Duitse en Franse signalen en deze twee regels veranderen het bestaande gedrag.
Slimme registratie op basis van intentie
De nieuwste update (commit 9190aa5) voegt intent-gebaseerde vastlegging toe:
de widget scant het gesprek op zinnen die duiden op een echte
koopintentie — vragen over prijzen, “is dit geschikt voor…”, “kan ik een demo krijgen…” —
en biedt het leadformulier proactief aan na een paar beurtjes. De drempelwaarde en
de zinnenlijst zijn per agent aanpasbaar.
Overname door een medewerker
Als een teamlid het gesprek overneemt (Overnemen
op het gespreksscherm),
merkt de widget dit op bij de volgende poll (elke 3 seconden zolang hij open is):
hij toont een kort berichtje "<Naam> is bij de chat gekomen"
("Een medewerker is bij de chat gekomen"
als namen verborgen zijn) en een
‘Live agent
’-ballonnetje in de chatbalk. Vanaf dat moment
blijft de AI gepauzeerd — elk bericht van een bezoeker gaat naar de operator, en
antwoorden van de operator komen bij dezelfde poll in de widget terecht. De bezoeker ziet
één doorlopende thread. Een antwoord van de operator wordt opgeslagen met de rol
assistant
en het model human:<user id>
;
de widget toont dit als een tekstballon van een teamlid.
Zie Leads & menselijke overname voor de kant van de operator.
Bronvermeldingen
Standaard uitgeschakeld. Schakel Gedrag › Hoe het antwoordt › Bronvermeldingen weergeven in
en antwoorden uit opgehaalde bronnen bevatten
genummerde verwijzingen ([1], [2]) in de tekst en
een rij Bronnen onder het bericht; klik erop om de bron-
URL in een nieuw tabblad te openen. Als deze optie uitstaat, krijgt de AI de opdracht om geen markeringen te plaatsen en
worden eventuele markeringen die toch worden geplaatst, verwijderd. Antwoorden zijn in beide gevallen onderbouwd.
Samengestelde antwoorden kunnen ook een optionele bronverwijzings-URL bevatten — handig als het standaardantwoord afkomstig is van een specifieke pagina.
Streaming
Berichten worden token voor token gestreamd via Server-Sent Events. De widget
leest de stream en voegt tokens in realtime toe aan de DOM. Als de
stream onderweg een fout geeft (netwerkstoring, LLM-time-out), probeert de widget
het automatisch maximaal 3 keer opnieuw voordat er een foutmelding verschijnt — en er verschijnt maar
één gebruikersballon, zelfs bij herhalingspogingen (a576e1c vastleggen).
Branding
In de voettekst van de widget staat standaard een link ‘Powered by Blengi’. Deze is
verborgen voor werkruimten met een abonnement waarbij de remove_branding
feature flag is ingeschakeld — zie Facturering &
abonnementen.
Het merklabel, de URL en het logo komen allemaal uit de configuratie van de platformbeheerder
(config('branding.*')
+ de optionele
app_settings
-singleton-overschrijvingen), dus bij een zelfgehoste
implementatie kun je de voettekst helemaal aanpassen.
Opslag
De widget gebruikt localStorage voor:
anon_id— permanente bezoekers-ID.- De gewiste status van het gesprek (welke bericht-ID’s de bezoeker heeft verborgen via “Wissen”).
Er worden geen persoonlijk identificeerbare gegevens opgeslagen aan de clientzijde. De JWT zelf staat in het geheugen — hij wordt bij elke initialisatie opnieuw aangemaakt.