# Подключение NetCat

ChatRex находит опубликованные товары NetCat, получает карточки и варианты, проверяет остатки и возвращает ссылки на витрину. Интеграция читает каталог; заказы, покупатели и оплаты не передаются.

# Перед подключением

Поддерживается NetCat 7.2.0 E-Commerce, установленный в корне HTTPS-сайта, с PHP 8.0 или новее и расширениями OpenSSL, mbstring и cURL. Нужен администратор с правом установки модулей. Другие версии и редакции требуют отдельной проверки.

Попросите администратора сервера создать случайный ключ из 32 байтов в base64 и передать его процессам PHP и cron через переменную CHATREX_NETCAT_KEY. Храните ключ вне публичного каталога сайта и сохраняйте при обновлении. Без него модуль не сможет безопасно хранить подключение.

# Подключение каталога

1. В ChatRex откройте Интеграции → Подключить интеграцию, найдите NetCat и нажмите Подключить.
2. На вкладке Установка соединения скачайте модуль для NetCat 7.2.0 E-Commerce.
3. Установите TGZ штатным установщиком модулей NetCat. Откройте настройки модуля ChatRex.
4. Выберите сайт, язык и каталог. Для магазина Netshop выберите Модуль Интернет-магазин (Netshop) и отметьте нужные инфоблоки товаров. Для обычных компонентов дополнительно сопоставьте поля названия, цены, валюты и других данных. Неизвестное количество оставьте пустым.
5. Сохраните настройки и получите одноразовый код. Он действует 10 минут и используется один раз.
6. В ChatRex укажите Публичный адрес сайта и Одноразовый код из NetCat, затем нажмите Подключить каталог.
7. Дождитесь статуса Подключено. Проверьте условия подписки в ChatRex.

Для поиска товар, его инфоблок, сайт и все родительские разделы должны быть включены. Если поиск пустой, начните с проверки публикации этих элементов.

Администратор сервера должен запускать netcat/modules/chatrex/cron.php раз в минуту от пользователя сайта с тем же ключом окружения. Это доставляет уведомления об изменении каталога и проверяет отзыв подключения. Получение товара и остатка выполняется непосредственно из NetCat.

# Чат на витрине

1. Подключите в ChatRex интеграцию OnChat — онлайн-чат на сайт.
2. На её вкладке Настройки добавьте точный HTTPS-домен витрины в поле Домены к которому будет подключен чат-виджет.
3. В редакторе бота откройте Каналы и запуск → Добавить канал, выберите OnChat и сохраните изменения.
4. В подключении NetCat выберите этот чат в блоке Чат на сайте и нажмите Установить виджет.
5. Откройте опубликованную страницу магазина и отправьте тестовое сообщение. Проверьте ответ на компьютере и телефоне.

Модуль добавляет виджет без правок шаблонов CMS. Если на сайте используется CSP, администратор должен разрешить загрузку скрипта с app.chatrex.pro, обращения к API ChatRex и соединение с socket.chatrex.pro. После изменения подключения очистите кэш страниц сайта.

# Обновление и отключение

Перед обновлением сохраните файлы модуля, его таблицы и ключ окружения. Архив обновления содержит файлы модуля и идемпотентный SQL. Его устанавливает администратор сервера: обычный установщик NetCat не принимает повторную установку уже установленного модуля.

Кнопка Разорвать соединение в ChatRex отзывает доступ и выключает виджет этого подключения. Если сайт временно недоступен, отзыв дойдёт при следующем успешном запуске cron. При удалении модуля также уберите его задание cron и очистите кэш страниц. Товары магазина сохраняются.

Настройте действия NetCat, чтобы бот мог обращаться к каталогу. Подписка ChatRex оформляется отдельно от лицензии NetCat.