Get Started with Sophi

Sophi is an agentic commerce platform. It learns from your product catalog and your shoppers' behavior, then acts — surfacing the right products, at the right moment, without requiring explicit search queries.

There are two integration tracks. Most stores complete both.

Which Path to Start With

Start with Product Integration if you have an existing product catalog. Sophi needs to know your products before it can recommend them. The feed is an RSS 2.0 / Google Merchant Center compatible XML file — if you already export to Google Shopping, you're most of the way there.

Start with Frontend Integration if you want to capture user behavior first, or if your catalog is small enough to onboard manually. The two packages are independent:

• @usesophi/sophi-web-sdk — the Sophi assistant widget
• @usesophi/sophi-web-object — storefront event tracking

You can run them in parallel.

Quick Start (5 Minutes)

This gets your first event to Sophi. You need a Sophi account and your API key from the dashboard.

Step 1: Install the Web Object Package

npm install @usesophi/sophi-web-object
# or
yarn add @usesophi/sophi-web-object

Step 2: Configure Sophi

Define window.sophi_object.config before the Web Object bundle loads — the SDK reads it on startup. Only apiKey is required:

window.sophi_object = {
  config: {
    apiKey: 'YOUR_API_KEY',
    userId: 'usr-123',
  },
};

Then load the bundle:

<script src="https://cdn.jsdelivr.net/npm/@usesophi/sophi-web-object@latest/dist/sophi.min.js" async></script>

See Configuration for every option (maxRetries, debounceMs, debug, storageConsent).

Step 3: Send Your First Events

After the bundle starts, push storefront context with SophiTracker.push(...). Sophi emits one event per watched key — here page produces a page_view and product a product_view:

SophiTracker.push({
  page: {
    type: 'Product',
    url: 'https://store.com/products/blue-dress',
  },
  product: {
    id: '1627421',
    name: 'Blue Dress',
    currency: 'TRY',
    unit_price: 1200.0,
    unit_sale_price: 990.0,
    in_stock: 1,
  },
});

For SPA route changes, add-to-cart, purchases, and login/logout, see Integration patterns.

Use with your AI agent

Next Steps