# Build a WooCommerce Order Status AI Agent on WhatsApp

One of the most common ecommerce support questions is:

> Where is my order?

A general AI Agent can explain your shipping policy, but it shouldn't guess the status of a specific order.

For that, the agent needs access to your live WooCommerce order data.

[ZazzyAgent](http://zazzyagent.com) supports a WooCommerce order lookup action that can be used by an AI Agent when configured correctly.

## What this agent should do

The agent should:

1.  Understand that the customer wants order information.
    
2.  Ask for the order number when necessary.
    
3.  Look up the order.
    
4.  Explain the returned information.
    
5.  Avoid guessing.
    
6.  Transfer unusual or complex problems to a human.
    

## What you need

Prepare:

*   Connected WhatsApp account
    
*   Connected WooCommerce store
    
*   AI Agent
    
*   Support knowledge
    
*   WooCommerce order lookup action
    

## Step 1: Create the AI Agent

Give it a focused name:

> Order Support Agent

Its responsibility could be:

> Help customers check their existing WooCommerce orders and understand their current order status.

## Step 2: Add support knowledge

Your knowledge might explain:

*   Shipping policy
    
*   Delivery expectations
    
*   Returns
    
*   Refund policy
    
*   Cancellation policy
    
*   Support process
    

This is general information.

It should not contain live order statuses.

## Step 3: Select the WooCommerce store

Configure the connected store using:

```text
##woocommerce_store## : 12
```

Use the System Prompt autocomplete to select the actual connected store.

Don't manually guess the numeric ID.

## Step 4: Add the order lookup action

Use:

```text
##woocommerce_get_order_details##
```

This action can be used when a customer asks about an existing WooCommerce order.

## Step 5: Write the System Prompt

A practical starting point:

```text
You are the Order Support Agent for our ecommerce store.

Your job is to help customers check their existing orders.

COMMUNICATION

Be friendly and concise.

Ask for the order number when it is required and the customer has not provided it.

ORDER INFORMATION

When the customer asks about an existing order, use the WooCommerce order lookup action.

##woocommerce_get_order_details##

Use the information returned by WooCommerce.

Never guess an order status.

Never invent a delivery date.

Never claim that an order was shipped unless the store information confirms it.

If the order cannot be found or the information cannot be retrieved,
tell the customer and offer appropriate support.

HUMAN SUPPORT

Transfer the conversation to a human when the issue requires manual investigation,
the customer has a complaint that cannot be resolved automatically,
or the customer explicitly asks for a human.
```

## Step 6: Test the agent

Try:

> Where is my order?

The agent should ask for the order number.

Then provide a real test order number.

The agent should perform the WooCommerce lookup.

## Test a different question

Customer:

> How long does shipping usually take?

This is a policy question.

The agent can use the connected knowledge.

It doesn't need a live order lookup.

## Test a missing order number

Customer:

> Please check my order.

The agent should ask:

> Sure. What's your order number?

It should not guess which order the customer means.

## Test a failed lookup

If the order cannot be found:

The agent should explain that it couldn't retrieve the order and provide the next appropriate step.

It should not invent an order or status.

## Test a delayed order

Customer:

> My order is late.

The agent can retrieve the actual order information.

Then it can explain what the store data shows.

If further investigation is needed, transfer to human support.

## Add human assignment

You can use a human-assignment action when appropriate.

For example:

```text
If the customer needs manual investigation,
assign the conversation to the support team.

##assign_human_role## : 3
```

Choose the appropriate team role from the autocomplete.

## Add order cancellation later

Once your basic order lookup is reliable, you can add the supported cancellation action:

```text
##woocommerce_cancel_order##
```

Don't enable cancellation simply because you can.

The System Prompt should define:

*   When cancellation is allowed
    
*   What information is required
    
*   What situations require human approval
    
*   What the agent should say if cancellation fails
    

## Add product recommendations later

A support agent can be expanded with:

```text
##woocommerce_recommend_products##
```

But don't overload an order-support agent with sales responsibilities unless that fits your business process.

A separate Sales Agent may be cleaner.

## Why live order data matters

Consider two customers.

Customer A:

> What is your standard delivery time?

Your knowledge source can answer.

Customer B:

> Where is order #12345?

The answer changes based on current store data.

The first question uses **knowledge**.

The second needs a **live action**.

## Recommended architecture

```text
Customer
   ↓
Order Support AI
   ↓
Order number available?
   ↓
No → Ask customer
   ↓
Yes
   ↓
WooCommerce Order Lookup
   ↓
Live order information
   ↓
AI explains result
   ↓
Resolved?
   ↓
Yes → Finish
No → Human Support
```

## The most important rule

Don't let an AI Agent guess live ecommerce information.

For order status, shipping progress, cancellation results and similar changing information:

**Get the actual data first. Then answer the customer.**

That's what turns a generic chatbot into a useful ecommerce support agent.