Keyda Widget-API
Voor ontwikkelaars, of iedereen die wil dat de chat opent via een eigen knop.
Installeren
<script src="https://keyda.in/business/widget.js"
data-key="kb_live_your_key_here" async></script>The script tag needs only src and data-key. Everything else — colours, position, greeting, language — comes from your dashboard so you never have to redeploy your site to change them.
The widget is drawn in the language set on Install → Language your bot speaks: its button, placeholders and notices, and the direction of the layout (Arabic and Urdu are right-to-left). The strings arrive with the widget's configuration, so there is no second request and nothing to translate on your side.
Modussen
Zwevend (standaard). Een launcher-knop in de hoek die een chatvenster opent.
Inline. Plaats een lege container op de pagina en de chat vult deze op:
<div data-keyda-bot style="height:520px"></div>De container heeft een hoogte nodig. In de inline-modus is de chat altijd zichtbaar, dus er valt niets te openen of te sluiten.
JavaScript API
Beschikbaar op window.KeydaBot zodra het script is geladen:
| Bellen | Wat het doet |
|---|---|
KeydaBot.open() | Opent het chatvenster |
KeydaBot.close() | Sluit de zaak |
KeydaBot.toggle() | Opent of sluit |
KeydaBot.expand() | Maakt het paneel even hoog als het venster en tot 760px breed |
KeydaBot.shrink() | Terug naar de standaardkaart |
KeydaBot.isOpen | true wanneer de chat zichtbaar is |
KeydaBot.isExpanded | true terwijl het paneel is uitgevouwen |
KeydaBot.clientId | De client id die deze pagina gebruikt |
Voorbeeld: open de chat via je eigen knop "Chat met ons":
<button onclick="KeydaBot.open()">Chat with us</button>window.KeydaBot bestaat mogelijk even niet direct na het laden van de pagina. Koppel handlers aan een klik in plaats van het aan te roepen terwijl de pagina wordt geparseerd.Hoe het zich gedraagt op je pagina
- Het paneel opent boven de lanceerknop, die op zijn plek blijft en de sluitknop wordt. Nogmaals tikken, op de ✕ in de koptekst tikken of op Escape drukken sluit de chat.
- Een bezoeker kan het paneel uitvouwen via de koptekst — het groeit tot de hoogte van het venster en maximaal 760px breed — en deze keuze wordt onthouden in de browser. Op telefoons is het paneel al het hele scherm, dus deze optie wordt daar niet getoond.
- Your logo size setting changes the logo, not the button: the launcher keeps its size and the logo grows inside it. Button size (Install → Appearance) is what resizes the button itself — small, medium or large — whatever shape it is.
- Four button shapes: a pill with your label, a round bubble, a rounded square, and a chat bubble with a tail. The tail sits on the side facing your page.
- Alles wordt weergegeven binnen een shadow root, zodat jouw CSS de widget niet kan beschadigen en de CSS van de widget jouw site niet kan raken.
- Het paneel wordt pas geladen wanneer een bezoeker het opent, zodat het je pagina niet vertraagt.
- Het gesprek van een bezoeker gaat 24 uur door als hij terugkomt, en begint daarna opnieuw.
- Als de assistent onbereikbaar is, toont de widget een kort bericht en veroorzaakt nooit een fout op je pagina.