How to add a WooCommerce chat that survives updates
The shortest route is also the least reliable. You paste the line in the theme file editor, straight into the theme the store uses, and the chat works until the first update. The new theme version overwrites the files, the chat disappears without warning, and you only notice a week later, looking at an empty conversation panel.
WordPress documentation has the child theme for exactly this kind of change. It lets you update the parent theme without losing your modifications, and the child theme's functions.php loads together with the parent's, just before it. There you add a short function hooked to the wp_footer action that prints the chat line before the page closes. That action has to be fired by the theme, and the documentation notes that this depends on the theme's author, so afterwards look at the page source and check that the script is there. You can create a child theme for a block theme too.
Make a copy of the file before the change. A typo in functions.php can take the site down, and then you fix it over FTP or the file manager in your hosting panel. While you are at it, ask the provider whether the script loads asynchronously, with the async attribute, because that kind does not hold up the page from rendering.
Connecting the catalogue is a separate stage
A bubble on the page does not know what you sell. A bot that is supposed to advise on products needs the catalogue, and in WooCommerce the simplest way to give it one is through the REST API. You create the key in WooCommerce > Settings > Advanced > REST API with the “Add key” button, enter a description, choose a user, set the permissions to “Read” and click “Generate API key”.
The Consumer Secret is shown only once. Pass it to the provider through a secure channel and do not leave it sitting in an inbox for years. If the API does not respond, check Settings > Permalinks, because the WooCommerce documentation requires any option there other than “Plain”.
This is how we connect CartBot. The key has read-only rights, the connection goes over HTTPS only, and the catalogue refreshes on a schedule, so a price change reaches the bot with a delay. The “Add to cart” button in the chat puts the product into the real WooCommerce cart in the customer's session. With variants the bot asks about size or colour, and with some templates the customer finishes the choice on the product page. If you want, the bot can use the same key to check an order status too, but only when the customer gives the order number together with the email address used for the purchase.
Test on a phone and in the cart
Test in a private window, as a guest, on a real phone, because the mobile preview in a desktop browser will not show you how the bubble behaves under a thumb. Go through this list in order.
- The bubble does not cover “Add to cart” on a product page or the order button on the last step, even when you scroll all the way to the bottom.
- The chat and the cookie banner can both be closed.
- A product with a variant added from the chat lands in the cart with the right size or colour and at the same price the bot showed in the conversation.
- Asked something outside the product description, the bot admits it does not know.
- If you have a speed plugin that combines or delays scripts, clear its cache and check that the chat still loads.
- The chat stays in place after a theme and WooCommerce update.
How to remove the chat and roll the setup back
You undo it the same way it arrived, and once you deactivate the chat plugin you delete it from the plugin list right away so it does not sit there without updates. From the child theme you delete the whole function you added, and in Tag Manager you pause or delete the tag and publish the changes, because without publishing it keeps running on the site. At the end open the store in a private window and check that the bubble is gone.
If the bot was given a REST API key, revoke it where you created it, with the “Revoke” link next to the key in the list, and from that moment the provider can no longer read your products or orders. What remains are the conversations and contacts stored on their side, so ask how to delete or download them, ideally before you sign a contract.
Who looks after the chat after installation
Read the conversations for the first few weeks. When you change the free delivery threshold or the returns rules, the bot has to be told separately, because catalogue sync carries only products. With live chat and a messenger you have to make sure someone answers before the customer closes the tab.
If you would rather have someone do the installation and later fixes for you, CartBot works as a managed service, from PLN 50 net a month, with setup and day-to-day running included. You paste one line and create a key, and we take care of the rest. Write to us and we will quote the installation and management for your WooCommerce store, usually within 24 hours.
