Встановлення на сайт

Коли агента проіндексовано, додати його на сайт — це один тег скрипта. Знайдіть свій сніпет у Віджет → Скрипт.

Сніпет для вбудовування

Вставте це прямо перед закриваючим тегом </body> на кожній сторінці, де хочете показати чат-віджет:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  defer
></script>

Віджет завантажується асинхронно (defer) і не сповільнює сторінку. Він рендериться всередині Shadow DOM, тож не конфліктує з CSS вашого сайту.

Інструкції для платформ

Платформа	Куди вставити
WordPress	Appearance → Theme File Editor → `footer.php`, перед `</body>` (або плагін для скриптів header/footer)
Joomla	Extensions → Templates → Templates → активний шаблон → `index.php`, перед `</body>` (або модуль Custom HTML у Extensions → Modules)
Shopify	Online Store → Themes → Edit code → `theme.liquid`, перед `</body>`
Wix	Settings → Custom Code → Add Custom Code → «Body - end»
Squarespace	Settings → Advanced → Code Injection → Footer
Webflow	Project Settings → Custom Code → Footer Code
Власний HTML	Прямо перед `</body>` у вашому шаблоні

Додавайте скрипт на кожну сторінку (зазвичай у спільний футер/шаблон), а не лише на головну, щоб віджет був скрізь.

Перевірте, що працює

Перезавантажте сайт — чат-бабл має з'явитися в нижньому правому куті.

Не з'явився? Перегляньте код сторінки (Ctrl+U) і переконайтесь, що тег скрипта присутній, а data-api-key не порожній. Перевірте консоль браузера на помилки й переконайтесь, що скрипт не блокується блокувальником контенту.

Передача ідентичності відвідувача (необов'язково)

Якщо ваш сайт уже знає, хто відвідувач (він залогінений), передайте його ім'я та email, щоб бот вітав його на ім'я й заповнював форми лідів і бронювання:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  data-user-name="Іван Петренко"
  data-user-email="ivan@example.com"
  defer
></script>

Рендеріть ці атрибути на сервері зі своєї системи авторизації. Значення передаються AI як контекст ідентифікованого відвідувача.

Мультимовні сайти (необов'язково)

Якщо ваш сайт має кілька мовних версій, вкажіть віджету мову поточної сторінки через data-lang (en, uk, pl, de, es, fr, it):

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="YOUR_KEY"
  data-api-url="https://botchata.net/api"
  data-lang="de"
  defer
></script>

Без цього віджет орієнтується на мову браузера відвідувача, яка може не збігатися з мовою сторінки. Ваші власні тексти — вітання, тизер, підзаголовок та інші — перекладаються в розділі Віджет → Мови в кабінеті; порожнє поле там означає текст за замовчуванням.

Збереження сесій

Віджет пам'ятає розмову кожного відвідувача протягом 48 годин (у межах браузера). Коли він повертається або переходить на іншу сторінку, попередня розмова та історія повідомлень відновлюються автоматично.

Сесії зберігаються в localStorage браузера, з прив'язкою до API-ключа — тож якщо у вас кілька ботів на одній сторінці, їхні розмови ніколи не змішуються. Відвідувач завжди може почати заново кнопкою «Нова розмова» в шапці віджета.

Кілька ботів на одній сторінці

Можна розмістити кілька скриптів віджета на одній сторінці (напр. бот продажів і бот підтримки), кожен зі своїм data-api-key. Вони працюють незалежно й тримають окремі розмови.

Видалення віджета

Видаліть тег скрипта зі свого шаблону. Віджет зникне при наступному завантаженні сторінки — більше нічого прибирати не потрібно.