For the complete documentation index, see llms.txt. This page is also available as Markdown.

WooCommerce

Set up an AI agent for WooCommerce that learns your products, orders and customers, answers shoppers in your chat bubble and helps your team.

eesel's AI agent for WooCommerce learns your store and answers shoppers in your chat bubble, your helpdesk (such as Gorgias) and Slack. It knows your products, orders and customers, so it can tell a shopper where their order is, what they bought and what is in stock.

It also helps your team run the store. Ask it in Slack or the dashboard to look into an order, leave a note for the team or update an order, and it does the work in WooCommerce and tells you what changed.

A WooCommerce coffee storefront with the eesel chat bubble open, where the agent recommends three coffees as product cards with prices after looking up products and checking stock
The agent answering on a WooCommerce store, showing products as cards.

WooCommerce is rolling out now. If you don't see it under Integrations, contact us and we'll switch it on for your workspace.

Set up eesel in WooCommerce

1

Ask your agent to connect WooCommerce

Open the chat in your dashboard and ask it to connect WooCommerce. It posts a link to connect your store. Prefer to click? Integrations in the left sidebar has a WooCommerce page with a Connect button.

The dashboard chat where the user asks to connect WooCommerce and the agent posts a Connect WooCommerce link
The agent posts the link to connect your store.
The WooCommerce page under Integrations in eesel, with a Connect button and a short description of how it works
The WooCommerce page under Integrations, before connecting.
2

Create a REST API key in WooCommerce

The connection needs a consumer key and secret. In your WordPress admin open WooCommerce > Settings > Advanced > REST API, click Add key, set Permissions to Read/Write, and click Generate API key. Copy both values before you leave the page.

A person signs in and does this in the WordPress admin. Every screen is on Set up WooCommerce.

3

Paste the key into the connection window

Open the connect link. The connection window asks for the Key, the Secret and your store Domain. Paste them in and click Continue.

The connection window with masked Key and Secret fields and a Domain field
The connection window, with the key and secret masked.
The connection window saying Successfully connected your WooCommerce account
The store is connected.
4

Confirm the connection

Back in the chat, your agent confirms the store is connected and suggests a first thing to try, such as looking up an order.

The dashboard chat confirming WooCommerce is connected, noting that nothing changed in the store, and suggesting order lookups to try
The chat confirming the store is connected.

Check it worked. Integrations > WooCommerce reads Connected, lists Products, Orders and Customers under Sources, and splits the actions into Read and Write groups. From a terminal, eesel status lists WooCommerce as connected.

The connected WooCommerce integration page in eesel, with Products, Orders and Customers under Sources and the Read and Write action groups
The connected integration page, with its sources and actions.
5

Ask about your store

Ask in the chat about your orders. Your agent reads the store and answers with real data. Here it groups recent orders by status and flags two that need attention.

The dashboard chat answering a request for recent WooCommerce orders with tables of pending and processing orders
Recent orders, grouped by status.
The same answer scrolled down, listing on-hold, completed, cancelled and refunded orders and flagging an order that has been on hold for a month
The rest of the answer, with two orders flagged.
6

Act on an order from Slack

With Slack connected, a teammate can mention @eesel in a channel and ask it to act on an order. When an action needs your OK, eesel posts an approval card straight into the thread, with Approve, Deny and Review in eesel buttons.

A Slack thread where a teammate asks eesel to add a private note to order 84, and eesel replies with an approval card showing the action, the note and Approve, Deny and Review in eesel buttons
An order note waiting for approval in the Slack thread.

Approve it, and the agent adds the note and confirms in the thread.

The same Slack thread after approval, with eesel confirming the private note was added to order 84 and is visible to the team only
The note added, confirmed in the thread.

The note appears on the order in WooCommerce as a private note, so the customer does not see it.

Order 84 in the WooCommerce admin with the new private note highlighted in the Order notes panel
The note on the order in WooCommerce.
7

Put it on your storefront

The chat bubble puts your agent in front of shoppers on your store. Ask in the dashboard chat to add a chat bubble for your store. Your agent sets it up with your store's colours, a welcome message and starter questions. Then paste the snippet from your Chat Bubble page into your site, just before the closing </body> tag. The Chat Bubble page has the install steps.

8

Hand a shopper to your team

When a shopper asks for a person, your agent can take their details and open a ticket in your helpdesk. Tell it how in the dashboard chat, for example: "When a shopper asks to speak to a person, ask for their name and email, create a Gorgias ticket with a summary of the chat, tag it chat-bubble-handover, and tell them our team will follow up."

The dashboard chat where the user sets up a chat bubble handover and the agent confirms it saved the rule to its instructions
The handover rule, set up in chat.

It saves the rule to its Instructions.

The Instructions page in eesel showing a Chat bubble handover section, with the setup chat open beside it
The saved handover rule on the Instructions page.

On the storefront, a shopper reports a problem and asks for a person. Your agent asks for their name and email.

The chat bubble on a WooCommerce store where a shopper says order 84 arrived damaged and asks for a real person, and the agent asks for their name and email
The agent taking the handover and asking for contact details.

The shopper gives them, and the agent opens the ticket.

The same chat after the shopper gives their name and email, with the agent confirming the case has gone to the team
The agent confirming the handover.

The ticket lands in your helpdesk under the shopper's email, with a summary of the chat as the first message and the handover tag on it.

A Gorgias ticket for order 84 with the chat-bubble-handover tag, the shopper's email as the requester and a summary of the chat as the first message
The handover ticket in Gorgias, tagged.

Whether a handover waits for your OK depends on the permissions you set for your helpdesk actions.

From Claude Code, Cursor or a terminal. eesel login, then eesel integrations connect woocommerce prints the connect link for a person to open, and eesel status shows the connection. Full command reference: The eesel CLI. Step-by-step: Set up from Claude Code or the terminal. From an MCP client: Claude Code and MCP clients.

Sources, triggers and actions

Sources

Sources are what your agent learns from in your store. eesel copies them when you connect.

Source
Description
Requires

Products

Your catalogue, with SKUs, pricing, stock and variants

Any REST API key

Orders

Your orders, so your agent can find and read them

A key that can read orders

Customers

Your customer records

A key that can read customers

Orders and Customers only appear when the REST API key you created can read them. Switch any source off on Integrations > WooCommerce if this agent shouldn't learn from it. The lookup actions below still read your store live. Written content such as your shipping or returns policy is not in WooCommerce, so connect your website as well.

Triggers

WooCommerce has no triggers. Nothing in your store starts an agent run. The conversation comes from the chat bubble, your helpdesk or Slack, and your agent uses its WooCommerce actions while it handles it.

Actions

Actions are what your agent can do in your store. WooCommerce's actions come from the live connection, so you may see more than the ones below. They are listed on Integrations > WooCommerce in two groups.

Action
What it does

Read

Look up orders

Lists orders or reads one, with its items, totals, status and notes

Look up customers

Searches customers by email or name and reads their details

Look up products and categories

Lists and reads products and product categories

Look up subscriptions

Lists and reads subscriptions, with the WooCommerce Subscriptions extension

Write

Add order note

Adds a private or customer-facing note to an order

Update order status

Moves an order to another status, such as processing or completed

Create refund

Records a refund against an order

Create order, create customer

Creates a new order or customer

Update products and categories

Creates or updates products, and creates, renames or deletes categories

Update subscription

Pauses, resumes or cancels a subscription, or moves its next payment date

Delete order

Deletes an order

You stay in control the whole way. Adjust your AI agent's access to knowledge and its action permissions to your liking. See Actions and Approvals.

Limitations

  • A refund in WooCommerce is not always money returned. It records the refund on the order. Whether the money moves depends on your payment gateway.

  • Subscriptions need the WooCommerce Subscriptions extension. Without it there are no subscription actions.

  • Status changes and customer notes can email the customer. Whether WooCommerce sends one depends on your store's email settings. Ask for a private note when it is only for your team.

Troubleshooting

The connection fails, or the agent can't read the store

Check the consumer key and secret are pasted into the right fields, and that the domain has no path. See the troubleshooting notes on Set up WooCommerce.

Lookups work, but notes, status changes or refunds fail

The REST API key has Read permission only. Change it to Read/Write in WooCommerce > Settings > Advanced > REST API.

A write action did not happen

It may be waiting for your OK. Approve it in the dashboard or in the Slack thread, and it runs.

FAQ

How do I add an AI agent to WooCommerce?

Create a REST API key in your WordPress admin, then connect WooCommerce from the eesel dashboard chat or the Integrations page and paste the key in. The steps are in Set up eesel in WooCommerce, and every WooCommerce screen is on Set up WooCommerce.

What access does the eesel AI agent need in WooCommerce?

A WooCommerce REST API key with Read/Write permissions, created by an administrator. Read is enough for lookups only. Adding notes, changing a status or recording a refund needs Read/Write, and each of those actions still follows the permission you set for it in eesel.

Can the AI agent answer order status questions on my WooCommerce store?

Yes. Add the chat bubble to your store, and your agent looks up the order live and answers with its status and what was ordered. It can answer the same questions in your helpdesk and in Slack.

Can the WooCommerce AI agent hand a shopper to a person?

Yes. Tell it when to hand over in the dashboard chat, and it asks the shopper for their name and email, opens a ticket in your helpdesk with a summary of the chat, and tells them your team will follow up. See Hand a shopper to your team.

Can the WooCommerce AI agent refund or cancel orders?

Yes, within the permissions you set. A refund is recorded on the order in WooCommerce, and whether the money reaches the customer depends on your payment gateway.

Does the AI agent work with WooCommerce Subscriptions?

Yes, when your store runs the WooCommerce Subscriptions extension. Your agent can find a customer's subscriptions, pause or resume them, cancel them now or at the end of the paid period, and move the next payment date.

Can I connect WooCommerce to Claude or ChatGPT?

Yes, through eesel. Once WooCommerce is connected, you can talk to your eesel agent from Claude, ChatGPT or Cursor, and it works with your store data. See Use eesel from Claude and other assistants, Use eesel from ChatGPT and Claude Code and MCP clients.

Last updated