Welle 4 — Returns API, Metaobjects, and 90-day order backfill
Self-service returns flow, FAQ surfaced from Shopify metaobjects, and a 90-day backfill so brand-new installs feel populated from minute one.
This release closes the last set of integration gaps that matter for new installs. Three things ship.
Self-service returns
OrderWise now subscribes to the Returns Admin GraphQL API. When a customer
asks for a return, the AI calls the live returnRequest mutation against
the merchant's store rather than routing the ticket to email. The merchant
sees the return in their Shopify admin within seconds of the customer
confirming, and the auto-execution rules system can gate refunds behind a
human approval threshold.
- New webhook subscription:
returns/request,returns/approve. - Auto-rule events:
return_requested,return_approved. - Refund cap defaults to the order total minus shipping — configurable per rule.
FAQ as Shopify metaobjects
The knowledge-base entries that drive AI responses can now be authored as
native Shopify metaobjects under the orderwise_faq definition. Merchants
who already maintain a customer-service knowledge base in Shopify don't
have to duplicate it inside OrderWise; we sync it down on a metaobjects/*
webhook and rebuild the retrieval index automatically.
- Definition:
orderwise_faqwithquestion,answer,tags,localefields. - Two-way sync — edits in OrderWise push back to the merchant's metaobject store.
90-day order backfill
When a merchant installs OrderWise, the first thing the AI needs is order context. Until this release, the bot only knew about orders received after install. The new backfill job pulls the last 90 days of orders during the OAuth callback so the very first conversation can reference the customer's actual history.
- Runs as a single GraphQL bulk operation.
- Typical backfill size for a 1k-order/month store: ~3 minutes, ~50MB.
Bug fixes
- Fixed a race condition in
app-proxy-hmacvalidation when the merchant had multiple installations of the embedded app under the same shop. - Storefront widget no longer mounts twice when the theme block is duplicated in the editor.
- App-Bridge toast now respects the merchant's locale on the embedded conversations page.