Встановіть віджет

Віджет RolChat - це одна плаваюча кнопка, яка підлаштовується під увімкнені вами модулі: чат, форма замовлення зворотного дзвінка, бронювання зустрічей, форма для лідів і пошук по базі знань розміщуються всередині неї. Встановіть її один раз, а що саме вона показує, визначається в панелі керування.

1. Скопіюйте фрагмент коду

У розділі Налаштування → Віджет оберіть сайт і скопіюйте фрагмент коду для встановлення. Він виглядає так:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

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

stub.js важить кілька кілобайтів і довантажує решту лише тоді, коли це потрібно відвідувачу: інтерфейс чату під час першого відкриття, відстеження після згоди, банер згоди там, де він обов’язковий.

2. Вставте його перед </body>

Додайте фрагмент на кожну сторінку, де потрібен віджет, найкраще через шаблон сайту або менеджер тегів, щоб він з’явився скрізь одразу. Скрипт завантажується асинхронно й не блокує рендеринг; пакет першого завантаження навмисно зроблено малим, щоб він не впливав на ваші Core Web Vitals.

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

Відкрийте свій сайт у приватному вікні. Кнопка з’явиться в обраному вами куті. У панелі керування розділ Відвідувачі в реальному часі показує нову анонімну сесію, а повідомлення, надіслане з віджета, з’являється в Єдиній скриньці як новий діалог.

Ідентифікуйте авторизованих користувачів

Якщо ваші відвідувачі входять у ваш продукт, повідомте RolChat, хто вони, щоб діалоги прив’язувалися до правильного контакту:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

Приймаються атрибути email, phone, first_name, last_name, external_id і плоский об’єкт custom_fields; усе інше ігнорується. RolChat шукає e-mail у CRM. Якщо контакт існує, сесія прив’язується до нього, і агент бачить профіль; якщо ні, дані зберігаються, а лід створюється, коли відвідувач уперше напише.

Для більшої довіри ваш бекенд може підписувати ідентичність: передайте разом з атрибутами підпис, який RolChat видає для користувача, і сесія буде підвищена лише після успішної перевірки підпису. Викликайте window.rolchat.reset(), коли користувач виходить, інакше наступна людина в цьому браузері побачить попередній діалог.

JavaScript API

window.rolchat доступний, щойно виконається stub; виклики, зроблені до завантаження пакета, стають у чергу й виконуються по порядку.

Метод	Що робить
show() / hide()	Показати або сховати кнопку запуску
open() / close()	Відкрити або закрити панель чату
identify(traits)	Прив’язати сесію до людини (див. вище)
reset()	Забути ідентичність і почати нову анонімну сесію
pushEvent(name, props)	Передати власну подію для тригерних повідомлень і автоматизації
trackPageView(path?)	Передати перегляд сторінки в односторінкових застосунках
setLocale(code)	Змінити мову віджета
showConsentPreferences()	Відкрити центр налаштувань згоди
on(event, handler) / off(event, handler)	Підписатися на chat:opened, chat:closed, message:sent, message:received, session:started

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

Мова та напрямок тексту

Віджет говорить мовою, яку ви закріпили параметром lang у window.rolchatConfig (наприклад, "lang": "de"); без нього - мовою браузера відвідувача, у порядку вподобань браузера, з 40 мов, які підтримує RolChat; якщо жодна не підходить, - англійською. Мовне налаштування самого сайту не використовується: щоб віджет говорив мовою вашого сайту, задайте lang. Арабська та іврит відображаються справа наліво. Віджет не перекладає повідомлення агентів; натомість на боці агента можна використовувати живий переклад за допомогою ШІ.

Cookie та згода

Віджет не відстежує відвідувачів до надання згоди там, де банер згоди обов’язковий. Якщо ви використовуєте модуль Конфіденційність RolChat, банер і віджет мають спільний стан згоди. Якщо ви використовуєте інший інструмент згоди, аналітичні події віджета чекають сигналу, який ви налаштуєте в розділі Налаштування → Конфіденційність → Вбудовування.

Де налаштовується віджет

Що	Де
Кольори, розташування, привітання, точки входу, фрагмент коду для встановлення	Налаштування → Віджет
Які модулі з’являються у віджеті	Налаштування → Модулі (для кожного сайту)
Робочі години та повідомлення для офлайн-режиму	Налаштування → Сайти → Робочі години
Тригерні повідомлення на певних сторінках	Маркетинг → Тригери