LeadBot-componenten in WordPress en Elementor: van A tot Z
Met componenten zet je losse onderdelen van LeadBot, zoals een AI-chat, een formulier, een terugbelverzoek of een WhatsApp-blok, midden in je WordPress-pagina in plaats van in de zwevende widget. Met de LeadBot-plugin hoef je geen script te plakken: je zet een shortcode of een korte <div> op de plek waar het component moet komen en de plugin doet de rest. Hieronder het hele traject, van het aanmaken van de LeadBot tot het stylen en publiceren van je pagina. Wil je liever je complete flow in de pagina? Daarvoor is er een apart artikel over de Inline LeadBot.
Belangrijk: gebruik de nieuwste versie van de LeadBot-plugin. Componenten en de shortcodes werken alleen in de laatste versie. Werk de plugin bij in wp-admin onder Plugins, of download hem in de WordPress-pluginbibliotheek.
Wat je aan het eind hebt
Je componenten staan op de plekken die jij kiest: een offerteformulier onder je prijstabel, een AI-chat naast je productinformatie, een WhatsApp-blok op je contactpagina. Ze nemen het lettertype van je site over, je past ze met een paar regels CSS aan op je huisstijl, en inzendingen komen in dezelfde inbox als bij de gewone widget.
Componenten of een hele flow?
Er zijn twee soorten LeadBots die je in je pagina kunt zetten. Dit artikel gaat over componenten. Voor een Inline LeadBot lees je Inline LeadBot in WordPress. Je kunt ze ook naast elkaar op dezelfde site gebruiken.
- Component-LeadBot — Losse blokken die elk op zichzelf staan: AI-chat, formulier, terugbelverzoek, e-mailverzoek, WhatsApp of een knop. Jij bepaalt per blok waar het op de pagina komt. Kies dit als je een formulier of chat op een vaste plek wil.
- Inline LeadBot (headless) — Je complete flow, met alle stappen en routering, als één blok in je pagina in plaats van in de widget. Kies dit als je het hele LeadBot-gesprek in de pagina wil.
Wat je nodig hebt
Vier dingen, en geen van alle vraagt om een developer.
- Beheerderstoegang tot wp-admin — Je installeert de LeadBot-plugin en bewerkt pagina's in Elementor of in de blokeditor. Heb je de plugin al voor de gewone widget, dan ben je al half klaar.
- De nieuwste versie van de LeadBot-plugin — Componenten werken alleen met de laatste versie van de plugin. Staat bij LeadBot in wp-admin onder Plugins 'Er is een nieuwe versie beschikbaar'? Klik dan eerst op Nu bijwerken. Je vindt de plugin ook in de WordPress-pluginbibliotheek.
- Componenten aan voor je account — Krijg je bij Nieuwe LeadBot niet de vraag 'Wat voor LeadBot wil je maken?', maar meteen de templates? Dan staan componenten nog niet aan voor je account of je domein. Neem contact op met support.
- Je live domein — De code werkt alleen op het domein waar je domeinsleutel bij hoort. Op een staging-site met een ander adres of op je eigen computer toont hij niets.
Stap 1: maak een component-LeadBot
Een component-LeadBot is de map waar je componenten onder vallen. Alle inzendingen van die componenten krijgen zijn naam in de inbox, dus geef hem een herkenbare naam, bijvoorbeeld 'Website – contactpagina'.
- 1Ga in het dashboard naar LeadBots en klik op Nieuwe LeadBot.
- 2Kies bij 'Wat voor LeadBot wil je maken?' voor Component-LeadBot.
- 3Geef hem een naam en maak hem aan.
Stap 2: voeg je componenten toe
Ga naar het tabblad Bewerken en klik op Component toevoegen. Kies het type en stel het in via Configureren. Velden, teksten en de AI-agent stel je hier in, niet in WordPress: zo pas je ze later aan zonder je pagina te bewerken.
Op elke kaart staat of het component klaar is. 'Klaar voor gebruik' betekent dat er niets meer mist; bij 'Vraagt aandacht' ontbreekt nog iets verplichts, bijvoorbeeld een AI-agent bij een chatbot. Wat elk type precies kan, lees je in Alle componenten en hun instellingen.
- Chatbot — Een AI-chat die altijd open in je pagina staat. Kies er een AI-agent bij.
- Formulier versturen — Een formulier met de velden die jij kiest, bijvoorbeeld een offerte- of demo-aanvraag.
- Terugbelverzoek en e-mailverzoek — Kant-en-klare formulieren die als terugbel- of e-mailverzoek in je inbox binnenkomen.
- WhatsApp — De bezoeker typt een bericht; LeadBot legt het vast als lead en opent daarna WhatsApp.
- Knop — Een knop die een link, telefoonnummer of e-mail opent, of je gewone LeadBot-widget. Zie 'Een knop die je widget opent' verderop.
Stap 3: kies je basiskleur en publiceer
Ga naar het tabblad Instellingen en kies in het blok Weergave je Basis kleur. Dat wordt de kleur van knoppen, focusranden en chatbellen. Je componenten nemen die kleur vanzelf over.
Klik daarna op Publiceren. Dit is verplicht: je componenten laden altijd de gepubliceerde versie. Wat je in het dashboard aanpast maar niet publiceert, verandert niets op je site. Het werkt ook andersom: haal je de component-LeadBot offline, dan verdwijnen zijn componenten van elke pagina.
Stap 4: koppel de LeadBot-plugin
De plugin zet je domeinsleutel in WordPress en laadt het componentenscript op elke pagina waar een component staat. Is de plugin al gekoppeld voor de gewone widget? Sla deze stap dan over. De widget en je componenten werken prima naast elkaar.
- 1Ga in het dashboard naar Instellingen > Installatie, klap WordPress open en klik op LeadBot koppelen.
- 2Installeer en activeer de LeadBot-plugin en bevestig de koppeling in WordPress. De stappen, en hoe je handmatig koppelt met je domeinsleutel, staan in LeadBot op WordPress installeren.
Stap 5: kopieer de shortcode
Je hoeft geen ID's op te zoeken: het dashboard zet de shortcodes voor je klaar, met het ID van het component en van je LeadBot erin.
- 1Open je component-LeadBot en ga naar het tabblad Installatie.
- 2Kies bij stap 2, 'Zet je LeadBot op je website', onder 'Waarmee is je website gemaakt?' voor WordPress.
- 3Bij 'Plak een shortcode op elke plek waar een component moet komen' staat per component een shortcode. Kopieer die van het component dat je wilt plaatsen. Weet je niet zeker welk component het is? Klik op Bekijk in voorbeeld.
Stap 6: plaats het component op je pagina
Plak de shortcode op de plek waar het component moet komen. Hij ziet er zo uit:
Je hoeft niet aan te geven wat voor component het is. Het script zoekt het ID op in je gepubliceerde LeadBot en toont vanzelf het juiste blok: een formulier, een chat of WhatsApp. Een script plakken is niet nodig; de plugin laadt het op elke pagina waar een component staat.
Zo plaats je de shortcode in Elementor; voor de blokeditor staan de stappen hieronder. Een shortcode werkt ook in de klassieke editor en in andere paginabouwers (Divi, WPBakery, Beaver Builder).
[leadbot component="JOUW-COMPONENT-ID" leadbot="JOUW-LEADBOT-ID"]- 1Open de pagina in WordPress en klik op Bewerken met Elementor.
- 2Zoek in het paneel Elements op shortcode en sleep de widget Shortcode naar de plek waar het component moet komen, bijvoorbeeld onder je prijstabel.
- 3Plak de shortcode in het veld van de widget.
- 4Klik op Bijwerken (of Publiceren).
- 5In de Elementor-editor zelf zie je het component mogelijk niet. Dat is normaal: bekijk de pagina via Voorbeeld of op je live site.
In de blokeditor van WordPress
Gebruik je de standaard blokeditor van WordPress (Gutenberg), dan plak je de shortcode in een blok Aangepaste HTML (of in een blok Shortcode, dat werkt ook).
- 1Open de pagina in WordPress, klik op de plek waar het component moet komen op + en zoek op html. Kies het blok Aangepaste HTML (Custom HTML als je WordPress op Engels staat).
- 2Plak de shortcode op het tabblad HTML van het blok en klik op Update. In de editor zie je de shortcode als gewone tekst staan; dat is normaal.
- 3Klik op Bijwerken (of Publiceren) van de pagina en bekijk hem via Voorbeeld of op je live site.
Liever een HTML-blok?
Plak je liever HTML in een HTML-widget of een blok Aangepaste HTML? Kies dan op het tabblad Installatie 'Sitebouwer of HTML' in plaats van WordPress: daar staat per component een regel <div>. Plak alleen die regel. Het script dat erboven staat heb je niet nodig; de plugin ziet de <div> en laadt het script vanzelf.
<div data-leadbot-step="JOUW-COMPONENT-ID" data-leadbot-id="JOUW-LEADBOT-ID"></div>Meerdere componenten of LeadBots
Zet gewoon meerdere shortcodes op je pagina, elk op zijn eigen plek. Het script wordt maar één keer geladen. Componenten van verschillende component-LeadBots mogen op dezelfde pagina staan: de shortcodes uit het dashboard noemen hun LeadBot al met leadbot.
Typ je shortcodes liever zelf? Vul dan in wp-admin bij Instellingen > LeadBot, in het blok Componenten en Inline LeadBots, het veld Standaard LeadBot-ID in. Dat is het getal aan het eind van de adresbalk als je de component-LeadBot open hebt: staat er …/leadbots/18, dan is het 18. Daarna mag leadbot weg uit de shortcode, behalve bij componenten van een andere LeadBot:
[leadbot component="ID-VAN-JE-FORMULIER"]
[leadbot component="ID-VAN-JE-CHATBOT" leadbot="19"]
<!-- of als HTML -->
<div data-leadbot-step="ID-VAN-JE-CHATBOT" data-leadbot-id="19"></div>Een knop die je widget opent
Een knopcomponent met de actie 'Open de LeadBot' opent je gewone LeadBot-widget. De plugin laadt die widget al op elke pagina, dus zodra je een widget-LeadBot gepubliceerd hebt, werkt de knop vanzelf.
Een knop plaats je niet met de shortcode en hij staat ook niet in de lijst op het tabblad Installatie. Zet hem in plaats daarvan als HTML-regel in een HTML-widget of een blok Aangepaste HTML. Het ID van de knop vind je op zijn kaart op het tabblad Bewerken: klap Codesnippet open, kies JavaScript en kopieer de waarde achter id:.
<div data-leadbot-type="buttons" data-leadbot-step="ID-VAN-JE-KNOP" data-leadbot-id="JOUW-LEADBOT-ID"></div>Stap 7: pas de vormgeving aan
Componenten staan in je eigen pagina, dus je eigen CSS werkt erop. Het lettertype van je site nemen ze al vanzelf over. De rest regel je zo:
- Kleur — Componenten gebruiken de Basis kleur uit stap 3. Wil je één component een andere kleur geven, voeg dan color="#0074FF" toe aan de shortcode, of data-leadbot-base-color="#0074FF" aan de <div>. De kleur zelf kun je met CSS-variabelen niet overschrijven, wel de stijl van losse onderdelen zoals de verzendknop (zie het voorbeeld hieronder).
- Kaart rond formulieren — Voeg chrome="false" toe aan de shortcode (of data-leadbot-chrome="false" aan de <div>) om de kaartachtergrond, de rand en de maximale breedte weg te halen, zodat het formulier opgaat in je pagina.
- Donkere modus — Voeg theme="dark" toe aan de shortcode (of data-leadbot-theme="dark" aan de <div>). Met "auto" volgt hij de instelling van de bezoeker.
- Waar zet je de CSS? — Voor je hele site bij Weergave > Customizer > Extra CSS (klassieke thema's) of Weergave > Editor > Stijlen > Extra CSS (blokthema's). Gebruik je een blok Aangepaste HTML, dan kan het ook op het tabblad CSS van dat blok.
Voorbeeld: een formulier in de stijl van je pagina
Je richt je CSS op het component via zijn ID, dus je hoeft het geen eigen class te geven. Zet eerst chrome="false" op het component, zodat de kaart eromheen verdwijnt:
[leadbot component="JOUW-COMPONENT-ID" chrome="false"]De CSS voor dit voorbeeld
Daarna maakt deze CSS het formulier even breed als je tekstkolom, met grotere tekst, donkere randen en een zwarte, ronde knop. Vervang JOUW-COMPONENT-ID door je eigen component-ID en pas de kleuren aan op je huisstijl. Alle variabelen staan in Componenten stylen.
/* Velden en tekst */
[data-leadbot-step="JOUW-COMPONENT-ID"] {
--leadbot-form-max-width: none; /* volle breedte van je tekstkolom */
--leadbot-font-size: 16px; /* tekstgrootte */
--leadbot-color-text: #111; /* tekstkleur */
--leadbot-color-border-input: #111;
--leadbot-radius-sm: 4px; /* afronding van de invoervelden */
}
/* De verzendknop: zwart en rond, zoals de knoppen van je thema */
[data-leadbot-step="JOUW-COMPONENT-ID"] .leadbot-submit-btn {
background: #111;
color: #fff;
border-radius: 999px;
padding: 14px 28px;
width: auto;
}
[data-leadbot-step="JOUW-COMPONENT-ID"] .leadbot-submit-btn:hover {
background: #333;
}Lijken de knoppen op die van je thema?
Je eigen CSS werkt op LeadBot, en dat geldt ook voor de CSS van je thema. Elementor-kits geven bijvoorbeeld elke verzendknop op je site een eigen achtergrond, padding en afronding, en dan nemen de knoppen van LeadBot die stijl over.
Wil je de LeadBot-stijl terug, plak dit dan één keer bij Weergave > Customizer > Extra CSS. Meer over CSS-variabelen en klassen lees je in Componenten stylen.
.leadbot-components button,
.leadbot-components input,
.leadbot-components textarea,
.leadbot-components select {
all: revert-layer;
}Stap 8: test het en kijk in je inbox
Doe één keer zelf de test voordat je bezoekers erop loslaat.
- 1Open de pagina op je live site, of via Voorbeeld.
- 2Verstuur een testaanvraag via je formulier, of stel een vraag in de chat.
- 3Kijk in de Inbox in het dashboard en open je test. Bij Domein en Leadbot zie je waar hij vandaan komt: je site en je component-LeadBot.
- 4Open in de component-LeadBot het tabblad Installatie. Zodra je site de componenten laadt, staat bij de stap 'Zie je eerste bezoeker' de melding 'Eerste bezoekers zijn binnen'. Dat kan een paar minuten duren.
Liever je hele flow in de pagina?
Wil je geen losse blokken maar je complete LeadBot-gesprek in de pagina, gebruik dan een Inline LeadBot. Je bouwt hem zoals een gewone LeadBot en plaatst hem met dezelfde plugin, met één shortcode: [leadbot flow="…"]. Het complete stappenplan staat in Inline LeadBot in WordPress.
LeadBot in een Elementor-popup
Een Elementor-popup bouwt zijn inhoud pas op als hij opengaat, en dan heeft het script de pagina al afgezocht. Zet de shortcode in de popup en voeg dit één keer toe in een HTML-widget op dezelfde pagina:
Staat er buiten de popup geen ander component op de pagina, dan laadt de plugin het script niet. Zet dan in dezelfde HTML-widget ook het script uit 'Zonder de plugin' hieronder.
<script>
jQuery(document).on("elementor/popup/show", () => window.LeadBot?.mountAll());
</script>Optimalisatie- en cachingplugins
Plugins als WP Rocket, LiteSpeed Cache, Autoptimize en Perfmatters kunnen scripts uitstellen tot de bezoeker scrolt of klikt. Dan verschijnen je componenten pas na die eerste beweging.
Sluit components.js daarom uit van Delay JavaScript en leeg daarna de cache. Hoe dat in WP Rocket werkt, lees je in LeadBot-script uitsluiten in WP Rocket; vul daar components.js in waar het artikel script.js noemt.
Werkt het niet?
Loopt het niet meteen, dan is het vrijwel altijd een van deze. Klopt er iets niet aan een shortcode, dan laat de plugin een notitie achter in de broncode van de pagina (rechtermuisklik > Paginabron weergeven, zoek op 'LeadBot:'). Bezoekers zien die niet. Meldingen van het script zelf staan in de console van je browser (rechtermuisklik > Inspecteren > Console) en beginnen met [leadbot].
- Er verschijnt niets — Controleer of de plugin gekoppeld is (Instellingen > LeadBot), of de LeadBot gepubliceerd is, of het component-ID klopt en of je op je live domein kijkt in plaats van op een staging-site.
- Notitie 'connect the plugin under Settings → LeadBot first' — De plugin heeft nog geen domeinsleutel. Koppel hem zoals in stap 4.
- Notitie 'no LeadBot ID for this component' — De shortcode noemt geen leadbot en er is geen Standaard LeadBot-ID ingevuld. Kopieer de shortcode opnieuw van het tabblad Installatie (stap 5); daar staat leadbot al in.
- Eén component blijft leeg — Staat er 'Vraagt aandacht' op de kaart, bijvoorbeeld een chatbot zonder AI-agent? Maak het component af en publiceer opnieuw. Is het component verwijderd, dan toont het niets. Is het een knop? Die plaats je met de HTML-regel uit 'Een knop die je widget opent'.
- Alleen leeg in de Elementor-editor — Dat is normaal. Kijk via Voorbeeld of op de live pagina.
- Wijzigingen uit het dashboard komen niet door — Publiceer de LeadBot opnieuw en leeg de cache van je site.
- De knoppen zien eruit als die van je thema — Gebruik de CSS uit 'Lijken de knoppen op die van je thema?' hierboven.
Zonder de plugin
Kun of mag je geen plugin installeren? Kies dan op het tabblad Installatie 'Sitebouwer of HTML'. Plak het script één keer per pagina in een HTML-blok, en de regel <div> op de plek waar het component moet komen. Beide staan al ingevuld met je domeinsleutel en ID's. Staat het script er twee keer, dan laadt het maar één keer.
<div data-leadbot-step="JOUW-COMPONENT-ID"></div>
<script
src="https://script.leadbot.com/components.js"
data-leadbot-domain-key="JOUW-DOMEINSLEUTEL"
data-leadbot-id="JOUW-LEADBOT-ID"
></script>Volgende stappen
- Componenten: LeadBot midden in je eigen website — wat componenten zijn en wat er geteld wordt.
- Alle componenten en hun instellingen — wat elk componenttype doet.
- Componenten stylen — alle CSS-variabelen, klassen en de donkere modus.
- Inline LeadBot in WordPress — je complete flow in je pagina, met dezelfde plugin.
- LeadBot op WordPress installeren — de plugin koppelen, en de gewone zwevende widget.
Kom je er niet uit?
Geen ticketnummer — je spreekt altijd een mens. We denken graag met je mee, van installatie tot optimalisatie.
