De widget insluiten
Inline insluiten in je pagina’s
Naast de zwevende chatbox kan dezelfde agent ook op je pagina’s worden geplaatst — tussen de producten op een categoriepagina, naast de productdetails op een productpagina. Het inline-blok voert zelf geen chat uit : als je op een chip klikt of een vraag typt en op Enter drukt, wordt de zwevende chat geopend met die vraag al ingevoerd. Eén medewerker, één sessie, één chatlog, en de context van de pagina blijft behouden.
Plaats het
<div data-ai-assistant-inline></div>
Overal in je sjabloon, zo vaak als je wilt — in een WordPress
Custom HTML
-blok, een HTML-widget van een paginabouwer of een themabestand.
Het widgetscript dat je al laadt, vindt elk blok en geeft daarin een
kaart weer. Hiervoor heeft niemand toegang tot je site nodig: het blok is
de volledige integratie, en alles eraan — tekst, lay-out,
kleuren — wordt daarna vanuit het dashboard beheerd. Het fragment met
een kopieerknop vind je onder Website › Code installeren › Inline-blok
(optioneel)
. Het fragment gebruikt de neutrale
data-ai-assistant-inline
, die geen product noemt, dus het
past bij een white-label-installatie. Blokken die eerder zijn geplakt met
data-pitchbar-inline
of data-blengi-inline
blijven werken; alle drie de namen doen hetzelfde.
Zonder attributen en zonder instellingen toont de kaart de persona en begroeting van het segment en de startvragen van de medewerker — precies wat de zwevende chat op die pagina zou laten zien.
Plaatsen met één klik (geen sjabloonbewerkingen)
onder Website › Plaats het blok op je
pagina’s: je opent een van je eigen pagina’s, beweeg je muis om een
element te zien en klik je op de plek waar het blok moet komen, bijvoorbeeld
de knop ‘Toevoegen aan winkelwagen’. Kies ‘Eronder’, ‘Erboven’ of
‘Erin’, aan het einde, en de pagina’s waarvoor het bedoeld is:
/product/* is elke pagina onder /product,
/* elke pagina, / de startpagina. Dat is alles:
met alleen de normale scripttag op de site voegt de widget het blok
naast dat element toe op elke overeenkomende pagina. Als je naar een andere
pagina gaat, volgt het de links van de site in het voorbeeld om bijvoorbeeld een
productpagina te vinden.
- Het element wordt onthouden als een CSS-selector die de voorkeur geeft aan wat
op alle pagina’s hetzelfde blijft: een id, de
namevan een knop (WooCommercebutton[name="add-to-cart"], Shopifybutton[name="add"]), de eigen klassen van het element, en pas daarna de positie ervan. Je kunt dit bewerken voordat je opslaat. - Een pagina waarvan de inhoud pas laat wordt geladen, wordt 8 seconden in de gaten gehouden. Als het element niet op een pagina staat, is de chatknop de manier om er te komen, en de Widget Monitor geeft dan Blok niet geplaatst weer (maximaal één keer per uur per plaatsing).
- Meerdere plaatsingen per AI-medewerker zijn prima (bijvoorbeeld productpagina’s en categoriepagina’s); je kunt ze allemaal uitschakelen of verwijderen.
- Het voorbeeld is een kopie van je pagina zonder de eigen scripts, dus een deel dat alleen door jouw scripts wordt weergegeven, kan daar ontbreken; kies een element in de buurt dat wel op de pagina zelf staat.
Wordt automatisch geplaatst voor je winkelsysteem
Op een WooCommerce-, Shopify-, PrestaShop-, Magento-, Shopware- of OpenCart-
webwinkel kan het blok zichzelf plaatsen, zonder dat je hoeft te klikken: onder de ‘Toevoegen aan winkelwagen’-
knop op de productpagina’s (WooCommerce form.cart op
/product/*, Shopify het ‘Toevoegen aan winkelwagen’-formulier op
/products/*). Op de webpagina wordt dit weergegeven als
Automatisch geplaatst, met de optie Uitschakelen.
- Nieuwe AI-medewerkers hebben het ingeschakeld. Bestaande medewerkers houden hun pagina’s zoals ze zijn, totdat de eigenaar op 'Automatisch plaatsen' klikt.
- Een eigen plek wint: zodra je een plek kiest (ook eentje die je daarna weer uitschakelt), stopt het automatisch plaatsen. Uitschakelen stopt het ook.
- Het volgt het winkelsysteem dat onze server van je site heeft gelezen (toen de AI-medewerker werd ingesteld, via Installatie controleren, of direct nadat de widget de winkel voor het eerst zag). De eigen inschatting van de widget wordt alleen aan jou getoond; hij verplaatst het blok nooit zelf.
- Een pagina die al een eigen blok heeft (een
data-ai-assistant-inline-element, of het antwoordblok van de WordPress-plugin) krijgt geen tweede. - Pagina’s zonder dat element tonen gewoon de chatknop; deze gemiste gevallen worden niet gemeld aan de Widget Monitor.
Weergave en tekst vanuit het dashboard
Weergave › Inline-blok beheert het blok zonder de site aan te raken. Twee modi:
- Aanpassen aan de zwevende widget (standaard) — het blok neemt de accentkleur, hoekradius en het startpictogram van het thema over. Je hoeft niets in te stellen; een leeg blok ziet er al uit als de chat.
- Uiterlijk inline aanpassen — achtergrond, rand, tekst, vervaagde tekst, titel, accentkleur, tekst op accentkleur, achtergrond en rand van invoerveld, achtergrond, rand en tekst van chip; hoekradius, opvulling, avatarformaat; schaduw aan of uit.
In beide modi kun je de lay-out instellen (zoals ingesteld op de pagina
, kaart,
balk of antwoord in het blok; een gekozen lay-out geldt voor elk blok op
de site, ongeacht wat de pagina zelf aangeeft via data-layout
), hoeveel
veel startvragen er worden getoond, of de avatar wordt weergegeven, en de titel,
ondertitel en plaatshouder voor invoer van het blok. Ingevulde tekstvelden ondergaan dezelfde
vertaaloverschrijvingen als het label van de launcher; lege velden vallen
terug op de standaard. Het live voorbeeld op die pagina geeft een echt blok weer.
Waar de inhoud van het blok vandaan komt
Het blok bevat zelf niets. Bij elke paginalaadbeurt vraagt het het dashboard om de URL van de pagina en de productcategorie van de pagina, en het dashboard beslist — de site zegt alleen „geef het blok hier weer”:
- Startvragen: de vragen van het bijbehorende segment → automatische paginavragen voor deze pagina → de eigen vragen van de agent → live productvragen uit de productgegevens van de pagina.
- Titel: de
data-titlevan het blok → de inline-titel van het dashboard → de persona-naam van het segment → die van de agent. - Ondertitel:
de
data-subtitlevan het blok → de inline-ondertitel van het dashboard → de begroeting van het segment → de gegenereerde paginalijn → het welkomstbericht van de medewerker → "Vraag maar raak". - Segment: eerst op URL-pad; als er geen pad is dat naar een productpagina verwijst, op basis van de categorie die de pagina aangeeft in zijn JSON-LD of breadcrumb, vergeleken met de productcategorieën van het segment.
Prioriteit, van laag naar hoog:
standaardinstellingen →
dashboardinstellingen → de eigen data-*
-attributen van het blok
en de --pb-inline-*
-CSS van de site. Een webbureau dat
het blok handmatig heeft opgemaakt, behoudt alle overschrijvingen; een klant die nog nooit
CSS heeft geschreven, regelt alles via het dashboard. De enige uitzondering is
de lay-out: een lay-out die in het dashboard wordt gekozen (kaart, balk of antwoord in
het blok) geldt voor elk blok, ook als de code van de pagina zijn
eigen data-layout
instelt; het attribuut is alleen doorslaggevend als het
dashboard aangeeft Zoals ingesteld op de pagina
, dus het inschakelen van Antwoord
in het blok
vereist nooit een wijziging van de sjabloon.
Eén agent, een andere rol per locatie
Maak geen agent per categorie aan. Maak een segment per locatie, afgestemd op het URL-patroon, en geef het een eigen persona-naam, begroeting, startvragen en instructies:
| Segment | URL-patroon | Rol |
|---|---|---|
| Thermosokken | /thermosokken* | Adviseur binnen die categorie: "Weet je niet zeker welke thermosok?" |
| Productpagina's | /product/* | Productspecialist — de widget leest ook de JSON-LD van het product, dus er is geen segment per product nodig |
| Standaard | al het andere | Algemene winkelassistent |
Het segment stuurt zowel het inline-blok als de zwevende chat op die pagina aan, en de instructies worden toegevoegd aan de prompt van de agent voor dat gesprek.
Opties per blok
Allemaal optioneel. Wat ontbreekt, valt terug op het segment en de agent.
| Attribuut | Wat het doet |
|---|---|
data-title | Koptekst. Standaard: de naam van de persona. |
data-subtitle | Lijn onder de kop. Standaard: de begroeting van het segment. |
data-placeholder | Plaatshouder voor invoer. Standaard: "Stel een vraag…" (vertaald). |
data-prompts | De startvragen van dit blok, gescheiden door een pipe: Help mij kiezen|Koude & klamme voeten?. Standaard: die van de agent. |
data-max-prompts | Aantal weer te geven, 1–6. Standaard 3. |
data-avatar | Afbeeldings-URL voor de avatar. Standaard: het startpictogram. |
data-hide-avatar | Present = geen avatar. |
data-layout | card (standaard, gestapeld), bar (één rij op desktop, gestapeld onder 640px) of answer (het antwoord verschijnt in het blok zelf, zie hieronder). Geldt zolang de lay-out van het dashboard is ingesteld zoals op de pagina; een lay-out die je kiest onder Aanpassen › Inline-blok › Lay-out geldt voor elk blok op de site, ongeacht wat dit kenmerk aangeeft. |
data-context | Expliciete plaatsingscontext, zie hieronder. |
Opmaak met CSS — voor bureaus
Het blok bevindt zich in zijn eigen shadow root, dus je CSS kan het niet verstoren, maar het wordt volledig gestileerd via aangepaste CSS-eigenschappen, die worden overgenomen in de shadow root. Stel ze in op het blok zelf of op een willekeurige voorouder; een variabele die je instelt, heeft voorrang op de instelling van het dashboard voor die knop:
[data-ai-assistant-inline] {
--pb-inline-bg: #f1f8f3;
--pb-inline-border: 1px solid #cfe6d6;
--pb-inline-radius: 14px;
--pb-inline-padding: 18px;
--pb-inline-font: "Inter", sans-serif;
--pb-inline-title: #0b3d1f;
--pb-inline-text: #1a1a1a;
--pb-inline-muted: #4b5f52;
--pb-inline-accent: #1e8a4c; /* send button, initial, focus ring */
--pb-inline-accent-ink: #fff; /* text on the accent */
--pb-inline-chip-bg: #fff;
--pb-inline-chip-border: 1px solid #cfe6d6;
--pb-inline-chip-color: #0b3d1f;
--pb-inline-input-bg: #fff;
--pb-inline-input-border: 1px solid #cfe6d6;
--pb-inline-shadow: none;
}
De volledige lijst:
| Variabele | Standaard |
|---|---|
--pb-inline-bg | #fff |
--pb-inline-border | 1px solid #e6e8ee |
--pb-inline-radius | 16px |
--pb-inline-padding | 16px |
--pb-inline-gap | 10px — tussen koptekst, invoerveld en chips |
--pb-inline-max-width | 560px (kaart), 100% (balk) |
--pb-inline-height | 380px — de vaste hoogte van de answer-lay-out |
--pb-inline-shadow | soft |
--pb-inline-font | system-ui-stack |
--pb-inline-title, --pb-inline-title-size, --pb-inline-title-weight | tekstkleur, 15px, 700 |
--pb-inline-subtitle-size | 12,5px |
--pb-inline-text, --pb-inline-muted | #131720, #6a7280 |
--pb-inline-accent, --pb-inline-accent-ink | het accent van de agent, #fff |
--pb-inline-avatar-size | 36px |
--pb-inline-input-bg, --pb-inline-input-border, --pb-inline-input-radius, --pb-inline-input-size | #fff, 1px effen #e6e8ee, 999px, 13,5px |
--pb-inline-chip-bg, --pb-inline-chip-border, --pb-inline-chip-color, --pb-inline-chip-radius, --pb-inline-chip-size, --pb-inline-chip-gap | #f7f8fa, 1px effen #e6e8ee, tekstkleur, 999px, 12,5px, 6px |
--pb-inline-chip-hover-bg, --pb-inline-chip-hover-color | 12% accenttint, tekstkleur |
Overig: ::part()
Elk onderdeel wordt weergegeven als een schaduwdeel, dus met gewone thema-CSS kun je het helemaal opnieuw stylen — lettertypen, transformaties, pseudo-elementen, media queries, alles:
[data-ai-assistant-inline]::part(chip) { text-transform: uppercase; letter-spacing: .02em; }
[data-ai-assistant-inline]::part(title) { font-family: "Fraunces", serif; }
[data-ai-assistant-inline]::part(button) { border-radius: 8px; }
@media (max-width: 640px) {
[data-ai-assistant-inline]::part(chips) { display: none; }
}
Onderdelen: card, header, avatar,
title, subtitle, form,
input, button, chips,
chip, answer,
Antwoord in het blok
Met de lay-out answer (Aanpassen › Inline-blok › Lay-out ›
Antwoord in het blok, wat geldt voor elk blok op de site
ongeacht wat er in het eigen data-layout van het blok staat — of
data-layout="answer" in één blok terwijl het dashboard aangeeft
Zoals ingesteld op de pagina) wordt een vraag
binnen het blok beantwoord, zodat de bezoeker op de pagina blijft: het chatvenster
gaat niet open en het blok behoudt een vaste hoogte
(--pb-inline-height), zodat de pagina niet verspringt terwijl het
antwoord binnenkomt.
- Vóór de eerste vraag: de titel, het invoerveld en de startvragen. Daarna: de vraag, een statusbalk terwijl er geantwoord wordt („Zoeken op je site…“), vervolgens „Op basis van de kennis op je site“ met een Meer informatie-link naar de eerste bron, het antwoord in maximaal twee korte alinea’s, en twee vervolgvragen.
- ‹ › blader door de eerdere vragen en antwoorden van deze pagina; Doorgaan in chat opent de chat met hetzelfde gesprek.
- Vragen uit het blok tellen mee als inline-vragen in de
statistieken; de server houdt de antwoorden kort
(
input_source=answer). - Per pagina: onder Aanpassen › Inline-blok ›
Antwoord in het blok op deze pagina’s: vermeld paden, één per regel
(
/product/*); op die pagina’s beantwoordt het blok de vraag zelf, ongeacht de lay-out of de eigendata-layoutvan het blok. Het blok wordt boven het bovenliggende element geplaatst, via Website › Plaats het blok (geen toegang tot de site nodig — zodra het winkelsysteem bekend is, via de crawl of omdat de widget het op een pagina heeft gezien, stelt dat gedeelte ook de gebruikelijke plek voor, zoals onder de ‘Toevoegen aan winkelwagen’-knop van WooCommerce, in één klik), of op WordPress met de shortcode[ai_answer], het AI-antwoordblok, of — op WooCommerce-productpagina’s — de instelling ‘Antwoordblok op productpagina’s’ van de plug-in (onder de samenvatting, onder de knop ‘Toevoegen aan winkelwagen’ of als een tabblad). - Instellingen (Aanpassen › Inline-blok): de hoogte van het blok, je eigen bronvermelding in plaats van "Gebaseerd op de kennis van …", en een disclaimer onder elk antwoord.
- Metingen: het blok registreert wanneer het wordt weergegeven, een
vraag, een vervolgvraag, ‘Doorgaan in chat’ en — op
WooCommerce met de plug-in — een ‘Toevoegen aan winkelwagen’ na een vraag. Je
ziet ze onder Resultaten › Antwoordblok; als GA4 is ingeschakeld, komen ze
ook in je eigen GA4 terecht als
block_impression,block_question,block_followup,block_continueenblock_add_to_cart(met je event-voorvoegsel).
Context doorgeven
Automatisch. Elke beurt bevat al de pagina-URL, titel, metatags, JSON-LD, koppen en zichtbare tekst, dus categorie- en productcontext worden automatisch doorgegeven zonder dat je iets hoeft te doen. Op een productpagina krijgt de agent te zien welk product openstaat.
Expliciet, per blok.
data-context
geeft aan
vanaf welke plek op de site de vraag is gesteld, in de beknopte
vorm key: value; key: value
of als een JSON-object. Dit
wordt meegestuurd met het eerste bericht dat het blok verstuurt en bereikt de
agent als "Gevraagd vanaf: categorie: Thermosokken" — bewust een
feit over de plek, nooit een instructie.
<div data-ai-assistant-inline
data-context="type: category; category: Thermosokken"></div>
<div data-ai-assistant-inline
data-context='{"type":"product","sku":"STP-BOSTON-ZW","name":"STAPP Boston Thermo — Zwart"}'></div>
Maximaal 10 sleutels, elk 120 tekens. Voor CMS-context op paginaniveau (berichttype,
taxonomieën, productvelden bij elke stap) gebruik je in plaats daarvan
data-page-context
in de scripttag — zie
WordPress & paginabouwers
.
Een voorbeeld van een categoriepagina
<div class="advice-block"
data-ai-assistant-inline
data-layout="bar"
data-title="Niet zeker welke thermosok?"
data-subtitle="Stel je vraag of kies hieronder — ik denk met je mee."
data-placeholder="Bijv. welke sok bij koude, klamme voeten?"
data-prompts="Koude & klamme voeten?|Help mij kiezen"
data-context="type: category; category: Thermosokken"></div>
<style>
.advice-block {
--pb-inline-bg: #eef7f0; --pb-inline-border: 1px solid #cde5d3;
--pb-inline-radius: 14px; --pb-inline-accent: #1e8a4c;
--pb-inline-title: #0b3d1f; --pb-inline-chip-bg: #fff;
--pb-inline-chip-border: 1px solid #cde5d3; --pb-inline-shadow: none;
}
</style>
Klik op „Koude & klamme voeten?” en de zwevende chat opent rechtsonder met die vraag, de categorie wordt genoemd en het gesprek gaat daar verder.