Shopify + Converge
Converge Team
OAuth-connected Shopify app: theme embed for chat + web pixel for live cart and product context
Converge ships a native Shopify app with one-click OAuth install and two storefront extensions: Converge Chat (a theme app embed that loads the widget) and Converge Events (a web pixel that streams the eight standard storefront events — page, product, collection, cart, search, checkout — into the agent inbox).
When a Shopify shopper opens the chat in 2026, the agent's sidebar shows the product they're currently viewing (title, image, variant, price) and the live cart contents — line items, quantity, line price, and total in the store's currency — without the agent asking. Updates stream over WebSocket as the customer keeps browsing.
daily active users transact on Shopify storefronts worldwide. Native chat with cart and product context turns a generic support widget into a sales-floor tool on the channel where most ecommerce questions actually happen. — DemandSage, 2026
Converge does not read orders, customers, or products from the Shopify Admin API. The OAuth flow requests only two scopes — write_pixels to install the events pixel, and read_customer_events for the pixel runtime — and the chat embed runs entirely client-side in the merchant's theme.
What does Converge show in the agent inbox for Shopify?
In the customer sidebar
- Product the shopper is viewing right now (image, title, price)
- Live cart contents with quantity, line price, and total
- Last search query and last collection viewed
- Real-time updates over WebSocket as the customer browses
How it connects
- One-click OAuth install from SettingsConnectorsShopify
- Converge Events web pixel auto-installs via Admin GraphQL
- Converge Chat theme app embed loads the widget on every storefront page
- Two scopes only:
write_pixels+read_customer_events
Why install the Shopify app?
Cut WISMO and resolution time. Agents see the active product and cart the moment the chat opens, so "where's my order?", "do you ship to X?", and "can I get this in size M?" stop blocking the conversation.
Recover carts in-thread. When a customer with items in the cart messages support, agents can answer the blocker (size, shipping, discount) and the customer checks out from the same tab. Spartan Race reported a 27% sales lift after adding live chat to its Shopify storefront (Zendesk customer story, 2026).
Enable Converge Chat and Converge Events together. The chat embed publishes the visitor ID into Shopify's analytics layer; the pixel reads it to bind anonymous browsing to the right Converge customer. Enabling only the chat means agents reply without cart context; enabling only the pixel means events stream in with no thread to attach them to.
Triage with context. Browsing and cart context surface alongside tags, notes, and CSAT history in the existing customer panel — no extra tab, no Admin API call from the agent's side, no Zapier middleware.
Cart-context chat shortens the merchant tax of selling on Shopify: agents stop asking "what's in your cart?" and stop pasting tracking numbers from a second tab. The store's $49/month flat fee for up to 15 agents (Converge) does not scale with conversation or pixel-event volume.
How do you install the Shopify app?
One-click OAuth (recommended): in Converge go to SettingsConnectorsShopify, paste your mystore.myshopify.com domain, and click Connect. You're redirected to Shopify's standard merchant consent screen, approve the two minimal scopes (write_pixels and read_customer_events), and Converge auto-installs the Converge Events web pixel via the Admin GraphQL API. No app embed editing needed for the pixel.
Manual paste (fallback): install the Converge app, open Online StoreThemesCustomizeApp embeds, toggle on Converge Chat, paste your API Key from ConvergeSettingsWidget, and Save. The chat embed always uses this path because theme embeds are owned by the merchant's theme, not the app.
OAuth callbacks are HMAC-verified against the app secret, and the pixel install is idempotent — reconnecting an already-connected store updates the existing pixel rather than duplicating it.
See our breakdown of connecting Squarespace to support for more.
1. Start OAuth from Converge
SettingsConnectorsShopify. Paste your mystore.myshopify.com domain and click Connect. Converge redirects you to Shopify's standard merchant consent screen.
2. Approve the two pixel scopes
Shopify shows write_pixels and read_customer_events — the only scopes the app requests. Approve. The OAuth callback is HMAC-verified against the app secret.
3. Pixel auto-installs
Converge calls Shopify's Admin GraphQL webPixelCreate mutation, idempotently injecting your Converge API key as pixel settings. Browsing and cart events start streaming immediately.
4. Turn on Converge Chat in your theme
Online StoreThemesCustomizeApp embeds. Toggle on Converge Chat, paste your Converge API Key, save. Theme embeds are theme-owned, so this step is always manual.
Ready to try Converge?
$49/month flat. Up to 15 agents. 7-day free trial, no credit card required.
Start Free TrialFrequently Asked Questions
Native. Converge ships a Shopify app with one-click OAuth install, a Converge Chat theme app embed, and a Converge Events web pixel that auto-installs at OAuth time via the Admin GraphQL API. No Zapier, no Make, no custom code.
Two: write_pixels (to install the Converge Events web pixel during OAuth) and read_customer_events (so the pixel runtime can read storefront events). The app does not request read_orders, read_customers, read_products, or any other Admin API scope, and it never calls those endpoints.
The customer sidebar shows the product the shopper is currently viewing (title, image, variant, price) and the live cart contents — line items, quantity, line price, total, and currency. Updates stream over WebSocket as the customer browses, so the panel reflects what the shopper sees right now, not a stale snapshot.
The eight Shopify standard storefront events: page_viewed, product_viewed, collection_viewed, product_added_to_cart, product_removed_from_cart, cart_viewed, checkout_started, and search_submitted. The pixel does not track or transmit personally identifiable information, payment data, or anything outside the standard event payloads.
The public App Store listing is pending review. Until it's approved, merchants install via a custom distribution link from Converge Partners — the OAuth flow, scopes, and pixel install are identical to the public-listing version.
No. Theme app embeds and customer-events web pixels are available on every Shopify plan, including Basic, Starter, and Retail. There is no upgrade requirement.
Yes. The Shopify app, both extensions, OAuth, the pixel runtime, and the connector backend are included in Converge's $49/month flat rate for up to 15 agents. Shopify does not charge anything extra for installing the app.
