Shopify

The Shopify extension turns your Shopify storefront into an AI-powered customer experience. Once connected:

• Logged-in customers are auto-recognized on your storefront — no email/password step in the chat.
• The agent can search your product catalog, show order history and tracking, and generate checkout links during the conversation.
• The chat widget renders directly on your storefront via a Theme App Embed — no theme code editing.

Prerequisites

• A Shopify store running an Online Store 2.0 theme (Dawn, Horizon, Sense, Ritual, etc.). Vintage themes don’t support App Embed Blocks.
• Permission to install third-party apps on the store.

That’s it. No API keys to copy, no developer portal to configure — the OAuth handshake handles everything.

Setup

1. Connect your store

1. Open your agent’s Extensions page.
2. Find Shopify under the Commerce category and click the card.
3. Enter your store domain in the Shopify Store Domain field (e.g., my-store.myshopify.com).
4. Click Connect with Shopify.

You’ll be redirected to Shopify to approve the app. Review the permissions and click Install app. Shopify redirects you back to SynapsAI with a green Connected banner showing your store domain.

Tip

SynapsAI requests these scopes: read_customers, read_orders, read_products. We never ask for write access to your customer data.

2. Enable the chat widget on your storefront

After connecting, three new buttons appear on the Shopify extension page:

• Enable widget on Shopify (green) — opens Shopify’s theme editor with our chat embed pre-toggled.
• Disconnect — removes the app from your store and revokes access.
• Disable — keeps configuration but pauses the integration.

Click Enable widget on Shopify. A new tab opens with the Shopify theme editor, and SynapsAI Chat is already selected in the App Embeds panel. Click Save in the top-right corner.

The chat widget now renders on every storefront page.

Caution

If the Save button isn’t clicked, the chat widget will not appear on your storefront. Shopify treats App Embed activation as opt-in — the merchant has to confirm.

3. Sync your product catalog

To enable product search, click Sync Now under the Shopify Products feature card. This indexes your active products into your agent’s knowledge base. The first sync can take 1-5 minutes depending on catalog size.

After sync completes, your agent can search products in conversation:

Customer: “Do you have any blue snowboards under $500?”

Agent: Shows a carousel of matching products with images, prices, and “Buy now” buttons.

Features

Once connected, four feature cards become enabled in the extension page. Each can be toggled independently.

Shopify Auth

Logged-in customers visiting your storefront are automatically identified at a strong trust level. The chat widget reads the customer’s identity from the page (signed with HMAC) and your agent treats it as verified — no extra email or order-step verification needed.

For anonymous visitors (not logged in), the chat falls back to standard mode (no auto-identity).

Shopify Products

Search and browse your store’s products in chat. Results render as interactive carousels with images, prices, descriptions, and category badges. Customers can tap a product to see details or proceed to checkout.

Configuration	Default	Description
Sync now	—	Triggers a full re-sync. Use after adding new products or changing variants.
Sync status	Not synced / Syncing / Synced	Shows the last sync state.

Shopify Orders

Authenticated customers can view their order history, individual order details, and tracking numbers — all in chat:

Customer: “Where’s my last order?”

Agent: “Order #1042 was shipped yesterday via DHL — tracking: ABC-12345. Estimated delivery March 14.”

The agent only shows orders belonging to the verified customer. Anonymous visitors get a polite “please log in” response.

Shopify Checkout

The agent can generate Shopify checkout links so customers complete purchases directly in your store. Useful when a product question naturally leads to “OK I’ll take it” — the customer gets a one-click checkout button without leaving the chat.

Disconnect

Click Disconnect in the extension page to:

1. Uninstall the app from your Shopify store (the same as removing it from Shopify admin → Apps).
2. Revoke the OAuth access token.
3. Remove the synced product catalog from your agent’s knowledge base.
4. Clear the storefront origin from the chat widget’s allowed-domains list.

This is idempotent — clicking Disconnect a second time is a no-op. After disconnect:

• The Shopify app no longer appears in your store’s Apps page.
• The chat widget stops rendering on the storefront (App Embed becomes inactive).
• Your manually-added catalog items, FAQ entries, uploaded PDFs, and web-crawled URLs are preserved — only Shopify-synced product cards are removed.

You can reconnect any time from the Extensions page; configuration starts fresh.

Note

Disconnect is the full teardown. Use Disable instead if you only want to pause the integration without revoking the OAuth grant or deleting product data — handy when troubleshooting or testing.

Permissions

When you install the SynapsAI app from Shopify, you’re granting the following permissions:

Permission	Why it’s needed
read_customers	Identify logged-in customers in chat for authenticated experiences.
read_orders	Look up the requesting customer’s order history and tracking.
read_products	Sync your product catalog into the agent’s knowledge base.

We never request write access to your customer data, orders, or financial information. The chat widget itself is purely a frontend embed — it doesn’t have any direct access to your store’s data; everything goes through SynapsAI’s backend with your OAuth token.

Troubleshooting

”App embed does not exist” when clicking Enable widget on Shopify

Your active theme is a vintage (pre-2021) theme. App Embed Blocks require Online Store 2.0. Switch to a 2.0 theme:

1. Shopify admin → Online Store → Themes.
2. Pick Dawn (free) or Horizon (free) under “Popular free themes” → Add to theme library.
3. Publish the new theme.
4. Click Enable widget on Shopify again.

Chat widget doesn’t appear on the storefront after clicking Save

• Hard-refresh your storefront (Ctrl/Cmd + Shift + R) — themes can cache.
• Open browser DevTools → Network tab and visit your storefront. Look for chat-loader.js from cdn.synapsai.app. If missing, return to Shopify theme editor and confirm the SynapsAI Chat embed is toggled ON (green) and saved.

Product sync shows “Not synced” after clicking Sync Now

• Wait 1-5 minutes; sync runs asynchronously.
• Refresh the page to see the updated status.
• If status stays “Not synced” for >10 minutes, click Disconnect and reconnect — the access token may have been revoked outside SynapsAI.

”Failed to connect your Shopify store”

• The store domain field expects your-store.myshopify.com (not your custom domain).
• If you’ve installed/uninstalled the app multiple times in a row, Shopify may rate-limit the OAuth flow briefly. Wait 1-2 minutes and try again.

Privacy and data

SynapsAI honors Shopify’s data protection requirements. We process the following GDPR webhooks:

• customers/data_request — when a customer requests their data, we provide an export of any conversation history involving them.
• customers/redact — when a customer requests deletion, we remove their conversation history within 30 days.
• shop/redact — when a store uninstalls SynapsAI for >48 hours, all data tied to that shop is automatically purged.

You can also trigger a manual purge any time by clicking Disconnect.