Connect your first store

Connecting a store is what unlocks Zubby. Until it’s wired, the AI has no catalog to talk about, no inventory to check, and no orders to reason over. This page walks both Shopify and WooCommerce paths from empty workspace to a green checkmark on your store row.

Pick your platform

From the dashboard click Connect store in the top-right corner. You’ll see four tiles: Shopify, WooCommerce, BigCommerce (preview), and Custom (headless). Shopify and WooCommerce are the battle-tested paths.

Shopify path

Shopify is a one-click install. Zubby uses Shopify’s app OAuth flow, so the only thing you do is approve scopes and wait.

1. 1

   Choose Shopify

   You’ll be redirected to https://accounts.shopify.com/ to authenticate. If you’re already logged into the right Shopify admin, it skips this step.
2. 2

   Approve scopes

   We request four read scopes — read_products, read_orders, read_customers, and read_content — plus the write scopes that power cart rescue and catalog write-back: write_orders, write_products, write_order_edits, and write_cart_transforms. Click Install app.
3. 3

   Wait for the sync

   Shopify pushes an initial inventory of every product to Zubby via a bulk operation, then we generate embeddings. You can watch the status in Dashboard → Catalog → Sync.
4. 4

   Enable the App Embed

   From your Shopify theme editor, toggle on the Zubby AI Chat app embed block. Detailed walkthrough at Embed the widget on Shopify.

WooCommerce path

WooCommerce takes a little more setup because we install a WordPress plugin that talks to Zubby’s SaaS, but the experience is still under fifteen minutes.

1. 1

   Generate a setup code

   In the Zubby dashboard, choose WooCommerce. We’ll show you a six-character setup code and a download link for the plugin. Keep both handy.
2. 2

   Install the plugin

   In your WordPress admin go to Plugins → Add new → Upload plugin. Pick the salespilot-ai.zip we generated for you, activate it, and open Settings → Zubby AI.
3. 3

   Pair the store

   Paste your six-character setup code and click Pair. The plugin exchanges the code for a long-lived store token, scoped to your store, and persists it encrypted at rest.
4. 4

   Verify the API base URL

   The plugin defaults to https://api.zubbyai.com. If you’re on a private region, change it under Advanced → API base URL. See the WooCommerce guide for the regional URLs.
5. 5

   Sync your catalog

   Click Sync now. The plugin streams products, variants, taxonomies, and pages to Zubby. Big catalogs (50k+ SKUs) are paginated automatically — leave the tab open.

Confirm everything works

Three checks tell you the wiring is correct:

• Catalog status is green — open Dashboard → Catalog. You should see a count of synced products that roughly matches your store. Off by 1-2% is normal (drafts, hidden items, archived).
• Embeddings finished — the same screen shows an Embeddings progress bar. When it hits 100%, the AI can retrieve by meaning, not just keyword.
• Widget preview answers a real question — head to Widget → Preview and ask something concrete like “What’s your return window?”.

cURL sanity check (advanced)

Want to verify your tenant is reachable from outside the dashboard? Mint a public API key under Settings → API keys, then run:

curl https://api.zubbyai.com/api/v1/merchant/{storeId}/conversations \
  -H "Authorization: Bearer sk_live_..." \
  -H "X-Store-ID: {storeId}"

# Expected: { "items": [...], "nextCursor": "..." } with HTTP 200.

What’s next

With your first store paired, the natural next steps are:

• Configure the widget — pick a mode, set a theme, add audience rules.
• Upload your policies so the AI can quote them verbatim.
• Turn on cart rescue — the highest ROI feature on the platform.