Open-source headless ecommerce

AI customer support for Medusa.js stores

Connect Bookbag to your Medusa.js backend and automate order tracking, return handling, and product support — 24/7 on any frontend your headless stack uses.

Book a demo See pricing

65%

of support tickets resolved without a human

Any frontend

Next.js, Gatsby, Nuxt — all supported

Open-source

self-hosted Medusa backends fully supported

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

Bookbag connects to your Medusa.js backend via the Medusa Admin REST API using an admin token or JWT credentials. You provide your Medusa instance URL and credentials in Bookbag, and the agent syncs your store data.

Yes. Bookbag connects to any publicly accessible Medusa.js instance — self-hosted on your own infrastructure, on Railway, Render, or any other cloud provider — as long as the Admin API is reachable.

Yes. Bookbag reads live order status, fulfillment records, and shipment tracking from the Medusa Orders API, giving customers accurate delivery updates the moment they ask.

Yes. Bookbag can create return records via the Medusa Returns API for eligible customer requests, within the return rules you configure in Bookbag.

Bookbag targets the Medusa REST API. As Medusa v2 introduces a new API structure, Bookbag supports the current stable API version. Contact Bookbag support for the latest Medusa v2 compatibility status.

The Bookbag widget is a framework-agnostic JavaScript embed that works with any headless frontend — Next.js, Gatsby, Nuxt, custom React, or plain HTML — regardless of which ecommerce backend powers it.

Other platforms

commercetools Shopify Hydrogen/Headless WooCommerce

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.