Support / Headless

Componenten en Inline LeadBots vormgeven in de visuele editor

In de visuele editor geef je je componenten en Inline LeadBots je eigen huisstijl, zonder CSS te schrijven. Klik op een onderdeel in het voorbeeld en kies een kleur, lettertype, afronding of indeling. Sla op en publiceer: je stijl staat dan op elke pagina waar je LeadBot staat. Je hoeft geen code te kopiëren of te plakken.

Je stijl gaat live als je publiceert. Opslaan bewaart hem alleen in LeadBot; bezoekers zien hem pas na Publiceren. Aan de code op je website hoef je niets te veranderen.

Voor welke LeadBots?

De editor werkt voor twee soorten LeadBots. De gewone LeadBot-widget heeft hem niet; die stel je in op het tabblad Instellingen.

  • Component-LeadBot — Je geeft al je componenten één stijl, en elk component kan daarbovenop zijn eigen stijl krijgen. Bijvoorbeeld één formulier op volle breedte.
  • Inline LeadBot — Je geeft het hele gesprek één stijl: de berichten, de knoppen, de formulieren en de chat erin.

De editor openen

De editor zit op het tabblad Voorbeeld van je LeadBot.

  1. 1Ga naar LeadBots en open je component-LeadBot of Inline LeadBot.
  2. 2Ga naar het tabblad Voorbeeld.
  3. 3Bij een component-LeadBot: kies bovenaan bij Component welk component je wilt vormgeven.
  4. 4Klik op Stijl. Rechts naast het voorbeeld opent de stijleditor. Bij een Inline LeadBot staat hij al open.
De stijleditor naast het voorbeeld. Onderaan zie je of je stijl live staat.

Het voorbeeld

Het voorbeeld laat je LeadBot zien zoals hij op een webpagina staat, met je stijl er al op. Alles wat je verandert, zie je meteen.

Bij een component-LeadBot bekijk je het component met de knoppen boven het voorbeeld in verschillende situaties:

Het bedankbericht, met het voorbeeld op Na verzenden.
  • Formulier / Na verzenden — Alleen bij formulieren. Zo zie en style je ook het bedankbericht.
  • Lichte of donkere achtergrond — Zo zie je hoe het component op een donkere pagina staat. Wil je donkere modus ook op je site, zet dan data-leadbot-theme="dark" op een element eromheen.
  • Desktop- of mobiele breedte — Controleer of velden die je naast elkaar zet op een telefoon nog passen.
  • Component bewerken — Springt naar de instellingen van het component, voor teksten en velden.

Bij een Inline LeadBot: door het gesprek klikken

Bij een Inline LeadBot staat in het voorbeeld je echte gesprek. Een onderdeel kun je pas stylen als het in het voorbeeld staat. Een formulier dat pas na twee knoppen komt, moet je dus eerst opzoeken.

Daarvoor is de knop Elementen selecteren boven het voorbeeld. Staat hij aan, dan kies je met een klik een onderdeel om te stylen. Zet hem uit om gewoon door het gesprek te klikken, tot je bij het formulier bent. Zet hem daarna weer aan en klik op het formulier.

Met Elementen selecteren aan kies je met een klik een onderdeel om te stylen.

Alle componenten of één component

Bij een component-LeadBot kies je bovenaan de editor waar je wijzigingen voor gelden.

Alle componenten geldt voor elk component van deze LeadBot. Begin hier: zet je merkkleur, lettertype en afronding één keer goed, dan kloppen al je componenten.

Dit component geldt alleen voor het component dat je nu bekijkt, en gaat voor de stijl van alle componenten.

Een stip achter Alle componenten of Dit component betekent dat daar al een eigen stijl op staat. Een Inline LeadBot heeft deze keuze niet: je stijl geldt voor het hele gesprek.

Kies waar je wijzigingen voor gelden.

Uitstraling: kleuren, lettertype en vorm

Klik je niets aan in het voorbeeld, dan zie je onder Uitstraling de instellingen voor het hele component of het hele gesprek.

InstellingWat het doet
MerkkleurDe accentkleur voor knoppen, focusranden en de berichten van de bezoeker. Overschrijft de basiskleur uit Instellingen.
Tekst op knoppenDe tekstkleur op knoppen in je merkkleur.
TekstkleurDe kleur van de gewone tekst.
AchtergrondDe achtergrond van het component of de kaarten.
LettertypeStandaard het lettertype van je website. Je kunt ook kiezen uit System UI, Arial, Verdana, Trebuchet, Georgia, Times New Roman en Courier New.
TekstgrootteVan 12 tot 20 pixels. Alleen bij componenten.
Hoeken van de kaartHoe rond de hoeken zijn, van 0 tot 32 pixels.
Hoeken van knoppen en veldenHoe rond knoppen en invoervelden zijn, van 0 tot 28 pixels.
BinnenruimteDe ruimte tussen de rand en de inhoud.
BreedteSmal, Standaard, Breed of Volledig. Volledig vult de ruimte waarin je de LeadBot plaatst.
UitlijningAlleen bij een Inline LeadBot: zet het gesprek links, in het midden of rechts.

Eén onderdeel aanpassen

Wil je alleen de verzendknop of de veldlabels anders? Klik in het voorbeeld op dat onderdeel, of kies het onder Elementen. Als je met je muis over het voorbeeld beweegt, zie je welk onderdeel je aanklikt. Met Alle instellingen ga je terug naar het overzicht.

Bestaat een onderdeel uit kleinere delen, dan staan die onder In dit element. Klik op het chatvenster en je kiest daar de kopbalk, de berichten, de voorgestelde vragen of de berichtbalk. In de kopbalk zitten weer de profielfoto, de naam, de online-status en de menuknop. Onderdelen die je verborgen hebt, staan daar ook, zodat je ze terug kunt zetten.

Een wijziging geldt voor dat onderdeel overal in het component of gesprek: kies je een kleur voor Invoervelden, dan krijgen alle velden die kleur. Onderdelen die je hebt aangepast, staan gemarkeerd als Aangepast.

Klik op een onderdeel in het voorbeeld om alleen dat onderdeel aan te passen.
De onderdelen in het chatvenster.
WaarOnderdelen
Formulier, terugbelverzoek en e-mailverzoekKaart, Titel, Veldlabels, Invoervelden, Knopbalk, Verzendknop en Bedankbericht
ChatbotChatvenster, Kopbalk (met Profielfoto, Naam afzender, Online-status en Menuknop), Berichten van de bot, Berichten van de bezoeker, Voorgestelde vragen en Berichtbalk (met Invoerveld)
WhatsAppWhatsApp-venster, Kopbalk, Chatachtergrond (met Tekstballon) en Berichtbalk (met Invoerveld en Verzendknop)
KnopKnoppenrij en Knoppen
Inline LeadBotGesprek, Berichtkaart (met Profielfoto, Afzenderregel, Berichttekst en Powered by-regel) en Typindicator, plus de onderdelen hierboven van elk formulier, elke chat, WhatsApp-stap en knop in je gesprek

Wat je per onderdeel instelt

Per onderdeel zie je alleen de instellingen die er zin hebben. De belangrijkste:

De indeling van knoppen in een Inline LeadBot.
Animatie: zet beide op 0 voor een stilstaande knop.
  • Kleuren — Tekstkleur, achtergrond en randkleur. Bij de meeste achtergronden en randen kun je ook Transparant kiezen.
  • Tekst — Tekstgrootte, dikte (Normaal, Halfvet, Vet) en uitlijning.
  • Vorm — Afgeronde hoeken, randdikte, schaduw en binnenruimte.
  • Verbergen — Zet bijvoorbeeld de titel, de veldlabels, de kopbalk van de chat of het tijdstip in WhatsApp op Verborgen. De labels van vinkjes blijven altijd staan, zodat bezoekers weten waar ze mee akkoord gaan.
  • Verzendknop — Kies bij Breedte voor Passend en lijn de knop dan links, in het midden of rechts uit.
  • Knoppen — Kies of ze naast elkaar, onder elkaar, 2 per rij of 3 per rij staan, en hoeveel ruimte ertussen zit. In een Inline LeadBot stel je onder Na het klikken ook in hoe een knop eruitziet nadat de bezoeker erop heeft geklikt.
  • Animatie — Bij de verzendknop en de knoppen: hoeveel een knop optilt als je eroverheen gaat en hoeveel hij indrukt als je klikt. Zet beide op 0 voor een knop die stilstaat.
  • Chatvenster — Een minimale en maximale hoogte, en of de berichten bovenaan of onderaan beginnen. Met een maximale hoogte groeit het venster mee met het gesprek.
  • WhatsApp-tekstballon — Kleur (het staartje kleurt mee), tekst, afronding, schaduw, en het staartje en tijdstip tonen of verbergen.
  • Bedankbericht — Tekstkleur, grootte, uitlijning en het vinkje: een andere kleur of helemaal weg. Zet het voorbeeld op Na verzenden om het te zien.
  • Plaats in het gesprek — Alleen bij een Inline LeadBot: zet een berichtkaart, formulier, chat of knoppenrij links, in het midden, rechts of op volledige breedte. Standaard volgt het de uitlijning van het hele gesprek.

Velden naast elkaar zetten

Bij formulieren van een component-LeadBot zet je onder Indeling velden twee velden op één regel, bijvoorbeeld voornaam en achternaam. Klik op Naast elkaar tussen twee velden om ze samen te voegen. Klik nog eens om een veld weer op een eigen regel te zetten. Met Eén veld per regel zet je alles terug.

Je kunt ook de verzendknop naast het laatste veld zetten, voor een korte rij met e-mailadres en knop. De volgorde van de velden verandert niet; die stel je in bij het formulier zelf.

Bekijk het daarna in de mobiele breedte: twee velden naast elkaar zijn op een smal scherm snel te krap.

Klik op Naast elkaar tussen twee velden.
Het resultaat in het voorbeeld.

Teksten aanpassen

In de stijleditor verander je hoe iets eruitziet, niet wat er staat. Klik je op de titel, een veld of de verzendknop van een formulier, dan zie je bovenaan waar die tekst vandaan komt:

Bovenaan zie je waar de tekst staat.
Bewerken opent de instellingen op de juiste plek.
  • In de componentinstellingen — Klik op Bewerken. De instellingen van het component of de stap openen op de juiste plek.
  • Uit een formulier — Het formulier komt van de Formulieren-pagina. Pas de tekst daar aan en publiceer het formulier.

Geavanceerd: zelf CSS schrijven

Bovenaan de editor schakel je tussen Ontwerp en Geavanceerd. Geavanceerd is een CSS-editor met dezelfde stijl: alles wat je in Ontwerp instelt, zie je hier als CSS terug, en wat je hier schrijft, blijft staan als je weer naar Ontwerp gaat. Ook deze CSS gaat live als je publiceert.

  • Typ een punt om de klassenamen te zien.
  • Onder Invoegen staan voorbeelden die je zo toevoegt: merkkleur, lettertype, ronde of rechte hoeken, een pilvormige knop, de kaart weghalen, volledige breedte, de titel verbergen en een veld verplaatsen.
  • Bij Dit component gelden je selectors alleen voor dat component. Gebruik & voor het component zelf.
  • Bij een Inline LeadBot begin je je selectors met .leadbot-flow, zodat ze de rest van je pagina niet raken.

Je CSS mag maximaal 20.000 tekens zijn. Lettertypes laden mag alleen van Google Fonts en Bunny Fonts; andere links in url() of @import worden geweigerd, omdat de CSS op je hele site geladen wordt. Staat er een fout in je CSS, dan kan Ontwerp hem niet lezen en vraagt de editor je die eerst te herstellen. Alle klassenamen en tokens staan in Componenten stylen zoals jij wil.

/* Component-LeadBot, bij Alle componenten */
.leadbot-submit-btn {
  border-radius: 999px;
}

/* Component-LeadBot, bij Dit component */
& {
  --leadbot-form-max-width: none;
}

/* Inline LeadBot */
.leadbot-flow .leadbot-card {
  border-radius: 20px;
}
Wat je in Ontwerp instelt, zie je hier als CSS.
Onder Invoegen staan voorbeelden die je zo toevoegt.

Opslaan en publiceren

Je stijl gaat in twee stappen naar je website. Onderaan de editor zie je waar je staat:

Eerst opslaan…
…dan publiceren.
  • Niet-opgeslagen wijzigingen — Klik op Opslaan, of druk op Cmd+S (Mac) of Ctrl+S (Windows). Met Sluiten zonder opslaan zet je alles terug naar de laatst opgeslagen versie.
  • Nog niet live — Je stijl is opgeslagen, maar je website toont nog de vorige. Klik op Publiceren.
  • Live op je website — Elke pagina met deze LeadBot toont nu je stijl.

Wat Publiceren doet

Publiceren zet de hele LeadBot live, niet alleen de stijl. Heb je ook teksten, velden of stappen aangepast en nog niet gepubliceerd, dan gaan die tegelijk live.

Na het publiceren laadt je LeadBot de nieuwe stijl vanzelf, op elke pagina waar hij staat: met de scripttag, de WordPress-plugin of de npm-pakketten. Je hoeft niets te kopiëren of te plakken. Ververs de pagina op je website om het te zien.

Gebruik je de npm-pakketten (@leadbot/components, @leadbot/react of @leadbot/vue)? Werk ze bij naar de nieuwste versie. Oudere versies laden de stijl uit de editor niet.

Herstellen

Is een instelling aangepast, dan zet Herstel ernaast hem terug naar de standaard. Met Alles herstellen haal je alle stijl weg voor Alle componenten, voor Dit component of voor je Inline LeadBot, ook je eigen CSS.

Tot je opslaat, haal je het terug met Sluiten zonder opslaan. Daarna kan dat niet meer. Je website houdt de oude stijl tot je publiceert.

Voor developers

De SDK laadt de stijl als één stylesheet: een <link data-leadbot-custom-css> aan het eind van de head. Elk component krijgt de klasse leadbot-step-… met zijn ID, zodat de stijl van Dit component alleen dat component raakt. Na een nieuwe publicatie wisselt de SDK het stylesheet om zonder dat de standaardstijl even zichtbaar is.

  • Lever je de CSS liever zelf mee in je eigen bundle? Zet customCss: false in je init() of op LeadBotProvider, of data-leadbot-custom-css="false" op de scripttag of een container. Het stylesheet laadt dan niet.
  • Heeft je site een Content Security Policy, voeg dan de host van het stylesheet toe aan style-src (en aan font-src als je een lettertype laadt). De URL zie je in de link-tag op je pagina.
  • Je eigen CSS werkt gewoon samen met de stijl uit de editor; zie Componenten stylen zoals jij wil.

Werkt het niet?

De meest voorkomende problemen en wat je eraan doet.

  • Mijn site toont de oude stijl — Kijk onderaan de editor. Staat er Nog niet live, klik dan op Publiceren. Ververs daarna de pagina op je website.
  • Opslaan lukt niet: je CSS mag alleen lettertypes laden van Google Fonts of Bunny Fonts — Haal andere links in url() of @import weg en sla opnieuw op.
  • Opslaan lukt niet: je CSS is te lang — Houd het onder de 20.000 tekens.
  • Ik kan een formulier in mijn Inline LeadBot niet aanklikken — Zet Elementen selecteren uit, klik door het gesprek tot het formulier in beeld is en zet het weer aan.
  • De stijl werkt op mijn npm-site niet — Werk de LeadBot-pakketten bij naar de nieuwste versie, en controleer dat customCss niet op false staat.

Verder lezen

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