New to n8n? Start with our step-by-step setup guide, then come back to build this workflow.
Managing a Shopify store means checking the dashboard, hunting for order IDs, editing products one by one, and emailing customers manually. Every one of those tasks takes you away from actually growing the business. This n8n Shopify AI agent changes that completely. First, you send a voice note or text message on WhatsApp. Next, the AI understands your command, queries your live store, and takes action: updating orders, managing products, sending customer emails, and logging everything to Google Sheets. As a result, your entire store becomes controllable from your phone, hands-free, in English, Arabic, or French.
Prefer to skip the build? Grab the ready-made template → and be managing your Shopify store by voice in under 20 minutes.
What You’ll Build
- You send a WhatsApp text or voice note to your business number. “How many orders came in today?” or “Update the price of the blue hoodie to $49.”
- If it’s a voice note, ElevenLabs transcribes the audio to text automatically before passing it to the AI.
- The AI agent reads your command, calls the right Shopify tool (get orders, update a product, create a listing, delete a variant) and executes it against your live store.
- Order data is written to a Google Sheet for tracking, and customer emails are sent via Gmail when you ask.
- The AI replies back to WhatsApp: text if you typed, a voice note in the same Charlie voice if you spoke.
- Every conversation is remembered per WhatsApp contact, so context carries forward across messages.
How This n8n Shopify AI Agent Works: The Big Picture
The workflow has two entry paths that merge at the AI agent, and two exit paths that split again based on whether the original message was text or audio. In between, the AI has six Shopify tools it can call autonomously, plus Google Sheets and Gmail. Here is the full picture:
┌──────────────────────────────────────────────────────────────────────────────┐ │ N8N SHOPIFY AI AGENT — WHATSAPP VOICE STORE MANAGER │ │ │ │ [WhatsApp Trigger] │ │ │ │ │ ▼ │ │ [Switch: text or audio?] │ │ │ text │ audio │ │ ▼ ▼ │ │ (straight to [Get Media URL] │ │ AI Agent) [Download Audio Binary] │ │ [ElevenLabs: Speech-to-Text] │ │ │ │ │ ──────────┘ │ │ ▼ │ │ [AI Agent — Store Manager] │ │ │ Tools available: │ │ ├─ [Shopify: Get Orders] │ │ ├─ [Shopify: Get Products] │ │ ├─ [Shopify: Update Order] │ │ ├─ [Shopify: Create Product] │ │ ├─ [Shopify: Update Product] │ │ ├─ [Shopify: Delete Product] │ │ ├─ [Google Sheets: database (append/update)] │ │ └─ [Gmail: Send Email] │ │ │ Memory: Simple Memory (per WhatsApp contact) │ │ │ Model: OpenRouter Chat Model │ │ │ │ │ ▼ │ │ [Switch1: was original text or audio?] │ │ │ text │ audio │ │ ▼ ▼ │ │ [WhatsApp: Send text] [ElevenLabs: Text-to-Speech] │ │ [Code: Set MIME → audio/mpeg] │ │ [WhatsApp: Send voice note] │ └──────────────────────────────────────────────────────────────────────────────┘
What You’ll Need
- n8n: self-hosted or n8n Cloud (v1.30+). See the n8n hosting documentation for setup options.
- WhatsApp Business API: a verified Meta business phone number with a permanent access token. See the WhatsApp Cloud API getting-started guide.
- Shopify store: with a private app or OAuth app that has read/write access to Orders and Products.
- ElevenLabs account: free tier works for testing; choose any voice from your library.
- OpenRouter account: to power the AI agent; Claude, GPT-4o, or Llama 3 all work.
- Google Sheets: one spreadsheet with an “orders” tab containing the 14-column schema shown below.
- Gmail account: connected via OAuth2 in n8n for sending customer emails.
Estimated build time: 60 to 90 minutes from scratch, or under 20 minutes with the ready-made template.
Part 1: Receiving the WhatsApp Message
1 WhatsApp Trigger
This node opens a webhook endpoint that Meta’s WhatsApp Cloud API calls every time a message arrives on your business number. It listens for the messages event type, which covers both text messages and media (audio, images, documents). Every incoming message delivers a payload with two fields the rest of the workflow relies on: messages[0].type (either text or audio) and contacts[0].wa_id (the sender’s phone number, used as the session key for memory).
// Incoming WhatsApp payload — text message example
{
"messages": [
{
"type": "text",
"text": { "body": "How many orders are pending today?" }
}
],
"contacts": [
{ "wa_id": "15551234567", "profile": { "name": "Sarah Thompson" } }
]
}Note: Your WhatsApp webhook must be registered in the Meta Developer Console pointing to your n8n webhook URL. The verification token is set in the WhatsApp Trigger node credentials. Make sure your n8n instance is publicly reachable, it cannot run on localhost.
2 Switch: Text or Audio?
First, the Switch node reads $json.messages[0].type. If it equals text, the message goes directly to the AI Agent. If it equals audio, the message takes a detour through three nodes to transcribe the voice note before the AI sees it. This routing is what makes the workflow truly voice-native: the AI always receives clean text, regardless of how the user communicated.
// Switch routing logic
{
"route_text": "messages[0].type === 'text'",
"route_audio": "messages[0].type === 'audio'"
}Part 2: Transcribing Voice Messages
3 Download Media (WhatsApp)
When the message is audio, this node calls the WhatsApp media endpoint to get the audio file’s download URL. It passes $json.messages[0].audio.id, the media ID from the trigger payload, and receives back a temporary URL that expires after a few minutes.
4 Download Audio (HTTP Request)
Next, this HTTP Request node fetches the actual audio binary from the URL returned by the previous step. It uses the WhatsApp API credentials for authentication, since Meta’s media URLs require a valid access token in the request headers. The output is a binary file that ElevenLabs can process.
5 Transcribe Audio (ElevenLabs)
ElevenLabs Speech-to-Text converts the audio binary into plain text with high accuracy, including for Arabic and French, matching the multilingual capability of the AI agent. The transcribed text arrives as $json.text, which the AI Agent reads via its Audio input: {{ $json.text }} prompt field.
Tip: ElevenLabs handles background noise, accents, and mixed-language voice notes well. For store managers recording quick commands while walking around a warehouse, this reliability is critical. If you want to reduce API costs, you can swap ElevenLabs for OpenAI’s Whisper node, which is cheaper for high-volume transcription.
Part 3: The AI Store Manager Agent
6 AI Agent, Store Manager
This is the brain of the entire workflow. The AI Agent node receives either the text body or the transcribed audio, then decides which tools to call and in what order to fulfill the command. Its system prompt defines its role as a Shopify store manager, its available tools, its language capabilities, and one important rule: always call Get orders before updating an order, to retrieve the order ID first.
The agent prompt sets the behavior clearly. For example, the current system prompt instructs:
role: You are a smart AI voice Store Manager for my Shopify Store.
tasks:
- Always use 'Get orders' to get order/sales details
- Before you update orders, always get the order ID first from 'Get orders'
tools: shopify tool, Google Sheets 'database', Gmail
languages: English, Arabic (Modern Standard Arabic), FrenchTip: The system prompt mentions “Pet_shop” as the Gmail sender name, update this to your actual store name in both the AI Agent system prompt and the Gmail Tool node’s senderName field before going live.
7 OpenRouter Chat Model
The AI Agent is powered by OpenRouter, which gives you access to 100+ language models through a single API key. The default model is not hardcoded, you choose it in the OpenRouter Chat Model node’s dropdown. For store management commands (structured data retrieval, product updates), Claude 3.5 Sonnet or GPT-4o Mini deliver excellent results at low cost. Switch models any time without touching the rest of the workflow.
8 Simple Memory
The memory node gives the agent a 20-message conversation window, keyed to each contact’s WhatsApp phone number (wa_id). This means when a user follows up with “Actually, add a note to that order saying urgent delivery,” the agent remembers which order they were discussing without being told again. Each WhatsApp contact gets a fully isolated conversation context. 50 customers messaging simultaneously creates 50 separate memory streams.
Part 4: Shopify Tools the Agent Can Use
The AI agent has six Shopify tools available. It calls them autonomously, you never have to specify which tool to use in your WhatsApp message. Just describe what you want in plain language, and the agent decides.
| Tool | What it does | Example command that triggers it |
|---|---|---|
| Get Orders | Fetches all orders from Shopify. The agent controls returnAll and limit via $fromAI() based on your request. |
“Show me today’s orders” / “How many pending orders do we have?” |
| Get Products | Fetches all products from the catalog. Returns titles, prices, variants, and inventory levels. | “List all products under $30” / “Do we still have the red sneakers in stock?” |
| Update an Order | Updates an order by ID. First calls Get Orders to find the correct ID, then applies changes like notes or tags. | “Add a note to order #1023 saying the customer requested gift wrapping.” |
| Create a Product | Creates a new product with a title and optional additional fields (description, price, images). | “Create a new product called Summer Linen Tote Bag at $24.99.” |
| Update a Product | Updates a product’s title and HTML body description by product ID. First calls Get Products to find the ID. | “Update the Blue Hoodie description to add washing instructions.” |
| Delete a Product | Permanently deletes a product from Shopify by product ID. | “Remove the discontinued Winter Scarf from the catalog.” |
Important: The Delete a product tool is permanent. There is no confirmation step. If the AI identifies the product and you asked it to delete, it will. Add a safety confirmation step (an IF node or a WhatsApp confirmation reply) if you want to prevent accidental deletions in production.
Part 5: Database and Email Tools
9 Google Sheets: Database Tool
Every time the agent retrieves or acts on an order, it can write the data to your Google Sheet using the appendOrUpdate operation. The Order ID column is the matching key, so re-running a command on the same order updates the existing row rather than duplicating it. All 14 fields are populated via $fromAI() expressions, meaning the agent extracts each value from the Shopify response and maps it automatically.
10 Gmail: Send Email Tool
When you ask the agent to email a customer, it calls this tool, filling the To, Subject, and Message fields via $fromAI(). The sender name is set to your store name. For example, you can say: “Email james.carter@gmail.com and tell him his order shipped today” and the agent writes and sends the email entirely on its own.
Part 6: Sending the Reply
11 Switch1: Reply in Text or Voice?
After the AI agent finishes, a second Switch node checks the original message type again. If you sent text, you get a text reply. If you sent a voice note, the agent converts its response to speech and sends a voice note back. The reply always matches the input format: a voice conversation stays a voice conversation.
12 Convert Text to Speech (ElevenLabs)
For audio replies, this node sends the AI agent’s text output to ElevenLabs using the “Charlie: Deep, Confident, Energetic” voice. The settings are configured for natural, professional delivery: stability at 1.0, similarity boost at 1.0, and speed at 0.82 (slightly slower than default, which works better for information-dense store management replies). The output format is MP3 at 22050 Hz.
13 Convert to MPEG (Code Node)
WhatsApp’s API is strict about audio MIME types. This Code node sets mimeType to audio/mpeg and renames the file to voice.mp3, without this step, WhatsApp rejects the audio upload and the voice reply fails silently.
for (const item of $input.all()) {
if (item.binary && item.binary.data) {
item.binary.data.mimeType = 'audio/mpeg'
item.binary.data.fileName = 'voice.mp3'
}
}
return $input.all();14 Send Message / Send Message1 (WhatsApp)
Two WhatsApp send nodes handle the two reply paths. Send message1 (text path) sends the AI output as a plain text body. Send message (audio path) sends the MPEG binary as an audio message. Both always reply to the original sender using $('WhatsApp Trigger').item.json.contacts[0].wa_id.
The Data Structure: Google Sheets Order Database
Create a Google Sheet with one tab named orders. The column names below are case-sensitive, and the agent uses them as keys when writing rows via $fromAI().
| Column Name | Type | Example Value | Description |
|---|---|---|---|
Order ID | Text | 5678901234 | Shopify order ID, used as the matching key to prevent duplicate rows |
Order Name | Text | #1023 | Human-readable order name shown in the Shopify dashboard |
Order Date | Text | March 18, 2026 | Date the order was placed |
Customer Name | Text | James Carter | Full name from the Shopify order |
Customer Email | Text | james.carter@gmail.com | Used when sending confirmation emails via Gmail |
Customer Phone | Text | (555) 867-5309 | Contact number from the order |
Product Title | Text | Blue Hoodie, Size M | Product name and variant from the order line item |
Quantity | Text | 2 | Number of units ordered |
Product Price | Text | $49.00 | Unit price at time of order |
Total Order Amount | Text | $98.00 | Full order total including all line items |
Currency | Text | USD | Currency code from the Shopify order |
Payment Status | Text | paid | Shopify financial status: paid, pending, refunded |
Source | Text | online_store | Order source channel from Shopify |
Agent Note | Text | Customer requested express shipping | AI-generated note about the order based on conversation context |
Setup step: Create the sheet with these exact headers before activating the workflow. The Order ID column is the matching key. A second write with the same ID updates the existing row instead of creating a duplicate. Name the tab exactly orders (lowercase) to match the workflow configuration.
Full System Flow: n8n Shopify AI Agent End to End
You send a WhatsApp message: "Update the Blue Hoodie price to $44"
│
▼
[WhatsApp Trigger] → { messages[0].type: "text", text.body: "Update the Blue Hoodie price to $44" }
│
▼
[Switch: type = "text"] → routes to AI Agent directly
│
▼
[AI Agent — Store Manager]
→ calls [Get Products] → finds Blue Hoodie, product_id: 7890123456
→ calls [Update a Product] → sets title + new price on Shopify
→ calls [Google Sheets database] → logs order/product change
→ generates reply: "Done! Blue Hoodie updated to $44.00 in your store."
│
▼
[Switch1: original type = "text"]
│
▼
[WhatsApp: Send text reply] → "Done! Blue Hoodie updated to $44.00 in your store."
────────────────────────────────────────────────────────────
You send a WhatsApp voice note: "Send an email to James about his order"
│
▼
[WhatsApp Trigger] → { messages[0].type: "audio", audio.id: "media_id_xyz" }
│
▼
[Switch: type = "audio"] → routes to audio transcription path
│
[Download Media URL] → { url: "https://lookaside.fbsbx.com/..." }
[Download Audio Binary] → binary MP3 file
[ElevenLabs: Speech-to-Text] → { text: "Send an email to James about his order" }
│
▼
[AI Agent — Store Manager]
→ calls [Get Orders] → finds James Carter, order #1023, james.carter@gmail.com
→ calls [Gmail: Send Email] → sends order update email to james.carter@gmail.com
→ generates reply: "Email sent to James Carter at james.carter@gmail.com for order #1023."
│
▼
[Switch1: original type = "audio"]
│
[ElevenLabs: Text-to-Speech] → MP3 audio of reply in Charlie voice
[Code: Set mimeType = audio/mpeg]
[WhatsApp: Send voice note] → 🔊 Voice reply delivered to sender
Testing Your n8n Shopify AI Agent
- In n8n, activate the workflow and copy the WhatsApp webhook URL. Register it in the Meta Developer Console under your app’s webhook settings.
- Send a text message to your WhatsApp business number: “List all products.” Confirm the AI responds with your actual Shopify catalog.
- Send a voice note saying: “How many orders do we have this week?” Confirm the audio is transcribed, the AI calls Get Orders, and you receive a voice reply with the count.
- Send: “Create a test product called Test Widget at $9.99.” Check your Shopify Products dashboard to confirm it appeared.
- Send: “Delete the Test Widget product.” Confirm it’s removed from Shopify. Then send the same command again, the AI should respond that the product no longer exists, demonstrating it uses Get Products before acting.
- Send: “Email emily.rodriguez@outlook.com and tell her order #1001 has shipped.” Check your Gmail Sent folder to confirm the email was sent with the correct content.
- Open your Google Sheet and confirm order rows are being written or updated correctly.
| Problem | Likely Cause | Fix |
|---|---|---|
| Webhook not receiving messages | n8n URL not registered in Meta Developer Console, or instance not publicly accessible | Verify the webhook URL and token in Meta Developer Console → WhatsApp → Configuration. Use ngrok for local testing. |
| Voice reply fails, audio not delivered | Missing MIME type fix or wrong phone number ID | Confirm the “Convert to mpeg” Code node runs before the send node. Replace YOUR_WHATSAPP_PHONE_NUMBER_ID with your actual Phone Number ID from the Meta console. |
| AI says “I can’t find that product” but it exists | Agent is not calling Get Products before Update Product | Add an explicit instruction to the system prompt: “Always call Get Products before updating or deleting any product.” |
| Google Sheet not updating | Column names don’t match exactly (case-sensitive) | Compare sheet headers character-by-character against the schema table above. Make sure the tab is named orders. |
| Gmail not sending | OAuth2 token expired or incorrect sender name | Reconnect the Gmail OAuth2 credential in n8n. Update senderName in the Gmail Tool node from “Pet_shop” to your store name. |
| AI responds in the wrong language | Language detection relies on user input. Mixed messages can confuse it | Update the system prompt to specify a default language: “If the language is unclear, respond in English.” |
Frequently Asked Questions
Does this n8n Shopify AI agent work with Shopify Basic, Grow, or Advanced plans?
Yes. The workflow uses the Shopify REST API via n8n’s native Shopify nodes, which are available on all paid Shopify plans. You need to create a custom app in your Shopify admin under Settings → Apps → Develop apps and grant it read/write access to Orders and Products. The API credentials generated there connect directly to the Shopify nodes in the workflow.
Can multiple team members use the same WhatsApp number to control the store?
Yes. The Simple Memory node isolates each conversation by WhatsApp phone number, so two managers messaging the same business number get completely separate conversation contexts. There is no cross-contamination. One manager asking about orders does not affect the other’s session. For team use, consider adding an authorization check at the start of the workflow to restrict commands to known wa_id numbers.
Which AI model should I use with OpenRouter for best results?
For store management tasks like structured queries, product lookups, order updates, Claude 3.5 Sonnet or GPT-4o Mini both perform excellently. Claude handles Arabic and French more naturally, making it the better choice if your team works in multiple languages. For pure speed and lowest cost, GPT-4o Mini is the most efficient. Avoid smaller models (7B parameters or less) as they tend to mis-call tools on complex multi-step commands.
Can I add more Shopify actions beyond what’s included?
Absolutely. n8n’s Shopify Tool node supports many additional operations: creating customers, managing fulfillments, updating inventory levels, and more. To add a new capability, duplicate one of the existing Shopify Tool nodes, change the operation, connect it to the AI Agent’s tools input, and add a brief description of what the tool does in the node’s description field, and the AI will use it automatically when appropriate.
What happens if the AI tries to delete the wrong product?
By design, the agent calls Get Products first to look up the product ID before deleting. However, there is no confirmation step in the base workflow. For production use, it is strongly recommended to add a safety layer: before the Delete node fires, send a WhatsApp message asking “Are you sure you want to delete [product name]? Reply YES to confirm.” Then use a Wait node and a conditional check on the reply before proceeding.
Can I connect this to a customer-facing WhatsApp number instead of an internal one?
The workflow as built is designed for internal store manager use. Connecting it to a customer-facing number would require a completely different system prompt and much stricter guardrails. The current prompt gives full write access to products and orders, which customers must never have. For a customer-facing chatbot, see our separate AI WooCommerce Chatbot guide which is designed specifically for that use case.
🚀 Get the n8n Shopify AI Agent Template
Download the ready-to-import workflow JSON, the Google Sheets order database template with all 14 columns pre-configured, and a step-by-step credential setup guide, so you can manage your Shopify store by WhatsApp voice in under 20 minutes.
Get the Template →Instant download · Works on n8n Cloud and self-hosted
What’s Next?
- Add a daily sales report: wire a Schedule Trigger that fires every morning and sends you a voice note summarizing the previous day’s orders, revenue, and top-selling products.
- Add inventory alerts: extend the Get Products tool call to check stock levels and automatically send a WhatsApp alert when any product drops below a minimum quantity you define.
- Connect Telegram as a second channel: duplicate the WhatsApp input/output nodes and replace them with Telegram nodes so the same AI agent is accessible from both apps with shared memory.
- Add a safety confirmation step: before any destructive action (delete product, cancel order), add a WhatsApp reply asking for confirmation, then a Wait node and an IF check on the response.
- Browse all our automation guides on the EasyWorkflows n8n blog →
