Connect DeskClerk AI customer support to a WooCommerce store

1. Who this page is for

You sell with WooCommerce and want shoppers to get answers on product pages without leaving the store.

2. What you get, and what you do not get

You get

A support bubble in the bottom-right corner of every page of your WooCommerce site, answering from the knowledge you publish in DeskClerk.
Answers in the language you configured for the site, with a "was this helpful" path and a human handoff when the AI cannot answer.
Nothing to install from a marketplace: one line of HTML, and no maintenance when we update the product.

You do not get

No WooCommerce plugin or app from us. We publish no extension in any marketplace, and no one needs to approve one.
We do not change your theme, products, orders, prices, or checkout. The bubble only talks to DeskClerk.
The bubble does not read your store data. If visitors need an order-specific answer, write an article about that policy and publish it.
Usage counts against your plan's monthly quota. When you need more, you can top up at any time from your workspace.

3. Before you start

A DeskClerk site that has been published at least once. The bubble answers from your published knowledge, so publish first.
Your widget embed code. Your workspace generates one line of HTML for your site — copy it as it is.
Edit access to your WooCommerce site (theme files, custom code, or script manager, depending on the platform).
One minute to test in a private/incognito browser window after saving.

4. Step by step

In your WordPress admin, go to Appearance → Theme File Editor.
Open footer.php of your child theme.
Paste the snippet from section 5 just before </body>.
Click Update File.
Open a product page in a private window; the bubble should sit above the page content, not inside the product tabs.

WooCommerce runs inside WordPress, so the placement is the same as a WordPress site. The bubble does not read cart or order data — it answers from the knowledge you publish in DeskClerk. For order-specific questions, publish an article that explains your policy.

Where to click is written out in each step, because the menu names differ between WooCommerce versions and plans. If a menu is missing, your plan may not include custom code — that is a hosting limitation, not a DeskClerk setting.

5. Copy-paste example

This is the complete snippet. It is one <script> tag; there is nothing else to include.

<script async src="https://chat.example.com/widget.js" data-aichat-config="eyJzaXRlSWQiOiI3YjBjOWY1ZS0yYThkLTRmMzEtOGU2Yi0xYzJkM2U0ZjVhNmIiLCJwdWJsaWNLZXkiOiIzZDlmOGMyYTFiNGU2ZjcwODE5MmEzYjRjNWQ2ZTdmOCIsImFwaUJhc2VVcmwiOiJodHRwczovL2NoYXQuZXhhbXBsZS5jb20iLCJsb2NhbGUiOiJhdXRvIn0"></script>

The data-aichat-config value is your site configuration, base64-encoded. Do not edit it by hand: copy the line your workspace generates, because the encoded value contains your site ID and public key.

To verify it is live, open the page and search the source for widget.js. When the tag is there and the network request returns 200, the bubble loads within a couple of seconds.

6. Common questions

I get 403 Forbidden / code 40301. The key is missing, disabled, or does not carry the scope the endpoint needs. Check that the header name is exactly X-Integration-Api-Key (or Authorization: Bearer <key>), that the key is ACTIVE, and that this Site ID is listed on the key.
I get 429 Too Many Requests / code 42901. You are above the request rate for the site. Read the Retry-After header, wait that many seconds, then retry with backoff. Do not retry in a tight loop.
The bubble does not appear on the page. View the page source and search for widget.js — if it is missing, the snippet is not on the rendered page (a cache plugin or a theme setting is dropping it). If it is present, check the browser console for a Content-Security-Policy error and allow https://chat.example.com in script-src and connect-src. Ad blockers also hide chat bubbles; test in a clean profile.
The bubble appears but the answer says it does not know. The knowledge is empty, still processing, or tagged with a different locale. In your workspace open Site → Knowledge and confirm the item count is above zero, the pending count is zero, and the item locale matches how visitors ask.
Creating a conversation returns 400 with Locale must be enabled for this site's Help Center. locale must be one of the language codes enabled for your site (for example en or zh) — not a region form such as en-US or zh-CN. Check the language list in your site settings and send the code exactly as it appears there.
Does this slow my site down? The script is loaded with async, so it does not block your page rendering. If the DeskClerk host is unreachable, your page still loads normally.
Can I show the bubble only on some pages? Yes — add the snippet to a template that only those pages use, or wrap it in your platform's page condition. On WordPress you can wrap it in is_page() checks; on Shopify in {% if template contains ... %}.

7. Who to contact

Product and setup questions: [email protected]
Include in every message: your Site ID, the page URL where the bubble is missing, the exact snippet you pasted, and a screenshot of the browser console if there is an error.
Security: never send us your API key in plain text. The key prefix is enough for us to locate it.