Docs/E-Commerce/Shopify Integration

Shopify Integration

The Shopify integration connects your store with a single OAuth click. AIChatVault automatically installs a widget ScriptTag on your store (so you don't paste any code into your theme), registers webhooks to keep data fresh, and syncs your product catalogue to the knowledge base — all in one step.

Connecting via OAuth (recommended)

1

Open your agent and go to Integrations → Shopify

In your agent's sidebar, click Deploy or Integrations, then select the Shopify card.
2

Enter your store URL

Type your Shopify store's myshopify.com domain, for example mystore.myshopify.com. You can enter just the store name (e.g. mystore) and the domain suffix will be added automatically.
3

Click Connect with Shopify

You are redirected to Shopify's OAuth consent screen. Review the permissions and click Install App.
4

Connection complete

You are redirected back to AIChatVault. The integration page shows your store name, currency, plan, and product count. A background product sync starts automatically.
5

Test it

Open the chat widget on your store and ask "Do you have any [product]?" or "What's the status of order #1234?"

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, read_customers, write_customers).
  • 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

  • ScriptTag registered — AIChatVault registers a ScriptTag on your Shopify store that auto-injects the chat widget on every storefront page. No theme editing needed.
  • 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 auto-injection

Shopify is the only platform where the chat widget is injected automatically. Once connected, the widget appears on all storefront pages without any code changes. You can toggle this on or off from the integration page:

  • Widget enabled — the ScriptTag is active and the chat widget loads on every Shopify storefront page.
  • Widget disabled — the ScriptTag is deactivated and the widget is removed from all store pages.

Available actions

ActionDescription
Product Search & RecommendationsSearches the Shopify catalogue and returns product cards with images, prices, and Add to Cart links.
Order Status LookupRetrieves order status, tracking info, and purchase history using order number and email.
View CartDisplays the customer's current Shopify cart contents, quantities, and totals.
Browse CollectionsBrowses Shopify collections to improve product discovery when keyword search returns no results.
Update Customer ProfileLets signed-in customers update their name, email, or phone through chat.
Update Billing AddressLets signed-in customers add or modify billing addresses through natural conversation.

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 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.

💡
Keep your Shopify product descriptions detailed and accurate. The agent uses this text when answering questions like "Tell me about the [product]" or "What's the difference between X and Y?" Sparse descriptions produce vague answers.

Was this page helpful?