Octocom
  • Explainers
    • Self Setup
    • Guided Onboarding
    • Third Party Help Desk
  • CUSTOM INTEGRATIONS
    • Product Data
    • Order Tracking
  • SHOPIFY
    • Chat Widget Tutorial
    • Chat Embed Tutorial
  • WOOCOMMERCE
    • Getting Started
    • Chat Widget Tutorial
  • BIGCOMMERCE
    • Installation
  • MAGENTO
    • Installation
  • Security
    • Security Overview
    • AI Reliability
    • AI Security
    • Customer Authentication
    • Security Controls
    • Subprocessors
Powered by GitBook
On this page
  • Supported Feed Formats
  • Required Fields
  • Recommended Fields for Better Results
  • Suggested Product Feed Schema
  1. CUSTOM INTEGRATIONS

Product Data

If your store doesn’t use a platform we integrate with directly—such as Shopify, WooCommerce, or Shoptet—you can still enable AI-powered product recommendations by providing a product feed in one of the supported formats.

Supported Feed Formats

We support feeds in the following formats:

  • XML (recommended)

  • JSON

  • CSV

A feed is a URL that provides a structured file (in one of the formats above) containing up-to-date data about your products. It usually includes all your products and their key details.

For example: https://yourstore.com/feeds/products.xml

You can typically export these feeds from:

  • Your internal inventory or e-commerce system

  • Google Merchant Center

  • Meta Commerce Manager (Facebook)

  • Other tools that support product data export

Required Fields

To enable basic product recommendations, your product feed must include the following information:

Field
Description

title

Product name

description

Product description

price

Current price

url

Link to the product page

images

At least one product image URL

💡 Note: Your actual field names do not need to match the names shown above. However, this information must be present in your feed.

For example, a column called product_name or name is fine—as long as it contains the correct data.

Without this core data, the AI will not be able to generate any recommendations.

Recommended Fields for Better Results

Including additional fields significantly improves recommendation quality and allows the AI to answer more detailed customer questions.

⚠️ If a piece of information isn’t included in the feed, the AI cannot infer or guess it. Be as comprehensive as possible.

You can expose this information either as dedicated fields or include it within metafields (see the list of recommended fields below).

Field
Useful For Example Products

ingredients

Supplements, cosmetics, food

usage_instructions

Electronics, health products, beauty items

dimensions

Furniture, apparel

Suggested Product Feed Schema

Use the schema below as a reference. You don’t need to follow it exactly, but structuring your data similarly will streamline integration and improve results.

Example Scheme

  • Product Name

  • Product URLs

  • Variants (for each variant):

    • SKU (identifier)

    • Variant URL

    • Stock quantity

    • Can it be sold out of stock? (Yes/No)

    • Is it in stock? (Yes/No)

    • Short description

    • Long description

    • Price details:

      • Current price

      • Regular price (if available)

      • Is it on sale? (Yes/No)

    • Metafields — custom key-value pairs (also known as attributes)

    • Images:

      • Image URL

      • Alt text (optional)

      • Is it the primary image? (Yes/No)

  • Collections/Categories (groups the product belongs to):

    • Collection name

    • Collection slug (URL-friendly name)

    • Collection URL (if available)

    • Short and long descriptions (optional)

  • Product Metafields (custom key-value pairs at the product level)

  • Product Images:

    • Image URL

    • Alt text (optional)

    • Is it the primary image? (Yes/No)

If you’re unsure how to generate a compatible feed or want us to validate a sample, contact us for assistance.

PreviousThird Party Help DeskNextOrder Tracking

Last updated 23 days ago