Вбудовування віджета

Два рядки в head вашої сторінки. Без вбудованого скрипту, тому працює й за суворої CSP.

Коротка версія

Додайте цей рядок до head сторінки й замініть SITE_KEY своїм ключем:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        async></script>

Це все. Завантажувач важить 3,48 кБ і отримує ядро лише тоді, коли браузер має час або відвідувач торкається кнопки чату.

Якщо ви розміщуєте `loader.js` самостійно, потрібен ще один рядок

Дехто воліє завантажувати скрипт зі своєї теки замість нашої мережі доставки — через політику, тестове середовище або просто за звичкою. Це працює, але тоді з’єднання чату потрібно вказати явно:

<script src="/js/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-ws-url="wss://ws.reactive.chat/rc_wss/"
        async></script>

Чому: без цього віджет виводить адресу з місця завантаження скрипту. Якщо це ваш домен, він шукатиме чат там само — і нічого не знайде.

І збій непомітний. Кнопка чату з’являється, вікно відкривається, колір і мова правильні, усе виглядає готовим. Лише жодне повідомлення не надходить. Помилки немає: з’єднання повторює спроби у тлі, і саме це приховує несправність. Лише консоль браузера називає хост, який безуспішно шукається.

Наведене вище значення однакове для всіх наших облікових записів. Лише якщо ви запускаєте сервер самі, вказуйте власне.

Через піддомен вашого сайту

Якщо чат має працювати як перша сторона через власний піддомен (наприклад chat.your-company.com замість cdn.reactive.chat), налаштування проксі описано в посібнику з власного домену. Тоді обліковий запис покаже відповідний фрагмент.

Коли WebSocket заблоковано

Якщо мережа не пропускає WebSocket, наприклад за корпоративним проксі, чат автоматично продовжує працювати через звичайний HTTPS. Для цього Content Security Policy потребує наведеної нижче адреси з https:// на додачу до адреси з wss://. Коли використовується резервний канал і як примусово ввімкнути його для тесту, описано в розділі Резервний канал HTTP.

Відкриття чату власними посиланнями й показ промокартки

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

Автоматичне вбудовування тексту конфіденційності

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

Чому немає вбудованого скрипту

Звична форма, яку надають конкуренти, — вбудований <script>. За суворої Content Security Policy без unsafe-inline він блокується раніше, ніж виконається хоча б один рядок. Наведена вище форма з атрибутами його не потребує.

Що ваша політика має додатково дозволяти:

script-src хост доставки, тут cdn.reactive.chat
connect-src адресу WebSocket, тут wss://ws.reactive.chat
connect-src ту саму адресу також із https:// у ній, тут https://ws.reactive.chat — її використовують офлайн-форма й резервний канал HTTP, коли корпоративний проксі блокує WebSocket

Налаштування в тегу скрипту

data-rc-site-key — обов’язковий. Без нього нічого не запускається, і це навмисно.
data-rc-locale — de, en або pl. Якщо немає, вирішує браузер.
data-rc-brand — колір бренду. Текст коригується до читабельного стану.
data-rc-ws-url — обов’язковий, щойно ви завантажуєте loader.js не з cdn.reactive.chat. Див. розділ вище.

Усе інше є в огляді функцій та на сторінці тарифів.

Докладно в документації

Покроково: Швидкий старт. Кожен атрибут тегу скрипту з типом і стандартним значенням: Довідник атрибутів тегу скрипту. Усі розділи є в документації.

Оновлено: 2026-10-25