# How to Update Shopify Order Tags With a ZazzyAgent AI Agent

Order tags can help Shopify teams identify orders that need special attention.

For example, you might want to mark an order as:

> whatsapp-connected

or another internal tag used by your workflow.

ZazzyAgent AI Agents can add an exact configured tag to a Shopify order.

## Before using the action

You need:

*   Connected Shopify store
    
*   AI Agent
    
*   Shopify order-related workflow
    
*   The order tag you want to add
    

## Select the Shopify store first

Shopify actions require:

```text
##shopify_store## : 12
```

Use autocomplete to select your connected Shopify store.

## Add an order tag

Use:

```text
##shopify_update_order_tag## : whatsapp-connected
```

The value after the colon is the **exact tag** you want to add.

## Why must the tag be exact?

Your System Prompt should use the actual tag value expected by the Shopify workflow.

Don't improvise:

```text
##shopify_update_order_tag## : WhatsApp Connected
```

if your configured tag is:

```text
whatsapp-connected
```

Use the exact value.

## Example: Mark an order handled through WhatsApp

Suppose your support process wants to mark orders that have been handled through WhatsApp.

Your prompt could say:

```text
When an existing order has been successfully handled
through WhatsApp support, add the configured Shopify order tag.

##shopify_update_order_tag## : whatsapp-connected
```

## Use it after order lookup

An especially useful pattern is:

**Customer provides order number**

↓

**Check Shopify order**

↓

**Resolve the request**

↓

**Update order tag**

Example:

```text
When the customer asks about their existing order,
retrieve the live order information.

##shopify_get_order_details##

If the order is successfully handled through this WhatsApp conversation,
add the configured Shopify tag.

##shopify_update_order_tag## : whatsapp-connected
```

For live order lookup, see [How to Build a Shopify Order Status AI Agent on WhatsApp](https://blog.zazzyagent.com/shopify-ai-order-status-agent-zazzyagent).

## Don't tag the wrong order

The AI needs to know which order the customer is talking about.

If the customer says:

> Please tag my order.

but no order number is available, the agent shouldn't guess.

Ask for the necessary identifier first.

## Don't invent tags

Don't let the AI generate arbitrary tag names.

Use the exact configured value.

Bad:

> Add whatever tag seems appropriate.

Better:

> When the specified condition is met, add the exact `whatsapp-connected` tag.

## Combine tagging with an internal note

You could use:

```text
##shopify_update_order_tag## : whatsapp-connected

##add_note## : Order was handled by WhatsApp support.
```

This gives both Shopify and your support team a record of what happened.

## Combine with human handoff

Suppose an order requires manual review.

You could:

1.  Look up the order.
    
2.  Add a tag identifying the issue.
    
3.  Add an internal note.
    
4.  Assign the conversation to support.
    

The exact tags and routing rules should reflect your business process.

## Use tags to improve Shopify workflows

Order tags can help your team identify:

*   Orders requiring attention
    
*   Orders handled through a particular channel
    
*   Special workflows
    
*   Internal processing states
    

The meaning of each tag should be documented internally so your team uses a consistent naming system.

## Common problems

### Tag wasn't added

Check:

*   Shopify store is selected.
    
*   Exact tag value is used.
    
*   Customer provided the correct order.
    
*   The action is actually triggered.
    
*   Shopify connection is active.
    

### Wrong tag was added

Review the System Prompt and make the condition more explicit.

### AI adds a tag too early

Define exactly when the tag should be added.

For example:

> Only add the tag after the customer's order has been successfully identified and the WhatsApp support interaction is complete.

## Important distinction

Adding a tag is an **internal Shopify operation**.

It does not automatically send anything to the customer.

The customer-facing response should be configured separately.

## A simple workflow

```text
Customer
   ↓
Provide order number
   ↓
Shopify order lookup
   ↓
Resolve enquiry
   ↓
Shopify order tag
   ↓
Optional internal note
   ↓
Conversation complete
```

This creates a useful connection between your WhatsApp support team and Shopify operations.

[zazzyagent.com](http://zazzyagent.com)