Shopify Integration

Shopify Setup Guide

Install Commerce Index from the Shopify App Store and get AI-powered commerce management in minutes. Automatic product sync, webhook integration, and one-click agent activation.

Step 1: Install from the Shopify App Store

Search for "Commerce Index" in the Shopify App Store, or use the direct install link provided during onboarding.

Click Install and you'll be redirected to the OAuth authorization flow.

Note

You must be a store owner or have "Manage apps" permission to install Commerce Index.

Step 2: OAuth Authorization

During installation, Shopify will ask you to approve the following permission scopes. Commerce Index only requests what's needed for agent operation:

read_products

Read product titles, descriptions, images, variants, and pricing.

write_products

Update product data — used by the Pricing Agent and SEO Agent.

read_orders

Read order history for analytics, fulfillment tracking, and CX analysis.

write_orders

Update order metadata, tags, and fulfillment status.

read_inventory

Read inventory levels across all locations for the Inventory Agent.

Step 3: Automatic Product Sync

After authorization, Commerce Index performs an initial full sync of your product catalog. Going forward, real-time webhook events keep everything in sync automatically.

Registered Webhook Events

products/create

New product added to Shopify catalog.

products/update

Product title, price, variant, or inventory changed.

products/delete

Product removed from catalog.

orders/create

New order placed by customer.

orders/fulfilled

Order marked as fulfilled or partially fulfilled.

orders/cancelled

Order cancelled by merchant or customer.

inventory_levels/update

Stock level changed at any location.

app/uninstalled

Merchant uninstalls the Commerce Index app.

Product Update Webhook Payload

{
  "topic": "products/update",
  "shop": "your-store.myshopify.com",
  "payload": {
    "id": 7891234567890,
    "title": "Premium Wireless Headphones",
    "vendor": "AudioTech",
    "product_type": "Electronics",
    "variants": [
      {
        "id": 4412345678901,
        "title": "Matte Black",
        "price": "89.99",
        "sku": "ATH-WH-001-BLK",
        "inventory_quantity": 142
      }
    ],
    "updated_at": "2025-12-15T10:30:00-05:00"
  }
}

Order Create Webhook Payload

{
  "topic": "orders/create",
  "shop": "your-store.myshopify.com",
  "payload": {
    "id": 5567890123456,
    "order_number": 1042,
    "total_price": "179.98",
    "currency": "USD",
    "line_items": [
      {
        "product_id": 7891234567890,
        "variant_id": 4412345678901,
        "title": "Premium Wireless Headphones",
        "quantity": 2,
        "price": "89.99"
      }
    ],
    "created_at": "2025-12-15T11:15:00-05:00"
  }
}

Step 4: Enable AI Agents

Navigate to the Agents tab in your Commerce Index dashboard. Toggle on the agents you want to activate. We recommend starting with:

Pricing Agent — Monitors competitor prices and optimizes your pricing.
Inventory Agent — Predicts stockouts and calculates reorder points.
Deal Agent — Creates promotions and publishes to thedeals.ai.

All agents start in observation mode — they'll analyze your data and make recommendations, but won't take action without your approval.

Step 5: Create Your First Deal

Go to the Deals tab and click Create Deal. Select products, set discount parameters, and choose distribution channels.

Your deal will be published to thedeals.ai and can be shared across social media, email campaigns, and messaging channels.

Once the Deal Agent is active, it will automatically suggest promotions based on inventory levels, competitor pricing, and seasonal trends.

Step 6: Connect Messaging

Connect OpenClaw to manage your store from Telegram, WhatsApp, Slack, or iMessage. Link your account with a one-time verification code and start issuing commands.

Try /pulse to see your store health, or /deals to view active promotions.

Full OpenClaw setup guide

Shopify Embedded App

Commerce Index can also run as an embedded app directly inside your Shopify admin panel. This gives you access to the full dashboard without leaving Shopify.

Learn about the embedded app option