Bookbag is an AI customer support agent that integrates with Medusa.js via the Medusa REST API. Medusa is a fast-growing open-source headless commerce platform built with Node.js, designed for developers who want full control over their ecommerce stack. It powers storefronts for direct-to-consumer brands, marketplaces, and digital products, with a rich plugin ecosystem and composable architecture. Bookbag connects to the Medusa backend to read live order data, customer records, and the product catalog — then deploys its chat widget on whatever headless frontend your team has built, giving shoppers 24/7 AI-powered support grounded in real store data.
How Bookbag connects to Medusa.js
Medusa Admin API authentication
Bookbag authenticates with your Medusa.js instance using an admin API token or JWT credentials. It connects to your self-hosted or cloud Medusa backend to read order, product, and customer data.
Live order and fulfillment reads
Bookbag queries the Medusa Orders API in real time, reading order status, fulfillment records, and shipment tracking details to answer delivery questions accurately.
Product catalog sync via Medusa Products API
Your full Medusa product catalog — including variants, prices, inventory levels, and categories — is synced to Bookbag to power accurate product Q&A.
Headless frontend widget embed
The Bookbag chat widget is a framework-agnostic JavaScript embed that works in any Next.js, Gatsby, Nuxt, or custom React frontend with a single script tag or component import.
What the agent does on Medusa.js
Order tracking and delivery status
Resolves WISMO tickets by reading live Medusa order and fulfillment data, cutting the most common ecommerce support query.
Returns and exchange processing
Guides customers through your return policy and creates return records in Medusa for eligible requests.
Refund handling
Processes eligible refund requests via the Medusa Payments API within your configured thresholds, escalating edge cases to a human.
Product catalog Q&A
Answers product attribute, variant, and stock questions using your live Medusa product data.
Discount and promotion support
Explains active Medusa discount codes and promotions to customers and helps them troubleshoot application issues.
Human escalation via help desk
Routes complex or sensitive issues to your support team with full conversation and order context attached.
Set up in minutes
- 1Generate an admin API token or configure JWT authentication on your Medusa.js instance
- 2Enter your Medusa backend URL and credentials in the Bookbag dashboard
- 3Bookbag syncs your product catalog, order history, and customer records from Medusa
- 4Embed the Bookbag widget in your headless frontend (Next.js, Gatsby, custom React, etc.) with a script tag or component
- 5Configure escalation rules for complex tickets in your Bookbag help desk settings
Frequently Asked Questions
Other platforms
Add AI support to your Medusa.js store
Join the ecommerce teams resolving more tickets, answering 24/7, and turning support into a revenue channel with Bookbag.