Интеграция: технический справочник разработчика

Этот справочник предназначен для разработчиков, встраивающих 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 — ответ ИИ в поиске по сайту

Эксплуатация

• Интеграция конфиденциальности — согласие, хранение, текст о конфиденциальности
• Ограничения и квоты
• Устранение неполадок и проверочный список

Другие страницы по теме

• Встраивание виджета — короткая версия
• Технические подробности — измерения размера, доступности и контраста
• Открытие чата через собственную ссылку или кнопку
• Промокарточка в чате
• Данные клиентов в чате
• Собственный домен (first-party)
• Резервный канал HTTP
• Автоматическое встраивание текста о конфиденциальности

Термины

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

Все части документации: Документация.