Shopify Integration
The Shopify integration connects your store with a single OAuth click. AIChatVault registers webhooks to keep data fresh and syncs your product catalogue to the knowledge base automatically. The storefront chat widget is a separate, manual step — see Enabling the storefront widget below.
Connecting via OAuth (recommended)
Open your agent and go to Integrations → Shopify
Enter your store URL
mystore.myshopify.com. You can enter just the store name (e.g. mystore) and the domain suffix will be added automatically.Click Connect with Shopify
Connection complete
Test it
Connecting with a Custom App token (advanced)
If you prefer not to use OAuth — for example in a headless or agency setup — you can connect using a Shopify Custom App access token:
- •In Shopify Admin, go to Settings → Apps and sales channels → Develop apps.
- •Create a custom app, grant it the required API scopes (
read_products,read_orders,write_orders,read_customers,write_customers,read_inventory,read_discounts, andwrite_script_tags).write_ordersis required for order cancellation andread_discountsfor discount code checks — the connection will work without them but those two actions will fail. - •Generate an Admin API access token and copy it.
- •On the Shopify integration page, use the Manual / Custom App option and enter your store domain and the access token.
What happens on connect
- •Webhooks registered — Shopify webhooks are created automatically to notify AIChatVault when products or orders change.
- •Product sync — a background job pulls your full product catalogue into the knowledge base.
- •Widget NOT installed yet — the storefront chat widget is off by default on every new connection. You enable it as a separate step, described next.
Enabling the storefront widget
On the Shopify integration page, pick an installation method and click Enable. Nothing is installed automatically — you always choose one of these two methods first:
Theme App Extension (recommended)
Legacy ScriptTag
Only one method can be active at a time — disable the widget before switching methods. Disabling the widget removes it from your storefront immediately (the ScriptTag is deleted, or the app embed is turned back off).
Available actions
| Action | Description |
|---|---|
| Product Search & Recommendations | Searches the Shopify catalogue and returns product cards with images, prices, and Add to Cart links. |
| Order Status Lookup | Retrieves order status, tracking info, and purchase history using order number and email. |
| View Cart | Displays the customer's current Shopify cart contents, quantities, and totals. |
| Browse Collections | Browses Shopify collections to improve product discovery when keyword search returns no results. |
| Update Customer Profile | Lets signed-in customers update their name, email, or phone through chat. |
| Update Billing Address | Lets signed-in customers add or modify billing addresses through natural conversation. |
| Order Cancellation | Looks up an order and, once the customer confirms via a confirmation card, cancels it. Always requires explicit confirmation before cancelling — never cancels silently. |
| Compare Products | Shows a side-by-side comparison of up to 4 products the customer is considering. |
| Check Return Eligibility | Checks whether an order is still within your configured return window. Governed by the Return Policy panel on the integration page (return window in days, and any product tags excluded from returns). |
| Check Discount Code | Validates whether a discount or coupon code the customer mentions is currently active. |
| Get Cross-Sell / Related Products | Suggests related or complementary products after the customer shows interest in an item. |
Integration details shown on the connected page
- •Store name and Shopify domain.
- •Currency and Shopify plan.
- •Product count from Shopify.
- •Synced product count — products currently indexed in AIChatVault.
- •Last synced at — timestamp of the most recent product sync.
- •Widget status — whether the widget is currently enabled, and which installation method (Theme App Extension or Legacy ScriptTag) is active.
- •Last error — shown if a sync or action call fails, with the error message.
Disconnecting Shopify
Clicking Disconnect removes the integration, deletes the ScriptTag from your store, and deregisters the webhooks. Your synced products are removed from the knowledge base. The agent can no longer answer product or order questions from Shopify data.
Was this page helpful?