Dokumentace

Nasazení chatbota

Dva kroky: nasměrujte ho na svůj web a vložte do stránky jeden řádek.

Jak přidám chatbota na svůj web?

V dashboardu otevřete Vložit. Získáte veřejný klíč a úryvek kódu níže. Vložte ho před uzavírací tag </body> svého webu — na každou stránku, kde se má bublina objevit.

<script src="https://grounly.com/widget.js"
        data-key="pk_live_…" async></script>

Klíč je veřejný záměrně. Identifikuje vašeho bota, není to tajemství a ve zdrojovém kódu stránky je bezpečný — právě proto záleží na seznamu povolených domén níže.

Může někdo zkopírovat můj klíč a spustit bota na svém webu?

Ne. Vy určíte domény, na kterých bot smí běžet, a kontrola probíhá na serveru. Widget kontroluje také, ale jen kosmeticky — požadavek z domény, kterou jste neuvedli, je odmítnut bez ohledu na to, za co se stránka vydává. Bez toho by kdokoli mohl utrácet váš zaplacený limit zpráv na vlastní návštěvnost.

Jak dlouho trvá nastavení?

Přidání webu jako zdroje spustí crawl; bot může odpovídat hned, jakmile se naindexují první stránky. Jak dlouho to potrvá, závisí na tom, kolik stránek váš tarif povoluje — viz tarify a limity.

Co se načte v prohlížeči návštěvníka?

Jeden bundle, zhruba 10 kB gzipovaných, vykreslený uvnitř Shadow DOM. Nedědí ani nepropouští CSS vašeho webu, takže vám nemůže rozbít layout a váš styl nemůže rozbít jeho.

Bude fungovat na webu vykresleném JavaScriptem?

Widget ano. Crawler nemusí: čte HTML, které vrátí server, takže web vykreslující obsah až v prohlížeči mu vrátí prázdnou skořápku. Grounly to pozná a nahlásí u zdroje, místo aby tiše nenaindexoval nic — obsah ale nezíská. Viz zdroje.

Nasazení chatbota na web jedním skriptem — Grounly