Přeskočit na obsah

Referenční přehled JavaScript API widgetu

Widget ChatbotIQ můžete ovládat programově pomocí funkce window.chatbotiq. Toto API je k dispozici, jakmile je na stránce vkládací skript: nemusíte čekat, než se widget načte.


Otevře chat widget.

window.chatbotiq('open');

Pokud už je widget otevřený, neudělá nic.


Zavře chat widget.

window.chatbotiq('close');

Pokud už je widget zavřený, neudělá nic.


Přepne widget mezi otevřeným a zavřeným stavem.

window.chatbotiq('toggle');

Vrátí aktuální stav widgetu.

const state = window.chatbotiq('getState');
// Returns: 'open' or 'closed'

Řazení příkazů do fronty

Sekce “Řazení příkazů do fronty”

API funguje i dřív, než se widget načte. Příkazy se automaticky zařadí do fronty a po inicializaci widgetu se provedou v daném pořadí.

API tak můžete bez obav volat hned po přidání vkládacího skriptu:

<script>
// This works even if the widget hasn't loaded yet
window.chatbotiq('open');
</script>

Praktické vzory pro různé případy použití (vlastní tlačítka, spouštěče na stránce, klávesové zkratky, integrace SPA) najdete v článku Ovládání widgetu pomocí JavaScriptu.