Vai al contenuto

Shopify Setup

Learn how to connect your Shopify store to FRENZY.BOT to sync your full product catalog into the knowledge base.

Overview

The Shopify integration imports your complete product catalog — including all variants, options, pricing, inventory levels, and product details — directly into the FRENZY.BOT knowledge base via the Shopify Admin API.

This gives your AI assistant full, structured product awareness. Instead of scraping rendered HTML (which loses data and includes navigation noise), it pulls clean, structured product data from the source.

What You'll Need

  • A Shopify store (any plan)
  • Store owner or staff account with app development permissions
  • Access to the Shopify Dev Dashboard

What Changed in 2026

Since January 1, 2026, Shopify no longer allows creating custom apps directly in the store admin. All new apps must be created in the Dev Dashboard. Instead of a permanent access token (shpat_), you now get a Client ID and Client Secret that are exchanged for short-lived tokens (24 hours). FRENZY.BOT handles the token exchange and refresh automatically — you only need to provide the Client ID and Client Secret.

Step 1: Create an App in the Dev Dashboard

  1. Go to the Shopify Dev Dashboard
    • You can also get there from your Shopify admin → Settings → Apps and sales channels → Develop apps (it will redirect you to the Dev Dashboard)
  2. Make sure you're on the Apps section in the left panel
  3. Click "Create app" in the top-right corner
  4. Select "Start from Dev Dashboard"
  5. Give your app a name (e.g. FrenzyBot) and click "Create"

Permissions

If you don't see the option to create apps, your account may need app development permissions. The store owner can grant these under Settings → Users and permissions in the Shopify admin.

Step 2: Create an App Version with Scopes

Before your app can be installed, you need to create a version that defines what data the app can access.

  1. In your new app, go to the "Versions" tab
  2. Click "Create version"
  3. Configure the following:
    • App URL: Set to https://shopify.dev/apps/default-app-home (FRENZY.BOT is not embedded in the Shopify admin, so use this default URL)
    • Webhooks API version: Select the newest available version
    • Access scopes: Add the following scopes:
      • read_products — allows reading your product catalog
      • read_inventory — allows reading inventory levels
  4. Click "Release"

Scopes Are Set Per Version

If you need to change scopes later, you'll need to create a new version with the updated scopes and release it. Merchants may need to approve the new scopes.

Step 3: Install the App on Your Store

  1. Go to the "Home" tab of your app in the Dev Dashboard
  2. Scroll down and click "Install app"
  3. Select the store you want to connect (or create a new one)
  4. Click "Install"

Your app is now installed and has access to your store's product and inventory data.

Step 4: Copy Your Credentials

  1. Go to the "Settings" tab of your app in the Dev Dashboard
  2. You'll see your Credentials section with:
    • Client ID — a long alphanumeric string (e.g. 2d2d94a879a95bde36e4c42455a84323)
    • Secret — click the eye icon to reveal it, then click the copy button
  3. Copy both the Client ID and the Secret — you'll need them in the next step

Keep Your Secret Secure

The Client Secret is sensitive. Never share it publicly or commit it to version control. If you suspect it has been compromised, click the "Rotate" button in the Dev Dashboard to generate a new one, then update it in FRENZY.BOT.

Step 5: Configure in FRENZY.BOT

  1. Log in to your FRENZY.BOT dashboard
  2. Navigate to Modules in the sidebar
  3. Find the Shopify Products module and click Configure
  4. Fill in the following fields:
    • Store URL: Your Shopify store URL (e.g. mystore.myshopify.com or just mystore)
    • Client ID: Paste the Client ID from Step 4
    • Client Secret: Paste the Secret from Step 4
  5. Optionally adjust:
    • Sync Product Variants: Include full variant data (sizes, colors, per-variant prices)
    • Include Out-of-Stock Products: Whether to index products that are currently out of stock
    • Product Status Filter: Sync active, draft, archived, or all products
    • Max Products to Sync: Cap per sync run (default: 500, max: 5,000)
  6. Click "Save Configuration"

Automatic Token Management

FRENZY.BOT automatically exchanges your Client ID and Secret for a short-lived access token (valid 24 hours) and refreshes it before it expires. You never need to copy or manage tokens manually.

Step 6: Test and Sync

  1. Click "Test Connection" — you should see: 
    ✅ Connected! Found products in store. Sample: "Product Name"
  2. Click "Sync Now" to import your products

FRENZY.BOT will:

  • Fetch all products matching your configured filters (paginated, up to your max limit)
  • Build a rich text representation for each product (including all variants, pricing, inventory)
  • Store each product as a knowledge base item with full structured metadata
  • Index everything for semantic search

On subsequent syncs, only changed products are re-indexed. Unchanged products are skipped for efficiency.

First sync time: Approximately 2–5 seconds per 100 products.

What Gets Indexed

For each product, FRENZY.BOT indexes:

Data Details
Product info Title, description, vendor (brand), product type, tags, handle (URL slug)
Pricing Price, compare-at price (sale pricing)
Inventory Stock quantity per variant, in-stock/out-of-stock status
Variants All size/color/material combinations with per-variant SKU, price, and inventory
Options Available options (e.g. Size: S, M, L, XL; Color: Black, White, Navy)

This enables your AI to answer questions like:

  • "Do you have the Premium T-Shirt in Large in Navy?"
  • "What's the price of the Classic Hoodie?"
  • "Which products are currently in stock?"
  • "What colors does the Performance Polo come in?"
  • "What's the SKU for the Small Black T-shirt?"

Troubleshooting

"Token exchange failed"

  • Cause: Wrong Client ID or Secret, or the app is not installed on the store
  • Fix: Verify your credentials in the Dev Dashboard → Settings tab. Ensure the app is installed (Home tab → Install app)

"401 Authentication failed"

  • Cause: Invalid or expired access token
  • Fix: Check that your Client ID and Secret are correct. FRENZY.BOT auto-refreshes tokens, but if the underlying credentials are wrong it will fail

"403 Access denied"

  • Cause: App version missing required scopes
  • Fix: Go to Dev Dashboard → Versions tab → Create a new version with read_products and read_inventory scopes → Release. You may need to re-approve scopes in the store

"shop_not_permitted"

  • Cause: The app and store are in different Shopify organizations
  • Fix: The client credentials grant only works within the same organization. Ensure the Dev Dashboard app and the target store belong to the same Shopify org. If you're a partner building for a client store, the client needs to create the app in their own Dev Dashboard

"Cannot reach store"

  • Cause: Incorrect store URL
  • Fix: Use the format mystore.myshopify.com or just mystore (FRENZY.BOT auto-completes the domain)

"No products found"

  • Cause: Product status filter excludes all products
  • Fix: Check the status filter setting (active/draft/archived/all) and ensure you have published products

Security Best Practices

  1. Keep secrets secure: Never share your Client Secret publicly or commit it to code
  2. Rotate if compromised: Use the "Rotate" button in the Dev Dashboard to generate new credentials
  3. Minimum scopes: Only read_products and read_inventory are needed — don't add write scopes
  4. Regular audits: Periodically review installed apps in your Shopify admin

Additional Resources