Support / Headless

Inline LeadBot in WordPress: je hele LeadBot-flow in je pagina

Met een Inline LeadBot zet je je complete LeadBot-gesprek, met alle stappen en routering, als vast blok midden in je WordPress-pagina, in plaats van in de zwevende widget. Met de LeadBot-plugin heb je geen npm of code nodig: je zet één shortcode op de plek waar het gesprek moet komen. Hieronder het hele traject, van het aanmaken van de LeadBot tot het uitlijnen en testen op je live site.

Inline LeadBot of componenten?

Allebei zetten ze LeadBot in je eigen pagina, met dezelfde plugin. Je kunt ze ook naast elkaar op dezelfde site gebruiken.

  • Inline LeadBot — Je complete flow als één blok in je pagina. Je bouwt hem in de builder, precies zoals een gewone LeadBot. Dat is waar dit artikel over gaat.
  • Component-LeadBot — Losse blokken, zoals een AI-chat, formulier of WhatsApp-blok, die je elk apart in je pagina zet. Zie LeadBot-componenten in WordPress en Elementor.

Wat je nodig hebt

Drie 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.
  • Inline LeadBots aan voor je account — Krijg je bij Nieuwe LeadBot niet de vraag 'Wat voor LeadBot wil je maken?', maar meteen de templates? Dan staat het nog niet aan voor je account. Neem contact op met support.
  • Je live domein — De LeadBot laadt alleen op het domein waar je domeinsleutel bij hoort. Op een staging-site met een ander adres toont hij niets.

Stap 1: maak een Inline LeadBot

Heb je al een gewone LeadBot die je in de pagina wil zetten? Open hem, ga naar het tabblad Instellingen en zet in het blok Weergave de schakelaar Vast in de pagina aan. Dat gaat in bij de volgende publicatie; tot die tijd blijft de widget gewoon op je site staan. Ga dan door naar stap 2.

Begin je opnieuw:

  1. 1Ga in het dashboard naar LeadBots en klik op Nieuwe LeadBot.
  2. 2Kies bij 'Wat voor LeadBot wil je maken?' voor Inline LeadBot.
  3. 3Kies een template, of bouw hem met de AI-builder.
  4. 4Geef hem een herkenbare naam, bijvoorbeeld 'Website – offerte-pagina'. Die naam zie je terug bij elke inzending in je inbox.
Een bestaande LeadBot zet je om met Vast in de pagina.

Stap 2: bouw je flow en geef hem je stijl

Bouw de flow in de builder, zoals bij elke LeadBot. Er is geen startknop om in te stellen, want het gesprek staat al open in de pagina.

Open daarna het tabblad Voorbeeld en klik op Stijl. In de visuele editor bepaal je hoe het gesprek eruitziet: breedte, uitlijning, kleuren, lettertype en hoe de knoppen staan. Klik op een onderdeel in het voorbeeld om het aan te passen. Sla op; in stap 3 publiceer je, en dan staat je stijl vanzelf op je site. Alles over de editor lees je in vormgeven in de visuele editor.

Boven het voorbeeld staat ook een knop Installatie. Die toont code voor sites met npm; in WordPress heb je die niet nodig.

Klik op Stijl en geef het gesprek je eigen uitstraling.

Stap 3: publiceer

Klik op Publiceren. Dit is verplicht: de pagina laadt altijd de gepubliceerde versie. Wat je in de builder aanpast maar niet publiceert, verandert niets op je site.

Campagnes, zichtbaarheidsregels en planning blijven gewoon werken. Valt een pagina buiten de zichtbaarheidsregels van de LeadBot, dan toont de shortcode daar niets.

Stap 4: koppel de LeadBot-plugin

De plugin zet je domeinsleutel in WordPress en laadt het script op elke pagina waar een Inline LeadBot staat. Is de plugin al gekoppeld voor de gewone widget of voor componenten? Sla deze stap dan over.

  1. 1Ga in het dashboard naar Instellingen > Installatie, klap WordPress open en klik op LeadBot koppelen.
  2. 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.
Koppel de LeadBot-plugin vanuit het dashboard.

Stap 5: zet de shortcode op je pagina

Open je Inline LeadBot en ga naar het tabblad Installatie. Kies bij stap 2 onder 'Waarmee is je website gemaakt?' voor WordPress: daar staat je shortcode klaar, met het ID van je LeadBot erin. Dat ID is ook het getal aan het eind van de adresbalk: staat er …/leadbots/21, dan is het 21. Het veld Standaard LeadBot-ID in de plugin hoef je hiervoor niet in te vullen; dat is alleen voor componenten.

Zo plaats je de shortcode in Elementor. Een shortcode werkt ook in de klassieke editor en in andere paginabouwers (Divi, WPBakery, Beaver Builder).

[leadbot flow="ID-VAN-JE-INLINE-LEADBOT"]
  1. 1Open de pagina in WordPress en klik op Bewerken met Elementor.
  2. 2Zoek in het paneel Elements op shortcode en sleep de widget Shortcode naar de plek waar het gesprek moet komen.
  3. 3Plak de shortcode in het veld van de widget.
  4. 4Klik op Bijwerken (of Publiceren).
  5. 5In de Elementor-editor zelf zie je de LeadBot mogelijk niet. Dat is normaal: bekijk de pagina via Voorbeeld of op je live site.
Zoek op shortcode en kies de widget Shortcode.

In de blokeditor van WordPress

Gebruik je de standaard blokeditor (Gutenberg), dan plak je de shortcode in een blok Shortcode (of in een blok Aangepaste HTML, dat werkt ook).

  1. 1Open de pagina, klik op de plek waar het gesprek moet komen op + en zoek op shortcode. Kies het blok Shortcode.
  2. 2Plak de shortcode in het blok. In de editor zie je hem als gewone tekst staan; dat is normaal.
  3. 3Klik op Bijwerken (of Publiceren) en bekijk de pagina via Voorbeeld of op je live site.

Liever een HTML-blok?

Plak je liever HTML in een HTML-widget of een blok Aangepaste HTML, dan is deze <div> genoeg. De plugin ziet hem en laadt het script vanzelf.

<div data-leadbot-type="flow" data-leadbot-step="flow" data-leadbot-id="ID-VAN-JE-INLINE-LEADBOT"></div>

Stap 6: lijn het gesprek uit

Standaard staat het gesprek links, met kaarten van maximaal 320px breed. Dat pas je aan in de visuele editor uit stap 2: onder Uitstraling bij Breedte en Uitlijning. Publiceer daarna, dan staat het zo op je site.

Liever met CSS? Je kunt de breedte en uitlijning ook zelf instellen met CSS-variabelen. Plak ze bij Weergave > Customizer > Extra CSS (klassieke thema's) of Weergave > Editor > Stijlen > Extra CSS (blokthema's); ze gelden voor elke Inline LeadBot op je site. Wat je in de visuele editor instelt, gaat hiervoor.

[data-leadbot-type="flow"] {
  --leadbot-flow-max-width: 640px; /* breedte van kaarten, knoppen en formulieren */
  --leadbot-flow-align: center;    /* flex-start, center, flex-end of stretch */
}
  • Uitlijning Links — Niets doen, dit is de standaard.
  • Uitlijning Midden — --leadbot-flow-align: center;
  • Uitlijning Rechts — --leadbot-flow-align: flex-end;
  • Volledige breedte — --leadbot-flow-max-width: none; en --leadbot-flow-align: stretch;
  • Knoppen gelijk verdeeld — --leadbot-flow-options-justify: space-evenly;
  • Knoppen vullen de rij — --leadbot-flow-option-grow: 1;

Kleur en donkere modus

De LeadBot gebruikt de basiskleur uit zijn publicatie en het lettertype van je site. Per shortcode kun je dat aanpassen:

[leadbot flow="21" color="#0074FF" theme="dark"]
  • Andere kleur — Voeg color="#0074FF" toe aan de shortcode, of data-leadbot-base-color="#0074FF" aan de <div>.
  • 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.
  • Meer aanpassen — Alle CSS-variabelen en klassen staan in Componenten stylen; ze werken ook voor een Inline LeadBot.

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 knop 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 Extra CSS:

.leadbot-components button,
.leadbot-components input,
.leadbot-components textarea,
.leadbot-components select {
  all: revert-layer;
}

Stap 7: test het en kijk in je inbox

Doe één keer zelf de test voordat je bezoekers erop loslaat.

  1. 1Open de pagina op je live site, of via Voorbeeld.
  2. 2Loop het gesprek door tot het eind en laat je gegevens achter.
  3. 3Kijk in de Inbox in het dashboard en open je test. Bij Domein en Leadbot zie je je site en je Inline LeadBot.
  4. 4Open in de Inline LeadBot het tabblad Installatie. Zodra je site hem laadt, staat bij de stap 'Zie je eerste bezoeker' de melding 'Eerste bezoekers zijn binnen'. Dat kan een paar minuten duren.

Meerdere Inline LeadBots

Zet gewoon meerdere shortcodes neer, elk met het ID van een andere Inline LeadBot. Elk gesprek houdt zijn eigen toestand bij, en het script wordt maar één keer geladen. Je gewone widget van andere LeadBots en je componenten blijven daarbij gewoon werken.

[leadbot flow="21"]
[leadbot flow="24"]

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 andere Inline LeadBot of 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 verschijnt het gesprek 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?

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 met Vast in de pagina aan, of het ID in de shortcode klopt en of je op je live domein kijkt.
  • Notitie 'connect the plugin under Settings → LeadBot first' — De plugin heeft nog geen domeinsleutel. Koppel hem zoals in stap 4.
  • Notitie 'add component="<component-id>" or flow="<leadbot-id>"' — De shortcode mist het ID, of het is geen getal. Gebruik alleen het getal uit de adresbalk, bijvoorbeeld flow="21".
  • Op sommige pagina's leeg — Kijk naar de zichtbaarheidsregels en de planning van de LeadBot: daarbuiten toont hij niets.
  • De widget staat er nog — Vast in de pagina gaat pas in na publiceren. Publiceer opnieuw en leeg de cache van je site.
  • Alleen leeg in de Elementor-editor — Dat is normaal. Kijk via Voorbeeld of op de live pagina.
  • Wijzigingen uit de builder komen niet door — Publiceer de LeadBot opnieuw en leeg de cache van je site.
  • Je stijl uit de editor komt niet door — Kijk onderaan de stijleditor: staat er Nog niet live, klik dan op Publiceren. Leeg daarna de cache van je site.

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 gesprek moet komen. Beide staan al ingevuld met je domeinsleutel en het ID van je LeadBot.

<div data-leadbot-type="flow" data-leadbot-step="flow" data-leadbot-id="ID-VAN-JE-INLINE-LEADBOT"></div>

<script
  src="https://script.leadbot.com/components.js"
  data-leadbot-domain-key="JOUW-DOMEINSLEUTEL"
  data-leadbot-id="ID-VAN-JE-INLINE-LEADBOT"
></script>

Terug naar de widget

Zet je Vast in de pagina weer uit en publiceer je opnieuw, dan verschijnt de LeadBot weer als zwevende widget. Haal de shortcode dan ook van je pagina.

Volgende stappen

Kom je er niet uit?

Geen ticketnummer — je spreekt altijd een mens. We denken graag met je mee, van installatie tot optimalisatie.

Het LeadBot-team aan het werk op kantoor