WooCommerce stores

AI customer support for WooCommerce: a WordPress plugin and live order lookup

PepoChat puts an AI support agent on your WooCommerce store. The official WordPress plugin adds the widget to every page with no theme code, and a read-only WooCommerce REST API key lets the agent look an order up by its number, or find a customer's recent orders by the exact email they ordered with. Shipping, returns and product questions are answered from the pages you import, and anything that needs a person goes to your team inbox.

It suits WooCommerce stores run by an owner or a small team who want order questions answered at night without giving a chatbot the power to change an order. The key is read-only, so the agent reports and never edits.

  • Every chat feature on the free plan
  • No credit card

Rendered from the widget's own markup with sample data; the conversations are the ones the agent is built for.

How it works

How a WooCommerce store sets it up

  1. 1

    Import your store pages and policies

    In Knowledge Base, add your store by sitemap or crawl so the shipping page, the returns policy, the FAQ and the product pages become the knowledge base. An import brings in up to 200 pages and counts as one knowledge source. Upload a policy that lives in a PDF, and write a Q&A pair for anything customers phrase differently from your policy text.

  2. 2

    Install the plugin from WordPress.org

    In WordPress go to Plugins, Add New Plugin, search for PepoCloud AI Support Agent, then install and activate it. Under Settings, PepoCloud Agent, paste your Organization ID from Widget Setup (pasting the whole install snippet works too), choose the corner and save.

  3. 3

    Keep the widget off checkout if you prefer

    Under Hide on these pages, add one path per line with * as a wildcard: /checkout hides the widget on the checkout page and /my-account/* on every account page. Saving also clears the common page caches, so visitors see the change right away.

  4. 4

    Create a read-only REST API key

    Go to WooCommerce, Settings, Advanced, REST API, Add key. Set the user to an administrator and Permissions to Read, generate the key, and copy the consumer key and consumer secret at once, because WooCommerce shows the secret only once. The store must be served over HTTPS, and Settings, Permalinks must not be set to Plain.

  5. 5

    Paste the key into PepoChat and pick the lookups

    Under Integrations, open WooCommerce and enter your store domain (with the folder if WordPress lives in one, such as mystore.com/shop), the consumer key and the consumer secret. Tick the actions you want: Check WooCommerce order, Find WooCommerce orders by email, or both.

  6. 6

    Test with a real order, then switch it on

    Click Test on Check WooCommerce order with a real order number and read the result as a stranger would. Actions added with a key start switched off; flip each one on when it looks right. Then ask about the same order in the Test the agent drawer: test chats are free, but the lookup runs for real.

Plans

What each plan gives a WooCommerce store

CapabilityFreeStarterGrowthScale
AI replies a month100, then conversations go to your inbox1,000, then $39 per 1,0005,000, then $39 per 1,00017,000, then $39 per 1,000
WooCommerce order lookups, by number and by emailIncludedIncludedIncludedIncluded
WordPress pluginIncludedIncludedIncludedIncluded
Helpdesk tickets (Zendesk, Freshdesk, Zoho Desk, HubSpot, Salesforce)IncludedIncludedIncludedIncluded
Knowledge sources5 (a whole-store crawl counts as one)UnlimitedUnlimitedUnlimited
Knowledge base text20 MB200 MB1 GB5 GB
Weekly re-fetch of imported store pagesNot included; sync by handIncludedIncludedIncluded
Team members13, extra seats $15 a month10, extra seats $15 a month20, extra seats $15 a month
Actions per workspace, integrations and custom combined20202020
New-lead emails to the teamNot includedIncludedIncludedIncluded
"Powered by PepoChat" on the widgetShownShownShownShown

Prices in US dollars; yearly plans cost ten months' price. Overage on paid plans is billed on the next invoice. The WordPress plugin itself is free and open source.

The WordPress plugin puts the widget on the store

On WordPress you install a plugin; you do not paste a script tag. PepoCloud AI Support Agent is listed in the WordPress.org plugin directory and installs from Plugins, Add New Plugin. It has one settings page: Organization ID, widget position, preload, hide for logged-in users and hide on these pages. The widget is added in the footer, so it works with block themes, classic themes and page builders such as Elementor and Divi, with no template edits.

Stores usually keep the launcher out of the way of a purchase. One path per line, with * as a wildcard, hides it on /checkout or on every page under /my-account/. The switch that hides the widget for logged-in users applies to every signed-in visitor, so on a store where customers have accounts it hides the chat from them too.

Saving the settings clears the common page caches: LiteSpeed, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround, WP Engine and Breeze. That matters on a cached store, where you would otherwise see the widget while logged in and visitors would not; a CDN in front of the site still needs one purge by hand. Colors, the greeting and suggested questions stay in the PepoChat dashboard, and plugin updates arrive through the normal Plugins screen.

How the store connects: a read-only REST API key

WooCommerce ships its REST API inside the plugin, so there is no app to create. You generate a key pair under WooCommerce, Settings, Advanced, REST API with Permissions set to Read, and paste the consumer key and secret into the WooCommerce card under Integrations, with your store's domain. The connection is made in the PepoChat dashboard; the WordPress plugin only places the widget.

Read permission covers both lookups and means the agent cannot change an order, however a visitor words the request. The secret is encrypted before it is stored and is never shown again in the dashboard, and every call goes over HTTPS to your own store.

Three things stop a first test. Plain permalinks, because the REST API routes do not exist until you pick another setting. A store that is not served over HTTPS. And a host that strips the Authorization header, which shows as a 401 'Sorry, you cannot view this resource' although the key is right; the usual fix is the SetEnvIf Authorization rule in .htaccess.

Two lookups: by order number, or by the exact email

Check WooCommerce order takes the order number, digits only. It returns the order's status, the dates it was created and paid, the total, the currency and the payment method, and the agent confirms the returned number matches the one the customer gave. A custom order numbering plugin changes the visible number, which is the reason for that check.

Find WooCommerce orders by email is for the customer who has no number to hand. The agent asks for the email they ordered with and gets back up to three recent orders, each with its number, status, date and total. The address has to be a complete one, and only orders whose billing email matches it exactly, ignoring capital letters, reach the agent. WooCommerce's own search also matches parts of addresses, so PepoChat drops orders placed under any other address first.

Neither lookup returns line items, a shipping address, a carrier or a tracking number, and nothing else in WooCommerce's reply reaches the model. If the store says not found, the agent asks the customer to double-check; on any other error it offers a person.

Neither lookup checks who is asking. WooCommerce order numbers are sequential, so anyone who guesses a number can hear that order's status and total. If that matters to you, keep only the email lookup switched on: it needs a customer's full address rather than a number that counts upwards, though an email address is not a secret either.

Policies, product questions and the handoff

Returns, shipping zones and delivery times are answered from your own pages. Import the store once by crawl or sitemap and add Q&A pairs for the exceptions. Descriptions, sizes and materials that appear on a product page are answerable. Stock is not read from WooCommerce, so send availability questions to the product page. On the paid plans imported pages are re-fetched every week; on Free you sync by hand after the store changes.

The agent has no action that edits an order, so a cancellation, an address change or a refund request is collected and handed over. The conversation turns escalated in your inbox, every workspace member gets an email with the last three messages, and with Zendesk, Freshdesk, Zoho Desk, HubSpot or Salesforce connected the agent can file a ticket and tell the customer its number.

Set Team availability to business hours and the agent tells shoppers when the team is back instead of promising a quick reply at midnight, and asks once for an email address so you can follow up.

What it does not do for a WooCommerce store

  • The WordPress plugin only places the widget. WooCommerce is connected in the PepoChat dashboard with a REST API key; the plugin has no order features of its own.
  • The key is read-only. The agent cannot cancel, edit or refund an order, change an address or create an order, and no PepoChat action moves money.
  • Lookups return status, dates, total, currency and payment method for one order, or number, status, date and total for up to three orders by email. No line items, addresses, carrier or tracking number.
  • The email lookup takes a complete address and matches the order's billing email exactly, ignoring capital letters. Part of an address, or an order placed under another email, finds nothing.
  • Neither lookup is gated by sign-in or by email verification. Order numbers are sequential, so anyone who guesses a number can hear that order's status and total; keep only the email lookup enabled if that matters.
  • The store must be served over HTTPS with permalinks not set to Plain, and a host that strips the Authorization header blocks the connection until it passes the header through.
  • Stock and the product catalog are not read from WooCommerce. Product answers come from the pages you import.

WooCommerce stores: questions teams ask

Is there a PepoChat plugin for WooCommerce?
The widget installs with the PepoCloud AI Support Agent plugin from the WordPress.org directory, which works on any WordPress site, WooCommerce stores included. There is no separate WooCommerce extension: order lookups are connected in the PepoChat dashboard with a read-only REST API key.
Can a customer check an order without the order number?
Yes. The agent asks for the email they ordered with and lists up to three recent orders with their number, status, date and total. The address must be complete and must match the order's billing email exactly; part of an address finds nothing.
Can it tell a customer where their package is?
It reports the order's status, such as processing or completed, with its dates and total. It does not return a carrier or a tracking number. Put your delivery times on a shipping page so the agent can set expectations, and let your team pick up anything that looks stuck.
Can the agent cancel or refund a WooCommerce order?
No. The REST API key has Read permission only, and the agent has no action that edits, cancels or refunds an order. It explains your returns policy from your content and hands the case to your team, with a helpdesk ticket if you connected one.
Does the chat have to show on the checkout page?
No. In the plugin's settings, add /checkout under Hide on these pages, and /my-account/* to hide it on every account page. Leave the box empty to show the widget everywhere.
Will the plugin slow the store down or clash with my theme?
The script loads asynchronously after your page, and the chat itself is fetched during idle time or when a visitor clicks; preload can be turned off in the plugin settings. The widget is added in the footer, so it works with block themes, classic themes, Elementor, Divi and other builders.
What does it cost for a WooCommerce store?
The plugin is free and open source, and both order lookups are on every plan, including Free with 100 AI replies a month. Starter is $39 a month with 1,000 replies, Growth $149 with 5,000 and Scale $499 with 17,000, and replies past a paid allowance cost $39 per 1,000.

Still unsure? Email [email protected] or talk to us.

WooCommerce orders looked up by number or email

Paste one script tag or install the WordPress plugin, point the agent at your content, and the first conversation resolves itself. Every chat feature is on the free plan.

  • No credit card
  • About ten minutes to set up
  • Claims checked against the docs on November 13, 2026