Shopify

Shopify is the deepest integration in Humagician. It's how Huey looks up orders mid-chat, how Automator runs refunds, and how your KB stays in sync with your live catalog.

Installing

1. From the Humagician dashboard

   Click Connect Shopify. You'll be redirected to your Shopify admin.

2. Approve scopes

   Shopify lists the scopes Humagician requests. Approve.

3. Confirm

   You'll bounce back to Humagician with a green Connected badge under Operations → Integrations.

You can also install Humagician directly from the Shopify App Store if you prefer that flow.

Scopes we request

By default we ask for read-only scopes. Write scopes are opt-in via the Automator config — you can stay read-only forever if that's your model.

How the connection works

Humagician routes every Shopify API call through BRAM, our MCP governance gateway. The flow:

1. Huey/Automator requests an action (e.g. "look up order #1042")
2. The request goes to BRAM, scoped to your tenant
3. BRAM phones home to Humagician for forwarding info: "where is this tenant's Shopify, and what auth?"
4. Humagician responds with the upstream URL + your store's access token (held only in Humagician's DB)
5. BRAM makes the actual call to Shopify, audits the result, returns it

Net effect: your Shopify access token never travels through the AI model. It stays in Humagician, BRAM uses it server-to-server, and the audit trail is in BRAM.

What Huey can see

When connected, Huey gets context like:

• On product pages — the product, variants, price, inventory
• On the cart page — line items, totals
• From customer email — order history, lifetime spend
• From order number — full order details (line items, addresses, fulfillment status, tracking)

These are pulled on-demand per conversation, not bulk-imported, so the data is always live.

What's bulk-imported

The exception: products. We bulk-import your catalog daily into Learned Products so Huey can answer questions like "what's the cheapest snowboard you have?" without making an API call. Manually trigger a re-sync at Librarian → Learned Products.

Multi-store

One Humagician workspace = one Shopify store. If you run multiple stores, create one workspace per store. We're working on cross-workspace shopper recognition for merchants who use the same loyalty program across stores.

Disconnecting

Operations → Integrations → Shopify → Disconnect.

Disconnect immediately revokes the Humagician app from your Shopify admin. We retain your existing conversation data (so historical search still works), but no new Shopify lookups will succeed.

Permissions in Automator

Each Shopify write-action is individually toggleable under Operations → Configuration → Shopify permissions:

• Order lookup (read) — on by default
• Order create / modify / cancel — off by default
• Cart modify — off
• Customer manage — off
• Draft order manage — off
• GraphQL — off (advanced — gives generic API access)

Turn these on as you grow into automation. Most teams start read-only and graduate over time.

Approval rules

Even with write-actions enabled, Automator can be configured to require an operator approval before each one runs. This is the recommended setting for any action that touches money (refunds, cancellations).

See Automator → Approvals.

Webhooks

Shopify webhooks (orders/create, orders/paid, etc.) can trigger Humagician flows. Configure in Operations → Configuration → Shopify webhooks.

Common patterns:

• "When an order ships, send the customer a chat-channel update"
• "When a refund is issued, post to our internal Slack"
• "On customers/create, add them to our CRM"

Plan compatibility

Humagician works with every Shopify plan (Starter through Plus). Plus stores get access to more aggressive caching tiers + per-shop inference allocations on request. Contact us if you're on Plus and want enterprise terms.

Headless / hydrogen

The chat widget script also drops into headless storefronts (Hydrogen, Next.js custom). See Chat widget → Embedding outside Shopify.