Інтеграція: технічний довідник для розробників

Цей довідник — для розробників, які вбудовують reactive.chat у сайт, застосунок або бекенд. Він описує інтерфейси й процеси так, як їх реалізовано в коді, — з назвами, типами, стандартними значеннями та помилками.

Налаштування вигляду, текстів, головного екрана, правил, турів, A/B-тестів та образу ШІ описано в розділі Налаштування. Використання облікового запису й панелі операторів — у Посібнику.

Загальна схема

Your visitors' browser                      reactive.chat                         your server
----------------------                      -------------                         -----------
loader.js  --(trigger)-->   core.<hash>.js  cdn.reactive.chat
   window.ReactiveChat (API, events)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   HTTP fallback (SSE/Poll) <----------->   ws.reactive.chat/rc_wss/h/
                                            chat server  --- POST (signed) ---->  customer data endpoint
                                                         --- POST (signed) ---->  webhook receiver
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  identity secret

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

Розділи

Основи

• Архітектура й робота — складові, їхня взаємодія, версії й доставка
• Швидкий старт — вбудувати, додати домен, CSP, перевірити

У браузері

• Довідник тегу скрипту — усі атрибути data-rc-* та джерела конфігурації
• JavaScript API — усі команди ReactiveChat(…)
• Події — on/off і події DOM
• Ідентифікація відвідувачів і передавання контексту — identify, userHash, exp, track
• SPA та переходи між сторінками
• Безпека й Content Security Policy

З’єднання й доставка

• Власний домен і проксі першої сторони — nginx, Apache, Caddy
• Транспорт: WebSocket, резервний канал HTTP, повторне підключення — протокол, коди помилок і закриття

На вашому сервері

• Кінцева точка даних клієнтів — запит та імпорт замовлень
• Вебхуки — події, підпис, повторні спроби, REST hooks
• Серверний API (REST v1) і MCP
• Інтеграції та канали — WhatsApp, Messenger, Instagram, Telegram, SMS, електронна пошта

Інші місця вбудовування

• Мобільні застосунки — чат у WebView
• Smart Answer — відповідь ШІ в пошуку сайту

Експлуатація

• Інтеграція конфіденційності — згода, зберігання, текст конфіденційності
• Ліміти й квоти
• Усунення несправностей і контрольний список

Інші сторінки на цю тему

• Вбудовування віджета — коротка версія
• Технічні подробиці — вимірювання розміру, доступності й контрасту
• Відкриття чату власним посиланням або кнопкою
• Промокартка в чаті
• Дані клієнтів у чаті
• Власний домен (перша сторона)
• Резервний канал HTTP
• Автоматичне вставлення тексту конфіденційності

Терміни

• Ключ сайту — публічний ключ проєкту (24 символи), включений до фрагмента. Не секрет.
• Проєкт — сайт або застосунок із власними налаштуваннями; кілька проєктів утворюють робочий простір.
• Панель операторів — інтерфейс, де відповідає команда.
• Підтверджений користувач — відвідувач, чию ідентифікацію сервер підписав через userHash.
• Завантажувач / ядро — невелика частина завантаження loader.js та головна частина core.<hash>.js, що завантажується після неї.

Усі частини документації разом: Документація.