AI Customer Support with Medusa
Medusa is an open-source headless commerce platform built for developers. It provides a composable, API-first commerce engine with built-in support for multi-region, multi-currency, and custom workflows. For teams building custom storefronts on Medusa, customer support needs to connect to the same API-first architecture.
Minimal AI connects to the Medusa Admin API and resolves support requests using live store data. The AI checks orders, products, customers, and fulfillment data, working seamlessly with your headless setup.
Setup takes a few clicks. No Medusa plugins to install.
Connecting is effortless. The AI Manager sets everything up for you in minutes - no developers, no complex configuration.
What Medusa does
Medusa is an open-source headless commerce engine built with Node.js. It provides a modular, composable architecture for building custom e-commerce experiences. Medusa supports multi-region selling, tax-inclusive pricing, custom workflows, and a rich plugin ecosystem. The Medusa Admin API provides access to orders, products, customers, regions, shipping options, discounts, gift cards, returns, swaps, and claims.
Key Medusa API capabilities Minimal AI uses
Minimal AI connects to the Medusa Admin API for real-time store data.
Orders API
Access orders with items, fulfillments, payments, and returns.
What the AI does: Reads order details to resolve customer questions about purchases, shipping, and returns.
Products API
Read products with variants, pricing, and inventory.
What the AI does: Answers product questions with accurate pricing and availability data.
Customers API
Look up customer profiles and order history.
What the AI does: Identifies customers and personalizes responses using their history.
Returns / Swaps API
Create and manage returns and exchanges.
What the AI does: Processes returns and exchanges following your configured policies.
What the AI agent can read and write in Medusa
The AI works with Medusa's API-first architecture, the same way your storefront does.
Get information
- •Look up order details and fulfillment status
- •Check product availability and variants
- •View customer profile and history
- •Access return and swap status
- •Check discount and gift card details
Take actions
- •Create returns and swaps
- •Process refunds
- •Update order metadata
- •Cancel unfulfilled orders
- •Update customer information
How to connect Medusa to Minimal AI
Connect in a few clicks. No plugins needed.
Go to Integrations in your Minimal dashboard and select Medusa. Enter your Admin API credentials.
Tell the AI Manager what the agent should handle.
Review and go live.
Real support scenarios the AI handles with Medusa
Headless store order tracking
A customer asks about their order from your custom Medusa storefront. The AI checks the order and fulfillment data and responds with shipping status.
Swap request
A customer wants to exchange a product. The AI creates a swap in Medusa, handling the return and new fulfillment in one flow.
Multi-region pricing question
A customer from a different region asks about pricing. The AI checks the region-specific pricing in Medusa and responds with the correct price including taxes.
Works with Medusa and your helpdesk
Minimal AI connects to Medusa for commerce data and your helpdesk for conversations.
View the full integration details
See setup instructions, related integrations, and more.
Frequently asked questions
Does the AI work with headless Medusa setups?+
Yes. The AI connects through the Medusa Admin API, independent of your frontend.
How hard is it to integrate Medusa with Minimal AI?+
Enter your Admin API credentials and go live. No plugins needed.
Can the AI process returns and swaps in Medusa?+
Yes. The AI uses Medusa's Returns and Swaps APIs following your configured policies.