Центр помощи
Интеграции чат-бота

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

Последнее обновление:

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

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

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

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

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

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

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

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

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

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

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

Карточки товаров всегда ведут в ваш магазин, где клиент завершает покупку. Если вам нужно отслеживание заказов или добавление в корзину, используйте нативную интеграцию.

Требования

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

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

Большинство платформ экспортируют фид Google Merchant прямо «из коробки» или с помощью бесплатного расширения:

  • Magento / Adobe Commerce - расширение для фида Google Shopping (например, из Magento Marketplace) генерирует XML по адресу вида https://yourstore.com/feeds/google.xml
  • IdoSell - «Маркетинг и интеграции», «Сайты сравнения цен и маркетплейсы», «Google Merchant»: включите фид и скопируйте его адрес
  • OpenCart - «Модули / Расширения», «Каналы продвижения», «Google Base»: включите его и скопируйте URL фида данных
  • BigCommerce - «Channel Manager», «Google Shopping» или приложение для фидов из BigCommerce App Marketplace
  • Shopware - «Маркетинг», «Сравнение продуктов», «Google Shopping»: создайте экспорт и скопируйте его URL
  • 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 загрузит начало фида и покажет формат, количество найденных товаров, первые товары в том виде, в котором они будут проиндексированы, а также любые предупреждения (отсутствие цен, ссылок, изображений или категорий)
  8. Нажмите Connect (Подключить)

После успешного подключения ChatLab начнет индексировать каталог в фоновом режиме. В зависимости от размера фида это занимает от одной до нескольких десятков минут. Вы можете следить за прогрессом в разделе 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 включается автоматически для чатботов с продуктом AI Search. Чтобы настроить его, перейдите в раздел Settings > Actions (Настройки > Действия) и отфильтруйте список по платформе Feed XML. Вы можете изменить название действия, инструкции для ИИ, а также включить параметр Include product card (Включить карточку товара), чтобы чатбот передавал полную карточку товара вместо краткого описания.

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

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

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

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

Советы

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

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

Чтобы добавить виджет чата на страницы вашего магазина:

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