Install WisWes on Shopify

Before you start

• An active Shopify store you administer (any plan — Basic, Shopify, Advanced, or Plus).
• A WisWes workspace — start the free trial if you don't have one yet.
• Your Shopify domain in the form your-store.myshopify.com.

1. Connect your store

1. Sign into WisWes and open Configuration → Commerce.
2. Set Platform to Shopify. The Shopify MCP endpoint (https://{shop}/api/mcp) is filled in for you — Shopify exposes it natively, no auth header required.
3. Enter your Shop domain: your-store.myshopify.com.
4. Click Test connection — a green tick confirms WisWes can read your live catalog. Click Save.

2. Customize the widget

Open Widget in the left nav. Set the title (e.g. Shopifies Wes), primary color, opening message, and the quick-action chips shoppers see on first contact (checkout, customer, order, product). The right-hand pane previews the widget live as you edit. Click Save.

You can come back and tweak any of these later — changes propagate to every storefront within seconds, no redeploy needed.

A — One-click install (recommended)

On the same Configuration → Commerce screen, scroll to the Install with WisWes panel.

1. Confirm the Shop to install on field shows your myshopify.com domain.
2. Click Install with WisWes. You'll be redirected to Shopify to approve write_script_tags + read_themes scopes.
3. Approve. Shopify redirects you back to WisWes and the widget goes live on every storefront page within seconds.

B — Manual script tag

Prefer to keep your theme files the source of truth? Paste the embed snippet from WisWes into theme.liquid instead.

1. In WisWes Configuration → Commerce, scroll to Embed snippet.
2. Copy the <script> tag — it includes your tenant's unique user_token so the widget loads scoped to your workspace.
3. In Shopify admin, open Online Store → Themes → … → Edit code.
4. Open layout/theme.liquid and paste the snippet right before the closing </body> tag.
5. Save. The widget appears on every storefront page on the next reload.

The snippet looks like this (yours has a different token):

<script
  src="https://app.wiswes.com/api/widget/embed.js?user_token=YOUR_TENANT_TOKEN"
  defer
></script>

Verify it works

1. Open your storefront in a fresh browser window. The chat bubble appears in the bottom-right corner with the title you configured.
2. Click it. The greeting message should match what you set under Widget. The four quick-action chips should be visible.
3. Ask "recommend a gift for someone who likes hiking". Wes should reply with real products from your live Shopify catalog (price + product link).
4. Back in WisWes, open Conversations — your test chat is logged with the tool calls Wes made on the right pane.
5. The dashboard Set up your widget card flips step 3 to a green tick: Widget detected on your storefront — installation confirmed.

Tools you get out of the box

The Shopify MCP that ships with your store gives Wes the tools to answer real shopper questions and act on the cart, not just chat:

• search_catalog — semantic search across your live products.
• get_product — full product payload by handle or ID.
• get_cart / update_cart — read and modify the active cart.
• reset_conversation — let the shopper start over.
• set_intent — switch the assistant into a different conversation mode (browse / checkout / support).
• search_shop_policies — return your store's shipping, returns, and privacy policies verbatim.

See every tool, its arguments, and what it returns under Behavior → Tools in your workspace, or in the Tools docs.

Upgrades

Nothing to do. The widget is loaded fresh on every storefront page, so feature releases reach your shoppers as soon as we ship them. Tool changes appear under Behavior → Tools the same day.

Uninstall

One-click install: in WisWes Configuration → Commerce, click Uninstall next to your shop domain. WisWes removes the script tag from Shopify automatically.

Manual snippet: open theme.liquid in Shopify Edit code, delete the WisWes <script> tag, save. Then in WisWes clear the connection under Configuration → Commerce.

Troubleshoot

The chat bubble doesn't appear on my storefront

• Check Configuration → Commerce — the Install on your storefront step on the dashboard should be ticked.
• Hard reload (Cmd-Shift-R / Ctrl-Shift-R) — Shopify aggressively caches templates.
• Open browser devtools, Network tab, look for embed.js from app.wiswes.com. If it's 401 / 403, your user_token is wrong — copy a fresh snippet.
• If you use a third-party storefront (Hydrogen, headless), the script tag must be added to your custom <head> / <body> manually — the one-click install only covers Liquid themes.

Wes returns "I don't see that product" for items that exist

• Wait a couple of minutes after install — the catalog index seeds on the first connection.
• Confirm the products are Active on the same sales channel WisWes connected to.
• If the product is brand new, trigger a re-index from Behavior → Products → Sync from Shopify.

I want WisWes only on certain pages

Use Manual script tag install instead, and wrap the snippet in a Liquid conditional, e.g.:

{% if template contains 'product' or template contains 'cart' %}
  <script src="https://app.wiswes.com/api/widget/embed.js?user_token=YOUR_TOKEN" defer></script>
{% endif %}