#
Подключение NetCat
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.
- В ChatRex откройте Интеграции → Подключить интеграцию → NetCat → Установка соединения. На вкладке находятся краткая инструкция и ссылка на модуль.
- Скачайте модуль для NetCat 7.2.0 E-Commerce. Архив TGZ не нужно распаковывать.
- В админке своего сайта NetCat откройте Инструменты → Установка модуля. В форме Установка модуля с локального диска выберите скачанный архив и запустите установку.
- Дождитесь успешной установки и откройте ChatRex AI-консультант в меню Настройки. Серверный ключ и планировщик настраивает администратор сайта — см. разделы перед подключением и ниже.
#
2. Свяжите сайт с аккаунтом ChatRex
- В модуле ChatRex AI-консультант выберите сайт, если их несколько. Для нового магазина Netshop опубликованные товарные инфоблоки выбираются автоматически.
- Нажмите Подключить к ChatRex. Если сначала требуется сохранить настройки, кнопка называется Сохранить и подключить к ChatRex.
- Откроется ChatRex. Войдите в нужный аккаунт, проверьте сайт и аккаунт, затем нажмите Подключить. Адрес сайта и код вручную вводить не нужно.
- Дождитесь статуса Подключено. В 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:
- Выберите, разрешено ли Чтение заказов.
- Выберите, разрешено ли Создание заказов после подтверждения покупателем.
- Нажмите Сохранить разрешения. Текущее подключение и виджет сохраняются; получать новый одноразовый код не нужно.
- В редакторе бота добавьте нужные действия NetCat и сохраните изменения.
Разрешения определяют, какие операции модуль допускает на стороне NetCat. Настройте в ChatRex, когда бот должен проверять статус или предлагать оформление заказа. Открытие настроек и повторное подключение не включают разрешения автоматически и не сбрасывают уже сохранённые значения.
Для поиска статуса нужны номер заказа и совпадающий email или телефон покупателя. Для создания нужны товары с количеством, имя, email и город покупателя. Сначала бот рассчитывает состав и сумму, затем спрашивает подтверждение. Предпросмотр в редакторе только рассчитывает заказ и не создаёт его.
#
Чат на витрине
- Подключите в ChatRex интеграцию OnChat — онлайн-чат на сайт.
- На её вкладке Настройки добавьте точный HTTPS-домен витрины в поле Домены к которому будет подключен чат-виджет.
- В редакторе бота откройте Каналы и запуск → Добавить канал, выберите OnChat и сохраните изменения.
- В подключении NetCat выберите этот чат в блоке Чат на сайте и нажмите Установить виджет.
- Откройте опубликованную страницу магазина и отправьте тестовое сообщение. Проверьте ответ на компьютере и телефоне.
Модуль добавляет виджет без правок шаблонов 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.
См. также
Подключение CMS и commerce-платформ к ChatRex для работы бота с каталогом, товарами, остатками и заказами.
Поиск товаров, карточки, наличие, ссылки, статус и создание заказов Netshop.
Каталог интеграций ChatRex: каналы, CRM, CMS, маркетплейсы, Desk, системы записи и другие сервисы.