WooCommerce Plugin — Install, Connect & Run Botaura in wp-admin

WooCommerce Plugin — Run Botaura Inside wp-admin

The Botaura for WooCommerce plugin connects your WooCommerce store to Botaura and lets you run your AI assistant, orders, and WhatsApp inbox from right inside WordPress admin — no separate login, no copy-pasting code. This guide covers install → connect → what syncs → troubleshooting → uninstall.

Plan requirement: Connecting a store requires the Business plan or above. You'll need a Botaura account first — sign up at botaura.app/sign-up.

---

1. Install & Activate

1. Download the Botaura for WooCommerce plugin (a .zip).
2. In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip, and click Install Now.
3. Click Activate. A Botaura menu item appears in your wp-admin sidebar.

Requirements: WordPress 6.0+, WooCommerce 6.0+, PHP 7.4+.

---

2. Connect Your Store (one click)

1. Open the Botaura menu and click Connect.
2. You're sent to Botaura to authorize the connection. Sign in (or sign up) and approve.
3. You're returned to wp-admin with a Connected status.

Behind the scenes, connecting does several things automatically and securely:

• Creates read-only WooCommerce API keys (Botaura can read products/orders, never modify your store data directly).
• Stores a Botaura ingest key on your server (kept server-side, never shown in the page).
• Pulls in your product catalog and starts a one-time crawl of your storefront to build the bot's knowledge base.
• Registers webhooks so future changes sync in real time.

Anti-hijack protection: if a store was already connected to a different Botaura account, you'll be asked to claim it rather than silently overwriting — so a store can't be hijacked.

---

3. What Syncs (and What Doesn't)

Syncs into Botaura

• Products — full catalog on connect, then live updates via three webhooks: product create, update, and delete. Name, price, description, image, and link are used for chat answers, product cards, and WhatsApp ordering.
• Orders — when a customer checks out, the order flows to Botaura. Cash-on-delivery orders trigger a WhatsApp confirmation; prepaid orders are recorded without one.
• Order status changes — when an order's status changes in WooCommerce, Botaura's copy updates to match (mapped to its own pending/confirmed/shipped/delivered/cancelled lifecycle).
• Storefront content — the on-connect crawl adds your pages to the knowledge base so the bot can answer general questions (shipping, returns, etc.).

Doesn't sync / by design

• Botaura's WooCommerce keys are read-only. When you change an order's status from the embedded Orders screen, the write is applied through your own WordPress session (a secure, nonce-checked action) — not by Botaura editing your store with elevated keys.
• Stock levels aren't managed by Botaura; it reads price and product details for selling, and your store remains the source of truth for fulfillment.

---

4. Using Botaura Inside wp-admin

Once connected, the Botaura menu embeds the same screens you'd see in the Botaura dashboard — Overview, Chatbot, Orders, WhatsApp Inbox, Templates, Campaigns, Customers, Leads, Cart Recovery, and more — so your team manages everything without leaving WordPress. These are the exact same features as the web dashboard (see Dashboard Overview); anything you set up here shows up there and vice-versa.

A few flows (like the live-crawl terminal) deep-link out to botaura.app in a new tab, and connecting WhatsApp offers self-serve Embedded Signup or white-glove setup (see WhatsApp Setup).

---

5. Troubleshooting

• Connect fails or returns an error — make sure WooCommerce is active, your site is reachable over HTTPS, and you're logged into the Botaura account you want to link. Try Connect again; connect attempts are rate-limited, so wait a moment if you retried several times.
• "Store already connected" — the store is linked to another Botaura account; use the claim option or disconnect it from that account first.
• Products didn't import — the backfill runs right after connect; give it a few minutes. Newly added products sync via webhook — if one is missing, re-save it in WooCommerce to re-fire the webhook.
• Orders aren't creating WhatsApp confirmations — confirmations are for cash-on-delivery orders with customer consent, and require your number to be connected and the order template approved (see WhatsApp Templates).
• Embedded screen won't load — a strict security policy or ad-blocker can block the iframe; the plugin scopes this per-store automatically, so refresh and ensure your admin session is active.

---

6. Disconnect & Uninstall

• Disconnect — from the plugin, disconnecting clears the local credentials on your server. You can also disconnect the store from the Botaura dashboard side.
• Uninstall — deleting the plugin from Plugins runs a cleanup that removes all Botaura options and cached tokens from your WordPress database (ingest key, business name, connection status, site URL, and the cached plugin token). Your WooCommerce data is untouched.

Note: uninstalling the plugin stops the sync, but any data already in your Botaura account stays there — manage or delete it from the Botaura dashboard.

---

Related

• Store Integrations overview — all connection options
• Shopify App — the equivalent for Shopify
• WhatsApp Orders — managing the orders that sync in