How to Connect WooCommerce to Ensoras: Two Setup Paths

This guide walks through the two ways to connect WooCommerce to Ensoras. The plugin install is the fast default and handles credential generation for you. The manual REST API method is the alternative for sites that can't use the plugin. Pick whichever fits your situation.

Before you start

You'll need:

• WordPress admin access on a site running WordPress 6.0+, WooCommerce 7.0+, and PHP 8.0+
• An Ensoras account (you can create one during the plugin setup if you don't have one yet)
• About 5 minutes for the plugin path, or 10 minutes for the manual path

Path A: Connect via the WordPress plugin (recommended)

This is the fast default. The plugin handles the WooCommerce REST API key generation, the Ensoras account pairing, and the chat widget install in one flow.

Step 1: Install the Ensoras plugin

In your WordPress admin, go to Plugins > Add New. Search for "Ensoras" and find the listing for Ensoras: AI Customer Support & Live Chat Helpdesk for WooCommerce. Click Install Now, then Activate once installation finishes.

If you're on a managed WordPress host that restricts plugin installs, you may need to upload the plugin file manually. The plugin is also available as a download from the Ensoras website if your hosting setup requires it.

Step 2: Open the Ensoras settings page

After activation, you'll see Ensoras in your WordPress admin sidebar. Click it.

The first time you open the page, you see a welcome screen with two main options:

• Get Started Free, for sites that don't have an Ensoras account yet
• I have an account, for sites that want to pair with an existing Ensoras project

Step 3a: New account flow

Click Get Started Free. You'll be prompted for:

• Your name
• Your email address

Submit. Ensoras emails you a 6-digit verification code. Enter the code on the next screen. Your Ensoras account is created and your WooCommerce store is paired with it automatically.

Behind the scenes, the plugin generates a set of read-only WooCommerce REST API keys scoped to Ensoras and stores them on your site. You don't see or paste the keys yourself; they're handled server-to-server.

Step 3b: Existing account flow

Click I have an account. You'll be prompted for:

• Project slug, visible in your Ensoras dashboard URL (the part after /projects/)
• API key, generate one in your Ensoras admin under Settings > API Keys

Paste both, submit, and the plugin pairs with your existing project. If WooCommerce is active and not yet connected to that project, the plugin offers a Connect WooCommerce button to wire up the order data integration in the same flow.

Step 4: Wait for auto-provisioning

In the background, Ensoras creates the starter set of WooCommerce tools (order lookup, customer lookup, product search, and others) plus default workflows for handling order-related tickets. This takes a few seconds.

The chat widget also loads on your storefront automatically through the plugin's theme integration. Visit your storefront in an incognito tab to confirm you see the chat bubble.

Step 5: Verify with a test ticket

Send yourself a test message through the chat widget asking something like:

"Hi, can you check on my recent order?"

If the AI replies asking for your order number or email and then looks up the order, the connection works. The conversation appears as a ticket in your Ensoras admin panel within seconds.

Path B: Connect manually with REST API keys

Use this path when you can't install the plugin (some managed hosts), or when you want to use REST API keys you've already generated in WooCommerce. This flow is more steps but it's the right escape hatch when the plugin path isn't available.

Step 1: Generate WooCommerce REST API keys in WordPress

In your WordPress admin, go to WooCommerce > Settings > Advanced > REST API. Click Add key.

Fill in:

• Description, something like "Ensoras integration"
• User, pick a user with shop manager or admin role
• Permissions, Read (for read-only support) or Read/Write (if you want refund automation)

Click Generate API key. WooCommerce shows you the Consumer Key and Consumer Secret on the next screen. Copy both somewhere safe; the secret is only shown once.

Step 2: Connect inside Ensoras

In your Ensoras admin panel, go to Channels > Integrations. Find the WooCommerce card and click to add a new connected integration. You'll see a form with three fields:

• Store URL, your full storefront URL, including https://. For example, https://acme-supplements.com.
• Consumer Key, paste the value from WooCommerce.
• Consumer Secret, paste the value from WooCommerce.

Save. Ensoras validates the connection by making a test API call to your store. If something's wrong with the keys or URL, you'll see the error here.

Step 3: Install the chat widget separately

The manual path doesn't auto-install the chat widget on your site (the plugin does that). Follow the chat widget setup guide to install the widget snippet in your theme.

Step 4: Review what got auto-provisioned

A successful connection (whether via plugin or manual) creates the same starter tools and workflows in Ensoras. Visit Automation > Tools to see the WooCommerce tools and Automation > Workflows to see the default workflows.

What changes for your customers

After this connection is in place, customers asking order-related questions get answers in seconds instead of waiting for a human reply. The same connection is the foundation for refund automation, return label generation, and product information lookups.

Bank of America's Erica handles tens of millions of routine financial queries per month on the same architectural pattern as a connected WooCommerce store: AI handles the lookup-and-answer work, humans handle the judgment calls.

Common issues

Plugin won't activate. Check your WordPress, WooCommerce, and PHP versions against the minimums (WP 6.0+, WooCommerce 7.0+, PHP 8.0+). Most activation failures trace back to one of these being below the minimum.

6-digit verification code email doesn't arrive. Check your spam folder. If it's not there, the most common cause is the email going to a different address than you expected (some teams have catchall rules that route certain addresses elsewhere). Try resending; the code is one-time and short-lived.

"Connection failed" with REST API keys (manual path). Most often the Store URL is wrong (missing the https:// prefix, or pointing at a staging URL instead of production), or the keys are read-only when the integration needs read/write. Double-check both, regenerate keys if needed.

Widget doesn't appear on the storefront after plugin install. Some themes don't load the storefront footer scripts in the standard way. If the chat bubble doesn't appear within a few minutes of plugin activation, try the chat widget guide's manual install steps which cover what to add to your theme.

The AI ignores WooCommerce even though it's connected. Check that the relevant WooCommerce tools are listed in the Available Tools section of the workflow that should match the customer's message. A connected integration that isn't enabled inside any workflow won't get used.

What to do after this

If you're new to Ensoras and just connected your first store:

• Upload your knowledge base so the AI can answer policy questions (shipping, returns, sizing) alongside order data.
• Write your first workflow rule once you're ready to go beyond the starter set.
• Configure refund automation when you're comfortable letting the AI take action, not just answer.

If you also run a Shopify store, the Shopify setup guide covers the parallel flow on that platform.

Sources

• Bank of America, A Decade of AI Innovation: Erica Surpasses 3 Billion Client Interactions, customer-side reference for what AI-handled order/account lookups look like at sustained scale.
• WooCommerce, REST API documentation, official documentation on the REST API and key generation (relevant for the manual path).