Show your WooCommerce products in chat

Replace https://shop.example.com with your store address and open this URL in your browser:

https://shop.example.com/wp-json/wc/store/v1/products?search=shirt&per_page=2

If you prefer a terminal, the same check is:

curl 'https://shop.example.com/wp-json/wc/store/v1/products?search=shirt&per_page=2'

Expect HTTP 200 and a JSON list of matching products. This example is trimmed to the fields the widget uses; your product names, prices, and image URLs will differ:

[
  {
    "name": "Oxford shirt",
    "permalink": "https://shop.example.com/product/oxford-shirt/",
    "on_sale": true,
    "prices": {
      "price": "4800",
      "regular_price": "6400",
      "currency_minor_unit": 2,
      "currency_prefix": "$",
      "currency_suffix": "",
      "currency_decimal_separator": ".",
      "currency_thousand_separator": ","
    },
    "images": [
      {
        "thumbnail": "https://shop.example.com/wp-content/uploads/oxford-shirt-300x300.jpg"
      }
    ],
    "is_in_stock": true
  }
]

No matches returns []. Try a word from one of your product names if your store does not sell shirts. An empty search returns products without a search term; per_page limits how many are returned.

WooCommerce’s Store API exposes public product data without authentication. This endpoint does not require the keys used for WooCommerce’s administrative REST API.

In your Agent, open Build → API connections → Create connection:

Leave Headers empty and select Save changes. Use the exact HTTPS address that returns JSON directly. Chatvox does not follow redirects. If WordPress is installed in a subdirectory, include it in the base URL.

Download the Product results widget file. Open Build → Widgets, select Import above the widget list, and choose the downloaded JSON file. The builder opens with the widget ready to save. Import creates a new widget; it does not overwrite an existing one. If the name is already in use, Chatvox adds a number.

The file includes one field, products (List), and two functions:

Each row shows images[0].thumbnail, the product name, its current price, and an In stock or Out of stock badge from is_in_stock. When on_sale is true, it also shows the regular price struck through. The layout displays up to four products.

Keep Enabled on and select Save changes. There is no code to write or paste. The Default preview contains sample products; the action response replaces the products list. Select No results to preview the empty state. Named examples affect only the preview.

Store API prices are strings in minor units: "4800" with currency_minor_unit: 2 means $48.00, not $4,800. The imported widget’s Money component reads the amount, minor unit digits, currency prefix and suffix, and separators from prices to format it correctly.

Open Build → Actions → Create action and select Custom API. Enter:

Under What the agent sends, select Add field:

The optional input lets the Agent browse without asking for a search term. The path already includes search; you do not need another query field.

Under Response, use:

Clear the default Success path and Data path. With these empty, Chatvox uses the HTTP status for success and the whole response.

In Test, enter shirt in Search and select Send test request. Then, under Map fields, open the Response value list for products and choose Whole response:

The Store API returns a bare list, without a products wrapper. Whole response maps that list to the widget’s products field. See Custom API response mapping.

Keep All fields here. Only selected fields currently does not accept list-item paths such as 0.name. Store API products include extra data such as HTML descriptions, so per_page=4 keeps each response small. This guide does not add pagination or retrieve the whole catalog.

The test response should be a successful product list. Also test a term you do not sell, such as bicycle; expect a successful empty list. This checks the request and AI response data; it does not render the widget.

Select Save changes, confirm the action is Enabled, and keep Web widget on under Channels. Keep Run again → Every time so later searches retrieve current data. The action and its selected widget use one Actions & Widgets slot together.

Open the chat on your storefront and try:

For a sale product, compare both displayed prices with its product page. Select View and confirm it opens that product’s page. Help me choose sends a follow-up message in the same chat; it does not create a ticket or send email.

Try a fresh chat while signed out too. Product search is available to everyone and needs no customer identity. Search results are a limited selection, not a total count of everything in your catalog.