How does Bookbag integrate with commercetools?

Bookbag connects via the commercetools HTTP API using OAuth 2.0 client credentials. You create an API client in your Merchant Center with the appropriate scopes and enter the credentials in Bookbag.

Which commercetools OAuth scopes does Bookbag need?

Bookbag requires view_orders, manage_orders (for write actions), view_products, view_customers, and manage_payments (for refunds). Read-only scopes are sufficient if you only want Q&A and tracking without write-back.

Can Bookbag process returns in commercetools?

Yes. Bookbag can create return items on commercetools orders and trigger payment refund transactions via the Orders API, within the rules you configure.

Does Bookbag work with commercetools headless storefronts?

Yes. Bookbag's widget is a standalone JavaScript embed that works on any headless frontend — Next.js Commerce, Nuxt, custom React, or any other framework.

Can it handle multiple commercetools projects?

Each commercetools project can be connected to Bookbag separately. Multi-region brands can connect all their projects and manage support from a single Bookbag dashboard.

Does Bookbag support commercetools B2B features?

Bookbag reads B2B-specific order and customer group data available through the commercetools API, allowing it to support B2B buyer inquiries alongside DTC customers.

Headless commerce platform

AI customer support for commercetools headless stores

Connect Bookbag to commercetools and automate order tracking, return processing, and product support — 24/7 on any frontend channel your MACH architecture supports.

Book a demo See pricing

65%

tier-1 ticket deflection at enterprise scale

Multi-region

support from a single Bookbag deployment

API-first

integration — no custom modules needed

Bookbag is an AI customer support agent built for modern ecommerce, and it integrates natively with commercetools via the commercetools HTTP API. commercetools is the leading MACH (Microservices, API-first, Cloud-native, Headless) commerce platform used by enterprise brands. Bookbag reads live order data, product catalog records, customer profiles, and inventory from commercetools to resolve the high-volume support tickets that consume enterprise teams — without requiring custom development.

How Bookbag connects to commercetools

commercetools API client credentials

Create an API client in your commercetools Merchant Center with the required OAuth scopes. Bookbag uses client credentials flow to authenticate and access your project data.

Live order & fulfillment reads

Bookbag queries the commercetools Orders API in real time to give customers accurate order status, shipment tracking, and delivery estimates.

Product & inventory data from commercetools

Your commercetools product catalog, including all product types, attributes, prices, and inventory levels, is synced to power Bookbag's product Q&A.

Write-back via Orders API

With the correct OAuth scopes, Bookbag can update order state, create return items, and trigger refund processes directly in commercetools.

What the agent does on commercetools

Order & shipment tracking

Resolves WISMO tickets using live commercetools order state and shipment data.

Returns & refund processing

Creates return items and initiates payment refunds in commercetools for eligible customer requests.

Product catalog Q&A

Answers questions about product attributes, pricing, availability, and variants using your commercetools catalog.

Promotions & discount codes

Explains active promotions from your commercetools Discount API and helps customers apply valid codes.

Multi-region & multi-currency support

Serves customers across commercetools project regions, currencies, and languages from a single Bookbag account.

Human escalation via help desk

Escalates unresolved complex issues to your support team with full conversation and order context.

Set up in minutes

1Create an API client in your commercetools Merchant Center with scopes: view_orders, manage_orders, view_products, view_customers
2Enter your project key, client ID, client secret, and region in the Bookbag dashboard
3Bookbag syncs your product catalog and order data from commercetools
4Embed the Bookbag widget on your headless frontend (Next.js, Nuxt, custom React, etc.)
5Configure escalation routing for complex tickets in your Bookbag help desk settings

Frequently Asked Questions

Other platforms

Salesforce Commerce Cloud Magento (Adobe Commerce) Shopify Plus

Add AI support to your commercetools store

Join the ecommerce teams resolving more tickets, answering 24/7, and turning support into a revenue channel with Bookbag.

Book a demo See pricing