De banner is een balk met het vraagveld "Stel je vraag". Een klik opent de chat met je agent op volledige breedte. Je gebruikt hem naast of in plaats van de chatknop van de widget.
De code
Zet deze regel op de pagina's waar de banner moet staan. Gebruik het adres en de sleutel uit het installatiescherm van je agent, net als bij de widget.
<script src="ADRES_UIT_HET_INSTALLATIESCHERM/lf-banner.js" data-agent="PUBLIEKE_SLEUTEL"></script>
Attributen
Velden
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| data-agent*(verplicht) | tekst | De publieke sleutel van je agent. Zonder dit attribuut verschijnt de banner niet. | |
| data-position | tekst | bottom | bottom: vast onderaan het scherm, in het midden. top: vast bovenaan. inline: op de plek waar je het script zet. |
| data-text | tekst | Stel je vraag | De tekst in het vraagveld. |
* verplicht
Een voorbeeld met de banner op de plek van het script en een eigen tekst:
<script src="ADRES_UIT_HET_INSTALLATIESCHERM/lf-banner.js" data-agent="PUBLIEKE_SLEUTEL" data-position="inline" data-text="Vraag het onze assistent"></script>
De kleur van de banner komt uit de instellingen van je agent.
Gedrag
- De banner verschijnt alleen als de agent actief is.
- De banner kijkt elke paar seconden opnieuw naar de stand van de agent. Zet je de agent op pauze, dan verdwijnt de banner zonder dat de bezoeker de pagina ververst.
- Op welke apparaten hij verschijnt, komt uit de instellingen van de agent: alle, alleen computer of alleen mobiel.
- Klikt een bezoeker de banner weg, dan blijft hij weg zolang die sessie in de browser duurt.
Als iframe
Kun je geen script plaatsen, gebruik dan dezelfde banner als iframe op het adres /embed/banner.
<iframe src="ADRES_UIT_HET_INSTALLATIESCHERM/embed/banner?agent=PUBLIEKE_SLEUTEL" style="border:0;width:100%;height:64px" title="Chat met ons"></iframe>
Queryparameters
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| agent*(verplicht) | tekst | De publieke sleutel van je agent. | |
| text | tekst | Stel je vraag | De tekst in het vraagveld. |
| url | https-adres | Waar een klik naartoe gaat. Alleen een https-adres telt; anders opent de chat van de agent op volledige breedte. |
* verplicht
Goed om te weten
Embedcodes via de API
GET /api/v1/agents geeft per agent de embedcodes terug: de banner als iframe, de widget en het adres van de chat op volledige breedte. Zie Agents.