How do I connect my WooCommerce store?

What the WooCommerce connection gives you

When a visitor asks about a product, the agent queries your store at that moment. Product, price and stock data are never copied into Agenola. The only things copied are your information pages, such as shipping, returns, FAQ and contact, and your pickup locations, which are added to the agent's knowledge base.

When you connect, a store agent named “WooCommerce Agent” is created and the plugin adds the agent button to your storefront.

Connecting step by step

1. On Integrations → WooCommerce, enter your store address (e.g. mystore.com) and press “Connect”. Your store must be served over https. If the Agenola plugin isn't installed, you're shown how to install it; after installing and activating it, press “Connect again”.
2. The Agenola Agent screen opens in your WordPress admin; in the “Agenola connection request” box, press “Approve”.
3. When you return to Agenola you see “Store connected. You can use WooCommerce steps in your agents.”

You can also start from WordPress: on the Agenola Agent screen that opens when you activate the plugin, press “Connect to Agenola”, check the store address in Agenola and press “Connect”. The store comes back connected; WordPress doesn't ask you to approve again.

What the agent can see

Once your store is connected, the agent can read your products, categories and store details, and after the order number and the email or phone on the order are verified it can see the visitor's own order. The cart works in the chat. There's nothing to turn on in the plugin for these. For search by photo, press “Index products” once in the plugin's “Search by photo” section; see search by photo.

You choose which of these the agent uses in the AI Assistant step's “Integrations” tab. In the agent created when you connect a store, the ones that are safe for visitors are on; product, order, customer, coupon and page management are off.

Real cancellations and refunds are separate: they don't work until you turn them on in the plugin.

For the order options in detail, see Order lookup, cancellations and refunds.

After connecting

• The store card shows the site name and address, the WordPress, WooCommerce and plugin versions, and whether the agent may cancel orders and open refund records. You turn these two on in the “Order cancellation and refunds” section of the WooCommerce → Agenola Agent page in WordPress; the “WordPress admin” link on the card takes you there.
• If the plugin is out of date, the card shows an update notice and a button to download the plugin.
• “Disconnect” also disconnects the plugin in your store; the agent button leaves your storefront.
• “Edit the store agent” opens the created agent. Changes you make in the editor reach the storefront when you click “Publish”.
• In the plugin's “Storefront” section in WordPress you choose the agent's name on your storefront, the window size and whether the button shows; these are stored only on your site and take effect right away.
• WooCommerce steps for your agents are under Add step → Integrations → WooCommerce: besides visitor-facing steps such as product search, order status and order requests, there is product, category, stock, order, customer, coupon and page management. The “What it does” section on the provider page lists them all.

Your information pages, such as shipping, returns, FAQ and contact, are added to the knowledge base on their own when you connect, when you save the page in WordPress and once a day. If customers can visit your store, write the address on your contact page: the address in your WooCommerce settings isn't given to the agent.

If it won't connect

• If the plugin says “Agenola could not reach your site”, Agenola can't reach your site: check that the site is publicly accessible, permalinks are enabled and no security plugin is blocking Agenola's access.
• “The store address must use https”: your site is not served over https.
• “Another store is connected to this workspace”: one WooCommerce store connects per workspace; disconnect the other one first.
• “The connection request expired”: press “Connect” again and finish the approval in the same browser.

Disconnecting

Press “Disconnect” on the store card in the panel and confirm, or press “Disconnect” on the plugin screen; each side tells the other. If the store can't be reached when you disconnect from the panel, the panel tells you; then also press “Disconnect” on the plugin screen yourself. The agent stops reading from this store; the agent and knowledge base entries stay.