Интеграция с товарным фидом (XML, Google Merchant)

Подключите любой интернет-магазин к вашему чат-боту ChatLab с помощью товарного фида. Если у вашей платформы нет нативной интеграции с ChatLab, фид позволяет передать чат-боту ваш каталог: он считывает товары из фида, индексирует их с помощью AI Search и отвечает карточками товаров со ссылками на ваш магазин.

Пример диалога

Пример иллюстрирует опыт взаимодействия для клиента. Доступные действия и возвращаемые сведения зависят от этой интеграции и вашей конфигурации.

Важно: рекомендации по e-commerce

После завершения интеграции ниже ознакомьтесь с подробным руководством по оптимизации чат-бота для e-commerce: Как настроить ChatLab для вашего интернет-магазина

Что дает интеграция

Поиск товаров с помощью ИИ - покупатели описывают то, что ищут, своими словами, а чат-бот находит подходящие товары в вашем каталоге. Ответ содержит:

• Название и описание товара
• Цену (а также цену со скидкой, если она указана в фиде)
• Изображение товара
• Прямую ссылку на страницу товара в вашем магазине
• Бренд, наличие, GTIN / SKU и другие атрибуты из фида

Категории - если фид содержит тип товара (например, "Для дома > Кухня > Чайники"), чат-бот может сузить поиск до конкретной категории.

Обновление по расписанию - каталог обновляется по заданному вами графику, поэтому новые товары, актуальные цены и информация о наличии поступают к чат-боту без вашего участия.

Чего интеграция не дает

Фид представляет собой файл, а не прямое подключение к вашему магазину, поэтому чат-бот не может:

• проверять статус заказа
• добавлять товары в корзину или оформлять заказ
• отслеживать точные остатки на складе в реальном времени между обновлениями

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

Требования

• Интеграция Feed XML, входящая в ваш тариф
• Доступ к AI Search и лимит каталога, назначенный чат-боту: проверьте доступный объем в Shop > Products (Магазин > Товары)
• Отсутствие других подключенных интеграций магазинов у этого бота. Ознакомьтесь с последствиями перед отключением существующего магазина.
• Товарный фид в формате XML Google Merchant (Google Shopping), доступный по публичному адресу https. Поддерживаются сжатые фиды (.gz) и фиды, защищенные логином и паролем.

Шаг 1: получите товарный фид из вашего магазина

Запросите у администратора вашего магазина XML-фид товаров с полями Google Merchant. Генерация фида и стоимость необходимых модулей зависят от вашей платформы:

• Magento / Adobe Commerce - модуль фида Google Shopping (например, из Magento Marketplace) генерирует XML по адресу вида https://yourstore.com/feeds/google.xml
• IdoSell - откройте MARKETING > Produkty i reklamy w Google > Feed produktowy dla Google Shopping do samodzielnego zarządzania reklamami и скопируйте URL фида. Убедитесь, что ChatLab может его скачать, так как некоторые фиды ограничивают доступ только для определенных сервисов. См. руководство IdoSell по Google Shopping и информацию об ограничениях доступа к фидам.
• OpenCart - если ваша версия включает расширение фида Google Base, включите его в списке расширений каналов продвижения и скопируйте URL фида данных; в противном случае используйте совместимое расширение для экспорта в XML
• BigCommerce - получите ссылку на скачивание XML из вашего приложения для экспорта фидов. Простое подключение канала Google само по себе не дает Feed URL, который нужен ChatLab
• Shopware 6 - добавьте канал продаж Product comparison, выберите Google Shopping (XML) в качестве шаблона, настройте экспорт и скопируйте его URL. См. руководство Shopware по экспорту.
• osCommerce и самописные магазины - любой модуль, формирующий фид RSS 2.0 или Atom с атрибутами товаров g:

Каждому индексируемому товару нужен уникальный идентификатор (по умолчанию g:id). Настоятельно рекомендуются название и ссылка на товар: при отсутствии названия бот будет использовать идентификатор, а без ссылки невозможно создать рабочую кнопку перехода в магазин. Цена, изображение, описание, наличие и тип товара существенно повышают качество ответов.

Шаг 2: подключите фид в ChatLab

1. Войдите в ChatLab и выберите вашего бота
2. Перейдите на вкладку Connect (Подключение)
3. Нажмите Connect (Подключить) на карточке Feed XML
4. Вставьте Feed URL (URL фида)
5. Если для доступа к фиду требуется авторизация, включите опцию The feed requires a username and password (Фид защищен логином и паролем) и введите учетные данные
6. При необходимости укажите Product language (Язык товаров - двухбуквенный код языка, используемого в фиде)
7. Нажмите Test feed (Проверить фид) - ChatLab загрузит начало фида и покажет формат, количество найденных позиций для предпросмотра (до 2 000 товаров, что не обязательно совпадает с общим объемом фида), до пяти примеров товаров и предупреждения (отсутствие цен, ссылок, изображений или категорий)
8. Нажмите Connect (Подключить)

Если автоиндексация каталога включена, а также доступен необходимый объем и доступ к AI Search, процесс индексации запустится в фоновом режиме сразу после настройки подключения. В противном случае запустите обучение каталога вручную. Отслеживайте ход процесса и возможные ошибки в разделах Shop > Products (Магазин > Товары) или Training > E-commerce catalog (Обучение > Каталог e-commerce); успешное подключение само по себе не означает, что товары уже доступны для поиска.

Шаг 3: нестандартные фиды (сопоставление полей)

Если ваш фид оформлен не в формате Google Merchant, ChatLab все равно сможет его прочитать:

1. Сначала запустите Test feed (Проверить фид) - названия элементов, обнаруженные в вашем файле, появятся в выпадающих списках сопоставления
2. Откройте Field mapping for non-standard feeds (Сопоставление полей для нестандартных фидов)
3. Если отдельный товар обозначается не тегом item или entry, укажите имя тега в поле Product element (Элемент товара)
4. Выберите соответствующий элемент для каждого поля: Product identifier (Идентификатор товара, обязательно), Product name (Название товара), Description (Описание), Product page URL (URL страницы товара), Image URL (URL изображения), Price (Цена), Category path (Путь категории) и остальных
5. Снова нажмите Test feed (Проверить фид) и просмотрите примеры товаров
6. Нажмите Connect (Подключить)

Поля, оставленные со значением "Default (Google Merchant)", сохраняют стандартные имена, поэтому для фида, соответствующего стандарту, сопоставление вообще не требуется.

Шаг 4: расписание обновлений

1. Перейдите в Training > E-commerce catalog (Обучение > Каталог e-commerce)
2. На карточке Feed XML нажмите Retrain (Переобучить)
3. Кнопка Retrain now! (Переобучить сейчас!) немедленно запускает обновление каталога
4. Для автоматического обновления выберите периодичность (ежедневно, раз в неделю или раз в месяц), день и время, затем нажмите Schedule retrain (Запланировать переобучение)

Индексируются повторно только те товары, которые изменились с момента последнего обновления, а товары, удаленные из фида, удаляются и из каталога чат-бота. Доступность расписания зависит от вашего тарифа: для еженедельного и ежемесячного графиков требуется функция запланированного переобучения, для ежедневного - функция ежедневного переобучения.

Шаг 5: настройте действие ИИ

Если автоиндексация каталога включена и у вас есть необходимый доступ, после настройки подключения активируется действие Feed XML - AI product search. В противном случае включите его вручную и запустите обучение каталога. Для настройки перейдите в Settings > Actions (Настройки > Действия) и примените фильтр по платформе Feed XML. Вы можете изменить подпись действия, инструкции для ИИ, а также включить параметр Include product card (Включать карточку товара), чтобы чат-бот получал полную карточку товара вместо краткого описания.

Тестирование интеграции

Откройте виджет вашего чат-бота и попробуйте запросы:

• "Покажи чайники до 50 долларов" (проверка поиска с фильтром по цене)
• "Есть ли у вас синие хлопковые футболки?" (проверка сопоставления по атрибутам)

В ответах должны отображаться товары из вашего фида со ссылками на ваш магазин.

Советы

• Указывайте тип товара в фиде (g:product_type) в виде полного пути, например "Одежда > Мужская > Футболки" - на его основе создается категория, по которой чат-бот сможет фильтровать ассортимент
• Следите за полнотой описаний в фиде: чат-бот ориентируется на них при обработке вопросов покупателей
• Варианты одного товара должны иметь общий item_group_id - ChatLab объединяет их атрибуты цвета, размера, материала и узора в одну карточку в индексе. Первый элемент задает цену и ссылку для всей группы, поэтому сверяйте детали конкретных вариантов в магазине
• Если у вас большой объем данных, сжатый фид (.gz) будет загружаться быстрее

Установка чат-бота на сайт магазина

Чтобы добавить чат-виджет на витрину магазина:

1. В ChatLab откройте вкладку Deploy (Развертывание) нужного бота
2. Выберите Widget (Виджет) и скопируйте фрагмент кода
3. Вставьте его в шаблон вашего сайта перед закрывающим тегом </body> или используйте настройки вставки стороннего HTML / скриптов вашей платформы

Похожие статьи

• Руководство по настройке для e-commerce
• Добавление чат-бота на ваш сайт