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

ChatRex использует автоматически обновляемую YML-выгрузку Nethouse для поиска товаров, получения карточек, проверки доступности и ссылок. Доступ к заказам, покупателям и оплатам не требуется.

1. В кабинете Nethouse откройте Магазин → Маркетплейсы.
2. Включите передачу каталога и сохраните настройки.
3. Скопируйте ссылку автоматически обновляемой YML-выгрузки. Обычно она заканчивается на pricelist.xml; используйте адрес, который показан в вашем кабинете.
4. Проверьте, что витрина и выгрузка доступны по HTTPS и выгрузка содержит нужные товары.

Не загружайте в ChatRex разовый файл: для обновления каталога нужна действующая ссылка.

1. Откройте Интеграции → Подключить интеграцию, найдите Nethouse и нажмите Подключить.
2. На вкладке Установка соединения заполните Публичный адрес сайта и YML-ссылка каталога.
3. Нажмите Подключить каталог и дождитесь статуса Подключено.
4. Проверьте условия подписки ChatRex и добавьте действия Nethouse боту.

Выгрузка хранится зашифрованно. Допускается YML до 20 МБ. Сервер повторно синхронизирует каталог каждые 30 минут; изменения не появляются мгновенно. При ошибке импорта прежняя успешная версия не заменяется частично загруженными данными. Не используйте устаревшие данные как подтверждение актуального остатка.

Значение «есть в наличии» в YML не означает, что известно количество на складе. Эта интеграция передаёт доступность без точного количества. Бот должен сообщать наличие без выдуманного остатка.

Цена, валюта, описание и характеристики берутся из выгрузки. Полнота этих данных зависит от настроек магазина.

Товар может отсутствовать в выгрузке, даже если его страница открывается на сайте. Например, в проверенном магазине товар с нулевым остатком и выключенной продажей под заказ не попадал в YML. Если поиск не находит товар, проверьте его присутствие в выгрузке и настройки доступности в Nethouse. Отсутствие в поиске само по себе не подтверждает нулевой остаток.

Подключение каталога и установка чата — отдельные шаги. Для чата нужны подключение OnChat в ChatRex, счётчик Яндекс Метрики и контейнер Яндекс Тег Менеджера. Доступность приложения Метрики в Nethouse проверьте в своём тарифе сайта.

1. Подключите OnChat в ChatRex и добавьте HTTPS-домен витрины в разрешённые домены на вкладке Настройки.
2. Назначьте OnChat боту во вкладке Каналы и запуск и сохраните бота.
3. В подключении Nethouse выберите чат и нажмите Получить код виджета. Сохраните адрес из атрибута src: он содержит идентификатор вашего OnChat.

1. В Яндекс Метрике выберите существующий счётчик этой витрины или создайте новый с её доменом. Вебвизор для работы чата не требуется.
2. В Nethouse откройте Приложения → Яндекс.Метрика, вставьте код этого счётчика и сохраните настройки.
3. В Яндекс Метрике откройте Тег Менеджер для этого счётчика и создайте контейнер, если его ещё нет.
4. Разрешите использование пользовательского HTML в настройках счётчика, если интерфейс запрашивает это при создании тега.

В контейнере создайте тег Пользовательский HTML. Виджет ChatRex загружается как JavaScript-модуль: для этого используйте загрузчик ниже. Замените ID_ВАШЕГО_ONCHAT на идентификатор из полученного в ChatRex адреса src.

<script>
(function () {
  if (document.getElementById("chatrex-nethouse-widget")) return;
  var script = document.createElement("script");
  script.id = "chatrex-nethouse-widget";
  script.type = "module";
  script.src = "https://app.chatrex.pro/chatrex-widget.js?integration_id=ID_ВАШЕГО_ONCHAT";
  document.head.appendChild(script);
}());
</script>

1. Настройте запуск тега на страницах вашей витрины. Если счётчик используется на нескольких сайтах, ограничьте запуск нужным доменом.
2. Сохраните тег и опубликуйте версию контейнера. Сохранённый черновик ещё не запускает виджет на сайте.
3. Откройте публичную витрину и раскройте чат. Обновление опубликованного контейнера может появиться с задержкой из-за кеширования.
4. Задайте вопрос о товаре, который есть в YML, и дождитесь ответа. Сверьте название, цену и ссылку с витриной.

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

Нажмите Разорвать соединение в подключении Nethouse. Каталог станет недоступен действиям бота. Чтобы убрать чат с витрины, отдельно отключите тег ChatRex в Яндекс Тег Менеджере и опубликуйте изменения контейнера.

Подписка на ChatRex оформляется внутри ChatRex отдельно от тарифа Nethouse.