Bookbag is an AI customer support agent that integrates with Shopify Hydrogen storefronts and any custom headless frontend built on Shopify. Hydrogen is Shopify's React-based framework for building blazing-fast storefronts, and headless Shopify lets brands decouple their frontend from Shopify's checkout and data layer entirely. Bookbag connects to Shopify via the Admin API and Storefront API to read live order data, customer records, and the full product catalog — then deploys its chat widget on your custom frontend with a single JavaScript embed, giving shoppers 24/7 AI-powered support regardless of how your storefront is built.
How Bookbag connects to Shopify Hydrogen/Headless
Shopify Admin API access token
Create a custom app in your Shopify admin and generate an Admin API access token. Bookbag uses this to read orders, customers, fulfillments, and product data from your Shopify backend.
Storefront API for product catalog
Bookbag can also query the Shopify Storefront API to pull publicly available product data, ensuring catalog Q&A is accurate and up to date.
Headless-compatible JavaScript widget
The Bookbag chat widget is a framework-agnostic JavaScript embed that works in any React, Next.js, Remix, or Hydrogen application with a single script tag or component import.
Write-back actions via Admin API
With appropriate scopes, Bookbag can create returns, issue refunds, cancel orders, and update subscriptions directly in Shopify from within your headless storefront.
What the agent does on Shopify Hydrogen/Headless
Order tracking (WISMO)
Answers where-is-my-order questions with live Shopify order, fulfillment, and carrier tracking data — the top support ticket for any ecommerce store.
Returns and exchange automation
Walks customers through your return policy and creates the return or exchange record in Shopify automatically.
Refunds and cancellations
Processes eligible refunds and order cancellations within your configured rules, escalating exceptions to your human team.
Product Q&A from Shopify catalog
Answers product attribute, variant, and stock questions using your live Shopify product and inventory data.
Promotions and discount codes
Explains active Shopify discounts and helps customers troubleshoot codes, reducing coupon-related tickets.
Multi-market and multi-currency support
Supports Shopify Markets and multi-currency storefronts common in headless builds, serving international customers accurately.
Set up in minutes
- 1Create a custom app in your Shopify admin under Settings > Apps and sales channels > Develop apps
- 2Generate an Admin API access token with the required API scopes (orders, products, customers, refunds)
- 3Enter the access token and store domain in your Bookbag dashboard
- 4Embed the Bookbag widget in your Hydrogen or headless frontend using a script tag or the Bookbag React component
- 5Configure escalation rules for complex tickets in your Bookbag help desk settings
Frequently Asked Questions
Other platforms
Add AI support to your Shopify Hydrogen/Headless store
Join the ecommerce teams resolving more tickets, answering 24/7, and turning support into a revenue channel with Bookbag.