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

Подключение каталога NetCat, разрешений заказов Netshop и чата ChatRex на витрине.

ChatRex находит опубликованные товары NetCat, получает карточки и варианты, проверяет остатки и возвращает ссылки на витрину. В магазине Netshop также поддерживаются получение статуса и создание заказа после подтверждения покупателем. Автоматическая оплата и оформление доставки не выполняются.

Для подключения нужен модуль ChatRex, установленный на вашем сайте NetCat.

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

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

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

# 1. Установите модуль в NetCat

Если модуль ChatRex уже установлен, переходите к шагу 2.

  1. В ChatRex откройте Интеграции → Подключить интеграцию → NetCat → Установка соединения. На вкладке находятся краткая инструкция и ссылка на модуль.
  2. Скачайте модуль для NetCat 7.2.0 E-Commerce. Архив TGZ не нужно распаковывать.
  3. В админке своего сайта NetCat откройте Инструменты → Установка модуля. В форме Установка модуля с локального диска выберите скачанный архив и запустите установку.
  4. Дождитесь успешной установки и откройте ChatRex AI-консультант в меню Настройки. Серверный ключ и планировщик настраивает администратор сайта — см. разделы перед подключением и ниже.

# 2. Свяжите сайт с аккаунтом ChatRex

  1. В модуле ChatRex AI-консультант выберите сайт, если их несколько. Для нового магазина Netshop опубликованные товарные инфоблоки выбираются автоматически.
  2. Нажмите Подключить к ChatRex. Если сначала требуется сохранить настройки, кнопка называется Сохранить и подключить к ChatRex.
  3. Откроется ChatRex. Войдите в нужный аккаунт, проверьте сайт и аккаунт, затем нажмите Подключить. Адрес сайта и код вручную вводить не нужно.
  4. Дождитесь статуса Подключено. В NetCat появится Открыть ChatRex — это переход в сервис, а не повторное подключение.

Подписки ChatRex оформляются отдельно; установка модуля и привязка сайта не активируют подписку автоматически.

# Настройки подключённого сайта

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

Для уже подключённого сайта сохраняйте настройки кнопкой Сохранить изменения. Она не запускает повторное подключение. При выборе ещё не подключённого источника используется Сохранить и подключить к ChatRex.

Поведение консультанта, правила диалога и действия NetCat настраиваются в редакторе бота ChatRex. Действия с заказами добавляются отдельно. Уже сохранённые товарные инфоблоки, разрешения, ключи и виджет сохраняются при повторном подключении.

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

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

# Разрешения заказов Netshop

Действия с заказами требуют модуля ChatRex 0.2.0 или новее, режима Интернет-магазин Netshop и настроенного стандартного компонента заказов Netshop. Для обычных компонентов доступны только действия с каталогом. Если магазин использует изменённый компонент заказов или дополнительные обязательные поля, нужна отдельная проверка совместимости.

При автоматическом подключении нового магазина Netshop чтение и создание заказов разрешены. Уже сохранённые разрешения, в том числе выключенные, не меняются. Чтобы изменить их в модуле 0.3.2, выберите нужный сайт, откройте Дополнительно, при необходимости выберите Каталог, затем откройте Разрешения NetCat. В предыдущих версиях используется блок Заказы Netshop:

  1. Выберите, разрешено ли Чтение заказов.
  2. Выберите, разрешено ли Создание заказов после подтверждения покупателем.
  3. Нажмите Сохранить разрешения. Текущее подключение и виджет сохраняются; получать новый одноразовый код не нужно.
  4. В редакторе бота добавьте нужные действия NetCat и сохраните изменения.

Разрешения определяют, какие операции модуль допускает на стороне NetCat. Настройте в ChatRex, когда бот должен проверять статус или предлагать оформление заказа. Открытие настроек и повторное подключение не включают разрешения автоматически и не сбрасывают уже сохранённые значения.

Для поиска статуса нужны номер заказа и совпадающий email или телефон покупателя. Для создания нужны товары с количеством, имя, email и город покупателя. Сначала бот рассчитывает состав и сумму, затем спрашивает подтверждение. Предпросмотр в редакторе только рассчитывает заказ и не создаёт его.

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

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

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

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

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

Обновление сохраняет действующие разрешения заказов. После установки проверьте соединение, каталог и виджет, затем при необходимости откройте Дополнительно → Разрешения NetCat и сохраните только нужные разрешения. Обновите страницу администрирования NetCat, чтобы загрузить новый интерфейс модуля. Для подключения без копирования кода нужен модуль 0.3.0 или новее; действия с заказами доступны начиная с 0.2.0.

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

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