Shopify-Aware Workflows and Automated Agent Actions
Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.
MerchantAI goes beyond answering questions — when connected to your Shopify store, it can take meaningful steps in the shopping journey on a visitor’s behalf. Workflows are the actions your agent can perform, from helping a shopper find the right product to surfacing their order status. Each workflow is designed so that your team stays in control of anything sensitive, while your agent handles the high-volume, low-risk interactions automatically.
When a shopper describes what they are looking for, the agent searches your indexed Shopify catalogue and surfaces relevant products, variants, and collections. It activates whenever a visitor asks about a product category, a specific use case, or product attributes such as size, colour, or material.
Cart review and checkout links
The agent can review the contents of a shopper’s current cart and present a direct link to the Shopify checkout. This workflow activates when a shopper asks about their cart, requests help completing a purchase, or needs confirmation of what they are about to buy. The actual checkout process — payment, address entry, and fulfilment — happens entirely within Shopify.
Order lookup
When order lookup is enabled for your workspace, the agent can retrieve the current status and tracking information for an order when a shopper provides their order number and email address. It activates when a visitor asks where their order is or requests a delivery update.
Refunds, order cancellations, returns, discount applications, and sensitive account changes are never handled by the agent. These actions always trigger a handover to your human team. Do not configure the agent to attempt these actions, and make sure your system prompt does not suggest otherwise.
Order lookup is not active by default. You must explicitly enable it for your workspace in Configuration → Workflows → Order Lookup. Once enabled, the agent can surface order status and tracking details when a shopper supplies a matching order number and email address. Order lookup exposes only order status and shipping information — it does not surface payment details, billing addresses, or any financial data.
The cart review workflow provides the shopper with a summary of their current cart and a link that takes them directly to the Shopify checkout page. MerchantAI does not process payments, modify cart contents programmatically, or interact with Shopify’s checkout flow beyond generating the link. Your store’s existing checkout, payment gateway, and fulfilment logic remain fully intact.
Any workflow action that MerchantAI identifies as sensitive — such as a request to change an order, process a refund, or apply a discount — automatically triggers a handover to your human team. The agent does not attempt the action; instead it surfaces the handover card for the visitor and passes the full conversation context to your team. You can configure additional triggers for human approval in Configuration → Guardrails → Escalation Rules.
Before going live, use the Preview mode in the dashboard to test each workflow with realistic shopper queries. Run through product searches, cart review, and order lookup with test data so you can confirm the agent behaves as expected before real visitors interact with it.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Merchant AI","description":"Documentation for MerchantAI. The AI support associate for your website.","colors":{"primary":"#2d9e9d","light":"#2d9e9d","dark":"#2d9e9d"},"logo":{"light":"https://mintcdn.com/merchantai/L-exzcSnLhLx0vgj/images/Logo.png?fit=max\u0026auto=format\u0026n=L-exzcSnLhLx0vgj\u0026q=85\u0026s=a1bdb6c5b289c99bb6740f077b8a3178","dark":"https://mintcdn.com/merchantai/L-exzcSnLhLx0vgj/images/MerchantAILogo-04.png?fit=max\u0026auto=format\u0026n=L-exzcSnLhLx0vgj\u0026q=85\u0026s=640ee3fa694f38e2c763573a8a026a16"},"favicon":{"light":"https://mintcdn.com/merchantai/L-exzcSnLhLx0vgj/images/MerchantAILogo-05.png?fit=max\u0026auto=format\u0026n=L-exzcSnLhLx0vgj\u0026q=85\u0026s=bcd6b5ee439348cfc578892d4734e494","dark":"https://mintcdn.com/merchantai/L-exzcSnLhLx0vgj/images/MerchantAILogo-05.png?fit=max\u0026auto=format\u0026n=L-exzcSnLhLx0vgj\u0026q=85\u0026s=bcd6b5ee439348cfc578892d4734e494"},"background":{"decoration":"gradient"},"navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://merchantai.io/dashboard"}},"footer":{"socials":{"x":"https://x.com/MerchantAI_App","linkedin":"https://www.linkedin.com/showcase/merchantai","facebook":"https://www.facebook.com/merchantaiapp","instagram":"https://www.instagram.com/merchantai_app","website":"https://merchantai.io/"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","mcp","add-mcp"],"display":"header"},"interaction":{"drilldown":true},"navigation":{"directory":"card","pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"merchantai","hasAudioNarration":false,"actualSubdomain":"merchantai","customDomains":["docs.merchantai.io"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-merchantai-93e65ef4","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"80c21ec6-56f0-4dc6-a200-805da2bac632","liveDeploymentHistoryId":"6a452bc085cc3c48658ab384","schemaVersion":"v3"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a452bc085cc3c48658ab384:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"User Guide","count":20},{"language":"default","tag":"Platform","count":6},{"language":"default","tag":"Configuration","count":5},{"language":"default","tag":"Plans \u0026 Billing","count":3},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Integrations","count":3},{"language":"default","tag":"Help \u0026 Support","count":2}],"searchSettings":{"maxResults":10}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":false,"email":"support@merchantai.io","showHelpButton":false}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--default-border-color:var(--gray-200)}.dark{--default-border-color:var(--gray-800)}#sidebar .nav-dropdown-trigger{border:0!important;background:0 0!important;box-shadow:none!important;padding-left:.375rem}#sidebar .nav-dropdown-trigger:hover{background-color:rgb(0 0 0/.04)!important}.dark #sidebar .nav-dropdown-trigger:hover{background-color:rgb(255 255 255/.06)!important}#sidebar .nav-dropdown-trigger .nav-dropdown-item-icon,.nav-dropdown-content .nav-dropdown-item-icon{border:0!important;background:0 0!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content .nav-dropdown-item-description{display:none!important}#sidebar .nav-anchor span{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px;font-weight:500;letter-spacing:-.02em;text-transform:uppercase}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/']{color:rgb(var(--primary))!important;font-weight:600!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/'] span{color:inherit!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/'] svg{background-color:rgb(var(--primary))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/']{color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/'] svg{background-color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}:is(#content-area[data-current-path='/'], [data-current-path='/'] #content-area):has([data-product-guide-index]){background:0 0!important;padding:0!important}:is(#content-area[data-current-path='/'], [data-current-path='/'] #content-area):has([data-product-guide-index])>div:first-child{background:0 0!important;padding-right:0!important;padding-bottom:0!important;padding-left:0!important}[data-product-guide-index] a:not(.product-guide-feature-card){background-color:#fafafa!important}.dark [data-product-guide-index] a:not(.product-guide-feature-card){background-color:#09090b!important}.product-guide-feature-card,.product-guide-feature-card>div{display:flex!important;flex-direction:column!important;justify-content:space-between!important}.product-guide-feature-card{grid-column:1/-1;min-height:260px;background:url(/images/sample-feature-light.png) center/cover no-repeat!important;border:0!important;box-shadow:none!important;color:#fff!important}.product-guide-feature-card>div{flex:1}.product-guide-feature-card :is(h2, h3, p, span, svg){color:#fff!important}.product-guide-feature-card :is(svg, [class*='icon']){background-color:#fff!important;width:2em!important;height:2em!important;margin-top:2px}.product-guide-feature-card-title{font-size:1.2em;font-weight:500}.product-guide-feature-card :is(h2, h3, p, span, svg).product-guide-feature-card-description{font-size:1.05em;font-weight:400;color:rgb(var(--gray-50)/62.5%)!important}img.nav-logo{max-width:220px;height:auto}"}],"page":{"pagePath":"platform/workflows","slug":"/platform/workflows","pageMetadata":{"title":"Shopify-Aware Workflows and Automated Agent Actions","sidebarTitle":"Workflows","description":"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.","icon":"git-branch","href":"/platform/workflows"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`MerchantAI goes beyond answering questions — when connected to your Shopify store, it can take meaningful steps in the shopping journey on a visitor’s behalf. Workflows are the actions your agent can perform, from helping a shopper find the right product to surfacing their order status. Each workflow is designed so that your team stays in control of anything sensitive, while your agent handles the high-volume, low-risk interactions automatically.`}),`\n`,_jsx(Heading,{level:`2`,id:`supported-workflows`,children:`Supported workflows`}),`\n`,_jsxs(CardGroup,{cols:1,children:[_jsx(Card,{title:`Product discovery`,icon:`magnifying-glass`,children:_jsx(_components.p,{children:`When a shopper describes what they are looking for, the agent searches your indexed Shopify catalogue and surfaces relevant products, variants, and collections. It activates whenever a visitor asks about a product category, a specific use case, or product attributes such as size, colour, or material.`})}),_jsx(Card,{title:`Cart review and checkout links`,icon:`cart-shopping`,children:_jsx(_components.p,{children:`The agent can review the contents of a shopper’s current cart and present a direct link to the Shopify checkout. This workflow activates when a shopper asks about their cart, requests help completing a purchase, or needs confirmation of what they are about to buy. The actual checkout process — payment, address entry, and fulfilment — happens entirely within Shopify.`})}),_jsx(Card,{title:`Order lookup`,icon:`box`,children:_jsx(_components.p,{children:`When order lookup is enabled for your workspace, the agent can retrieve the current status and tracking information for an order when a shopper provides their order number and email address. It activates when a visitor asks where their order is or requests a delivery update.`})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Refunds, order cancellations, returns, discount applications, and sensitive account changes are `,_jsx(_components.strong,{children:`never handled by the agent`}),`. These actions always trigger a handover to your human team. Do not configure the agent to attempt these actions, and make sure your system prompt does not suggest otherwise.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`enabling-order-lookup`,children:`Enabling order lookup`}),`\n`,_jsxs(_components.p,{children:[`Order lookup is not active by default. You must explicitly enable it for your workspace in `,_jsx(_components.strong,{children:`Configuration → Workflows → Order Lookup`}),`. Once enabled, the agent can surface order status and tracking details when a shopper supplies a matching order number and email address. Order lookup exposes only order status and shipping information — it does not surface payment details, billing addresses, or any financial data.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cart-and-checkout`,children:`Cart and checkout`}),`\n`,_jsx(_components.p,{children:`The cart review workflow provides the shopper with a summary of their current cart and a link that takes them directly to the Shopify checkout page. MerchantAI does not process payments, modify cart contents programmatically, or interact with Shopify’s checkout flow beyond generating the link. Your store’s existing checkout, payment gateway, and fulfilment logic remain fully intact.`}),`\n`,_jsx(Heading,{level:`2`,id:`human-approval`,children:`Human approval`}),`\n`,_jsxs(_components.p,{children:[`Any workflow action that MerchantAI identifies as sensitive — such as a request to change an order, process a refund, or apply a discount — automatically triggers a handover to your human team. The agent does not attempt the action; instead it surfaces the handover card for the visitor and passes the full conversation context to your team. You can configure additional triggers for human approval in `,_jsx(_components.strong,{children:`Configuration → Guardrails → Escalation Rules`}),`.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Before going live, use the `,_jsx(_components.strong,{children:`Preview`}),` mode in the dashboard to test each workflow with realistic shopper queries. Run through product searches, cart review, and order lookup with test data so you can confirm the agent behaves as expected before real visitors interact with it.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Shopify-Aware Workflows and Automated Agent Actions","sidebarTitle":"Workflows","description":"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.","icon":"git-branch","href":"/platform/workflows"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Supported workflows","slug":"supported-workflows","depth":2,"children":[]},{"title":"Enabling order lookup","slug":"enabling-order-lookup","depth":2,"children":[]},{"title":"Cart and checkout","slug":"cart-and-checkout","depth":2,"children":[]},{"title":"Human approval","slug":"human-approval","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"merchantai","siteName":"Merchant AI","title":"Shopify-Aware Workflows and Automated Agent Actions - Merchant AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-17T15:17:24.449Z","originalFileLocation":"platform/workflows.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Merchant AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Shopify-Aware Workflows and Automated Agent Actions - Merchant AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Merchant AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.merchantai.io/platform/workflows\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://merchantai.mintlify.app/_mintlify/api/og/v2?division=Platform\u0026amp;title=Shopify-Aware+Workflows+and+Automated+Agent+Actions\u0026amp;description=Let+your+agent+handle+product+discovery%2C+cart+review%2C+checkout+links%2C+and+order+lookup+while+keeping+sensitive+actions+firmly+in+human+hands.\u0026amp;theme=5ea11eed8ae52a9168b53142\u0026amp;signature=b611f936e609e7fe96c5c88012f17380ea5e732d7c15ee61001965d895a7c43a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Shopify-Aware Workflows and Automated Agent Actions - Merchant AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://merchantai.mintlify.app/_mintlify/api/og/v2?division=Platform\u0026amp;title=Shopify-Aware+Workflows+and+Automated+Agent+Actions\u0026amp;description=Let+your+agent+handle+product+discovery%2C+cart+review%2C+checkout+links%2C+and+order+lookup+while+keeping+sensitive+actions+firmly+in+human+hands.\u0026amp;theme=5ea11eed8ae52a9168b53142\u0026amp;signature=b611f936e609e7fe96c5c88012f17380ea5e732d7c15ee61001965d895a7c43a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/merchantai/UdQmdJG39BpVkvsA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Merchant AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2d9e9d\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.merchantai.io/platform/workflows\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/platform/workflows.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.merchantai.io/#organization\",\"name\":\"Merchant AI\",\"url\":\"https://docs.merchantai.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/merchantai/L-exzcSnLhLx0vgj/images/Logo.png?fit=max\u0026auto=format\u0026n=L-exzcSnLhLx0vgj\u0026q=85\u0026s=a1bdb6c5b289c99bb6740f077b8a3178\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.merchantai.io#website\",\"name\":\"Merchant AI\",\"url\":\"https://docs.merchantai.io\",\"publisher\":{\"@id\":\"https://docs.merchantai.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.merchantai.io/platform/workflows#webpage\",\"url\":\"https://docs.merchantai.io/platform/workflows\",\"name\":\"Shopify-Aware Workflows and Automated Agent Actions\",\"description\":\"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.\",\"dateModified\":\"2026-06-17T15:17:24.449Z\",\"isPartOf\":{\"@id\":\"https://docs.merchantai.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.merchantai.io/platform/workflows#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.merchantai.io/platform/workflows#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Platform\",\"item\":\"https://docs.merchantai.io/platform/knowledge\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Shopify-Aware Workflows and Automated Agent Actions\",\"item\":\"https://docs.merchantai.io/platform/workflows\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.merchantai.io/platform/workflows#article\",\"headline\":\"Shopify-Aware Workflows and Automated Agent Actions\",\"name\":\"Shopify-Aware Workflows and Automated Agent Actions\",\"description\":\"Let your agent handle product discovery, cart review, checkout links, and order lookup while keeping sensitive actions firmly in human hands.\",\"url\":\"https://docs.merchantai.io/platform/workflows\",\"mainEntityOfPage\":{\"@id\":\"https://docs.merchantai.io/platform/workflows#webpage\"},\"dateModified\":\"2026-06-17T15:17:24.449Z\",\"publisher\":{\"@id\":\"https://docs.merchantai.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.merchantai.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Merchant AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Merchant AI","nav":{"global":null,"directory":"card","tabs":[{"tab":"User Guide","groups":[{"group":"Get Started","icon":"rocket","expanded":true,"pages":[{"title":"MerchantAI: AI Support Associate for Business Sites","sidebarTitle":"Introduction","icon":"sparkles","href":"/introduction"},{"title":"Set Up MerchantAI: Go Live with Your AI Agent in Minutes","sidebarTitle":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"How MerchantAI Works: Six Systems Behind Every Answer","sidebarTitle":"How It Works","icon":"workflow","href":"/how-it-works"}]},{"group":"Configuration","icon":"settings","pages":[{"title":"Setting Up Your MerchantAI Agent: A Complete Guide","sidebarTitle":"Agent Setup","icon":"bot","href":"/configuration/agent-setup"},{"title":"Configuring Brand Voice, Tone, and Widget Appearance","sidebarTitle":"Brand Voice","icon":"megaphone","href":"/configuration/brand-voice"},{"title":"Configure Handover, Contacts Inbox, and Live Takeover","sidebarTitle":"Handover","icon":"user-round-cog","href":"/configuration/handover"},{"title":"Troubleshooting common MerchantAI setup and widget issues","sidebarTitle":"Troubleshooting","icon":"life-buoy","href":"/help/troubleshooting"},{"title":"Privacy Controls and GDPR Compliance for Your Agent","sidebarTitle":"Privacy Controls","icon":"shield-check","href":"/configuration/privacy-controls"}]},{"group":"Platform","icon":"layers","pages":[{"title":"Training Your MerchantAI Agent with a Knowledge Base","sidebarTitle":"Knowledge","description":"Build a knowledge base from your website, uploaded files, Q\u0026A pairs, and Shopify catalogue so your agent always answers from approved sources.","icon":"book-open","href":"/platform/knowledge"},{"title":"Shopify-Aware Workflows and Automated Agent Actions","sidebarTitle":"Workflows","icon":"git-branch","href":"/platform/workflows"},{"title":"Configure Your Agent's Brand Voice and System Prompt","sidebarTitle":"Voice","description":"Shape your agent's tone, persona, and escalation behaviour with an editable system prompt, brand voice presets, and per-topic routing rules.","icon":"mic","href":"/platform/voice"},{"title":"Setting Up Human Handover and Conversation Routing","sidebarTitle":"Routing","icon":"route","href":"/platform/routing"},{"title":"Keep Your Agent Accurate and On-Brand with Guardrails","sidebarTitle":"Guardrails","icon":"shield","href":"/platform/guardrails"},{"title":"Using Analytics to Understand and Improve Your Agent","sidebarTitle":"Analytics","icon":"chart-line","href":"/platform/analytics"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"Connect MerchantAI to Your Shopify Store in Minutes","sidebarTitle":"Shopify","icon":"shopping-bag","href":"/integrations/shopify"},{"title":"Add the MerchantAI Widget to Any Website or Platform","sidebarTitle":"JS Widget","icon":"code","href":"/integrations/js-widget"},{"title":"MerchantAI Webhooks and API Access — Exchange Plan","sidebarTitle":"Webhooks \u0026 API","icon":"webhook","href":"/integrations/webhooks"}]},{"group":"Plans \u0026 Billing","icon":"credit-card","pages":[{"title":"MerchantAI pricing: plans, limits, and feature comparison","sidebarTitle":"Plans","icon":"tag","href":"/billing/plans"},{"title":"MerchantAI Enterprise: custom limits, SSO, and security","sidebarTitle":"Enterprise","icon":"building-2","href":"/billing/enterprise"},{"title":"Earn recurring commission: MerchantAI partner programme","sidebarTitle":"Partners","icon":"handshake","href":"/billing/partners"}]}]},{"tab":"Help \u0026 Support","pages":[{"title":"Help \u0026 Support","href":"/help/faq"}]}]},"title":"Shopify-Aware Workflows and Automated Agent Actions - Merchant AI","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":[],"chunks":[]}