How to Add WooCommerce Order Notes With a ZazzyAgent AI Agent
Your support team often needs to leave information directly on an ecommerce order.
For example:
Customer contacted us on WhatsApp and requested a callback.
Instead of requiring an agent to manually open WooCommerce and add the note, a ZazzyAgent AI Agent can do it as part of the conversation.
What can WooCommerce order notes be used for?
Order notes can help your team record information such as:
Customer requests
Support context
Special instructions
WhatsApp-related interactions
Follow-up information
Internal processing notes
The note is added to the WooCommerce order rather than being sent as a WhatsApp message.
What you need
Before using this action, you need:
A connected WooCommerce store
An AI Agent
A customer conversation
A clear reason for adding an order note
Select the WooCommerce store first
WooCommerce actions require the connected store to be selected first.
Use:
##woocommerce_store## : 12
Type ## in the System Prompt editor and select the connected WooCommerce store.
Do not manually guess the ID.
Add an order note
The action format is:
##woocommerce_update_order_note## : whatsapp-connected
The text after the colon is the exact note that should be added.
For your actual workflow, replace the example note with the text you want to save.
Example: Record WhatsApp support
Suppose a customer asks about an order and your team wants to mark that the customer contacted support through WhatsApp.
Your prompt could say:
When an existing order has been successfully handled through WhatsApp support,
add the following internal note to the WooCommerce order:
##woocommerce_update_order_note## : whatsapp-connected
The exact note value should match the one you want added to the order.
Add a useful note
A more descriptive note can provide better context.
Example:
##woocommerce_update_order_note## : Customer contacted support on WhatsApp regarding delayed delivery.
This is much more useful than:
##woocommerce_update_order_note## : Customer
Use the order lookup first
When the customer has multiple orders, the agent needs to know which order is being discussed.
A useful workflow is:
Customer provides order number
↓
Check WooCommerce order
↓
Handle the request
↓
Add order note
The order lookup action is:
##woocommerce_get_order_details##
Example System Prompt
You are the Order Support Agent for our ecommerce store.
Help customers with existing WooCommerce orders.
When the customer asks about an existing order,
ask for the order number if it is not already available.
Use the WooCommerce order lookup action.
##woocommerce_get_order_details##
When an order has been successfully handled through this
WhatsApp support conversation, add the configured internal
note to the WooCommerce order.
##woocommerce_update_order_note## : whatsapp-connected
Never add the note until the correct order has been identified.
Do not invent order information.
Don't add notes to the wrong order
This is one of the most important safeguards.
Customer:
Please add a note to my order.
If the customer hasn't provided enough information to identify the order, ask for it.
Don't assume the most recent order unless your workflow explicitly provides that information.
Use order notes with human handoff
You can combine a WooCommerce note with human assignment.
For example:
When an order requires human investigation:
Add an internal WooCommerce note.
##woocommerce_update_order_note## : Customer requires manual investigation.
Assign the conversation to the Support team.
##assign_human_role## : 3
The ecommerce team now has context inside the order and the support team receives the conversation.
For more on human handoff, see How to Hand Off AI Conversations to Human Agents in ZazzyAgent.
Use notes for internal information
An order note should contain information your team needs.
Good:
Customer requested a delivery callback.
Less useful:
Customer talked to bot.
Don't expose internal notes to the customer
The WooCommerce note is for your store team.
Your customer-facing response should be handled separately.
For example:
Internal note
Customer requested delivery callback.
Customer reply
Thanks. I've passed your request to our support team.
Combine the note with an AI action
A more complete support workflow could be:
Customer
↓
AI Agent
↓
Identify order
↓
WooCommerce order lookup
↓
Resolve or assess issue
↓
Add order note
↓
Human handoff if required
Common problems
The note isn't being added
Check:
WooCommerce store is selected.
The exact order is identified.
The action is present in the System Prompt.
The action is reached only after the required condition.
The note is added to the wrong order
Make the order-identification step more explicit.
Don't allow the agent to guess which order the customer means.
The wrong note is added
Use an exact note value and make the condition for the action clear.
When should you use a WooCommerce note instead of a custom field?
Use a WooCommerce order note when the information is specifically relevant to an order.
Use a ZazzyAgent custom field when the information belongs to the customer and may be useful across future conversations.
Example:
Order note
Customer requested delivery after 6 PM.
Custom field
Preferred Contact Time = 6 PM
Both can be useful, but they serve different purposes.
Best practice
Before writing an order note, make sure the agent knows:
Which order?
Why add the note?
What exact information should be recorded?
That gives your ecommerce team a much cleaner operational record.