# AI support assistant for your Shopify store | Busymate AI Source: https://busymate.ai/zh-Hans/docs/guides/shopify Last modified: 2026-09-04T13:24:41+03:00 Busymate AI for Shopify is an open-source app that adds bro, your store's own support assistant, to your storefront — no theme edit. It learns your products, policies and pages, answers shoppers in their own language, and gives signed-in shoppers answers about their orders. It is listed on our own App Store. ## Before you start - The **Online Store** channel and a theme that supports app embeds (Theme editor → App embeds). - Access to the store's admin to install apps and edit the theme. - The app is open source (MIT); the repository is linked from its listing at [/store/apps/busymate-ai-shopify](https://busymate.ai/store/apps/busymate-ai-shopify). Plans are on the listing and on [/pricing](https://busymate.ai/zh-Hans/pricing). ## 1. Install 1. Open the listing and install the app. Shopify asks you to approve the permissions it uses. 2. The app creates your assistant and connects it to your store — nobody on our side has to do anything. 3. It sets your name and colors, lets your storefront show the chat, connects your store's orders, learns your catalog and policies, and switches the assistant on. 4. Your assistant runs at an address of its own on our domain. No DNS work; the storefront loads it through the app embed. ## 2. Turn it on 1. In the app's Home, use the theme-editor link — it opens **Online Store → Themes → Customize → App embeds** with the **Busymate AI assistant** embed ready. 2. Switch it on and click **Save**. The **Ask us** launcher appears on every storefront page. 3. Home confirms the embed is on by reading your public storefront. We can't confirm it on a password-protected store — switch it on above and the check passes once the store opens. ## 3. Check what it learned At install — and on every reinstall, product change, or when you press **Re-train** under Store connection — the app reads your products, shop policies and pages and gives them to the assistant as its content. Home shows what it learned and when. - Only sellable products count; draft and archived products are left out (and counted separately). - Answers cite the page they came from. When the answer is not in your content, bro says so instead of guessing. ## 4. Name and brand it Open **Assistant settings** in the app. The assistant's name, colors and welcome message are yours — change them and the storefront launcher follows. Nothing here names our brand to your shoppers. ## 5. Signed-in shoppers When a shopper is signed in, the assistant knows who they are and can check their orders. It can look up order status and tracking, and — with the shopper's confirmation — update an address, start a return, or cancel or refund an order. Larger refunds go to you: a refund above your limit is handed to your team with the request attached, never run by the assistant. Nothing changes silently — every change shows the full action first and waits for a yes. ## 6. Billing - **No plan selected yet** — choose the $0 Free plan or a paid plan on Shopify's pricing page; Free-plan limits apply until you do. - Plans include a monthly number of AI **resolutions** (a shopper conversation the assistant handled on its own); paid plans charge per extra resolution up to a monthly cap. The assistant is never switched off for billing. - All charges are billed through Shopify App Pricing on your Shopify invoice. Plans and caps are on the listing and on [/pricing](https://busymate.ai/zh-Hans/pricing). ## What the app can and can't touch - **Permissions it asks for, and why:** your products, pages and shop policies (to learn your store), and your orders, customers, fulfilments and returns (to answer signed-in shoppers and, on confirmation, act on an order). - **What it does not ask for:** access to your theme code; orders older than 60 days (requested separately if you need them). - **Live vs learned:** order look-ups read Shopify live at the moment you ask; products and policies are learned at install and on re-train. - AI answers can be wrong — the assistant answers from your content, cites its source, and says when it is not sure. ## Verify 1. Open the storefront. The launcher is visible. Ask a policy question — the reply cites the policy page. 2. Sign in as a test customer and ask "where is my order". The reply names that shopper's order only. 3. Ask for a refund above your limit. The assistant hands the conversation to your team; it appears in the Inbox. 4. Switch the storefront language. The reply follows the shopper's language. ## Technical details For developers — the merchant flow above needs none of this. At install the app provisions one workspace per store through the Busymate AI MCP (`provision_partner_tenant`), authorized by a proof-of-shop signature, so no operator is involved. It sets branding, allows your storefront origins, registers the store's Admin API as the assistant's connection, trains on the catalog, and publishes one version. Signed-in identity rides Shopify's App Proxy: Shopify signs the request and the app mints a short-lived ES256 launch token for that shopper. The connection's tools have access levels — open to anyone (products, policies), signed-in shoppers (their orders, shipments, returns), and on the shopper's behalf with a confirmation card (update an address, start a return, cancel or refund, up to your refund limit). Content limits are the platform's: at most 40 sources, 20,000 characters each, 40,000 total; large catalogs are trimmed and Home says so. ### Does the app edit my theme? No. It adds an app embed you switch on in the Theme editor. Uninstalling the app removes it. ### Where does the assistant run? At an address of its own on our domain, created at install. The storefront only loads the chat. You can later serve it at your own domain — see [Serve your assistant on your own domain](https://busymate.ai/zh-Hans/docs/guides/custom-domain). ### Can it refund an order? Up to the refund limit you set, and only after the shopper confirms the exact action. Above that limit it hands the conversation to your team. ### What does it cost? Plans are on the listing and on [/pricing](https://busymate.ai/zh-Hans/pricing). Until you pick one on Shopify, the app shows "No plan selected" and the Free-plan limits apply. ## Next - **[Teach your assistant your own content](https://busymate.ai/zh-Hans/docs/guides/knowledge)** — what the app learns, and how to add more. - **[Set up human handoff](https://busymate.ai/zh-Hans/docs/guides/human-handoff-setup)** — staff the Inbox before shoppers ask for a person. - **[Serve your assistant on your own domain](https://busymate.ai/zh-Hans/docs/guides/custom-domain)** — move from the default address to yours.