Shopify App

The Buddy Agent Shopify app embeds your agent on your storefront and recognises logged-in customers through Shopify's App Proxy — so the agent can answer order and product questions without a second login.

Install & connect

1. Install the Buddy Agent app on your store (minimal scopes: read orders, products, customers).
2. On the app's settings page, click Connect to Buddy to register your store operations.
3. In Online Store → Themes → Customize → App embeds, enable Buddy Agent.
4. Visit your storefront — the widget appears and logged-in customers are recognised automatically.

How identity works

When a logged-in customer loads a page, the theme embed calls the app's App Proxy (/apps/buddy/identity). The app verifies Shopify's proxy signature, confirms the logged_in_customer_id, and mints a short-lived signed token server-side — the signing secret never reaches the browser.

Operations & scopes

read_orders

List and read orders, scoped to the verified customer.

read_products

Search the catalogue and read product details.

read_customers

Read the verified customer's own record.

The agent calls the Shopify Admin API with the OAuth access token; write actions are off by default. Mandatory GDPR webhooks (customers/data_request, customers/redact, shop/redact) are wired for app review.