Integrarea widgetului de chat

Embed

Adaugă widgetul de chat ZENIA pe orice website extern cu un singur tag script. Nu ai nevoie de tooluri de build sau dependențe suplimentare - copiezi snippetul și îl adaugi în HTML-ul site-ului.

Quick start

Exemplu de bază

Adaugă scriptul înainte de tagul de închidere </body>. Domeniul este detectat automat din hostname-ul website-ului pe care este instalat widgetul.

HTML

<script
  src="https://buildbot.ro/js/widget.js"
  data-domain="example.com"
></script>

All options

Exemplu complet cu opțiuni disponibile

HTML — all options

<script
  src="https://buildbot.ro/js/widget.js"
  data-domain="example.com"
  data-theme="buildbot-theme-dark"
  data-position="bottom-left"
  data-welcome-message="Welcome! How can I help you today?"
></script>

Attributes

Atribute acceptate

Atribut	Obligatoriu	Implicit	Descriere
`src`	Da	`https://buildbot.ro/js/widget.js`	Încarcă scriptul extern ZENIA care creează butonul de chat, panoul widgetului și iframe-ul de chat.
`data-theme`	Nu	`buildbot-theme-light`	Setează tema vizuală inițială a widgetului. Valorile acceptate sunt clasele de temă ZENIA, de exemplu `buildbot-theme-light`, `buildbot-theme-dark`, `buildbot-theme-zenia-light`, `buildbot-theme-zenia-dark`, `buildbot-theme-monochrome`, `buildbot-theme-girly`, `buildbot-theme-blush` și `buildbot-theme-console`.
`data-position`	Nu	`bottom-right`	Setează poziția widgetului pe pagină. Valorile acceptate sunt `bottom-right`, `bottom-left`, `top-right` și `top-left`.
Domeniu	Nu se setează în snippet	Detectat automat	Widgetul folosește automat hostname-ul paginii pe care este instalat scriptul, eliminând prefixul `www.`. Nu mai este necesar atributul `data-domain`. Pentru ca widgetul să răspundă corect, domeniul detectat trebuie să existe și să fie indexat în ZENIA.

How it works

Cum funcționează

1. Scriptul citește hostname-ul website-ului pe care este instalat și îl folosește ca domeniu al widgetului.
2. Scriptul creează un buton de chat plutitor și un panou care conține interfața de chat într-un iframe.
3. Când vizitatorul deschide widgetul, iframe-ul primește domeniul detectat și tema selectată, apoi pornește conversația pentru acel domeniu.
4. Vizitatorii pot închide panoul din butonul de închidere, cu tasta Escape sau prin click în afara widgetului.

Embed mode

Mod embed

În integrarea externă, scriptul widget.js controlează partea vizibilă de pe website: butonul plutitor, poziția, panoul și deschiderea sau închiderea widgetului. Interfața de chat este încărcată într-un iframe ZENIA cu modul embed activ, astfel încât chatul să ocupe corect spațiul panoului.

Nu este nevoie să configurezi manual iframe-ul, parametrii de URL sau comunicarea dintre pagină și chat. Scriptul se ocupă automat de aceste detalii.

Themes

Valorile temelor

Pentru data-theme, folosește una dintre clasele de temă acceptate de widget:

Available themes

buildbot-theme-light
buildbot-theme-dark
buildbot-theme-zenia-light
buildbot-theme-zenia-dark
buildbot-theme-monochrome
buildbot-theme-girly
buildbot-theme-blush
buildbot-theme-console

Dashboard

Folosirea snippetului din dashboard

Cea mai simplă variantă este să mergi la Setări → Cod embed pentru domeniul tău și să copiezi snippetul generat. Acesta include scriptul ZENIA și opțiunile de temă și poziție disponibile. Lipește codul în website-ul tău, de preferat înainte de </body>.

WordPress

WordPress / site buildere

Majoritatea site builderelor oferă un bloc Custom HTML, Custom Code sau o zonă pentru scripturi în footer. Lipește snippetul ZENIA acolo. În WordPress, poți folosi un bloc Custom HTML, o setare de cod personalizat a temei sau un plugin de inserare scripturi. Dacă editezi direct tema, adaugă snippetul înainte de </body>.

Ajutor