WooCommerce Setup

Connecting WooCommerce gives your agent access to your store’s order and product data. When a customer emails asking about an order or product, your agent can pull up live data from your store and include it in its reply.

What your agent can do with WooCommerce

• Look up orders and order status by customer email
• Get fulfillment and tracking information
• View customer profiles and order history
• Search products and check availability
• Browse product categories and collections
• Cancel orders on customer request
• Handle “where is my order” inquiries end to end

Prerequisites

• A WordPress site with WooCommerce installed and active
• Admin access to your WordPress dashboard
• Your site must be publicly accessible (not behind a firewall or localhost)
• A Know Reply workspace on a plan that includes integrations

Step 1: Generate API keys in WooCommerce

1. Log in to your WordPress admin dashboard
2. Go to WooCommerce > Settings in the left sidebar
3. Click the Advanced tab at the top
4. Click REST API (a sub-tab under Advanced)
5. Click Add key
6. Fill in the details:
   • Description: Enter a name like “Know Reply integration”
   • User: Select your admin user (or a user with appropriate permissions)
   • Permissions: Select Read/Write if you want the agent to cancel orders. Select Read if you only want order and product lookups.
7. Click Generate API key
8. Copy both the Consumer Key and Consumer Secret immediately. WooCommerce only shows the Consumer Secret once. If you lose it, you will need to create new keys.

The Consumer Key starts with ck_ and the Consumer Secret starts with cs_.

Step 2: Note your site URL

Your site URL is the base URL of your WordPress/WooCommerce store, including https://. For example: https://yourstore.com

Use the same URL you see when visiting your store’s homepage. Do not include trailing slashes or paths like /shop.

Step 3: Enter credentials in Know Reply

1. Go to Dashboard > Toolkit
2. Find WooCommerce in the list of available integrations
3. Enter your Site URL (e.g., https://yourstore.com)
4. Paste your Consumer Key (starts with ck_)
5. Paste your Consumer Secret (starts with cs_)
6. Click Connect Now
7. You should see a green indicator confirming the connection

Step 4: Configure capabilities

After connecting, review the list of enabled functions. If you want the agent to only look up data, disable write capabilities like order cancellation.

Step 5: Test the connection

1. Go to Dashboard > Simulator
2. Send a test message like “What is the status of my order?” from an email address that matches a customer in your store
3. The agent should call the WooCommerce integration and return order information

Common issues

“WooCommerce site URL, consumer key, and consumer secret are required” error All three fields are required. Make sure you have entered the full site URL including https://, the Consumer Key, and the Consumer Secret.

Connection timeout or “could not connect” errors Your WordPress site needs to be publicly accessible over HTTPS. If your site is behind a firewall, on a local network, or using a self-signed certificate, the API calls will fail. Make sure your site has a valid SSL certificate and is reachable from the internet.

401 Unauthorized or “Invalid signature” errors This usually means the Consumer Key or Consumer Secret is wrong. Generate a new pair of API keys in WooCommerce and try again. Also verify that the keys were created with the correct permissions (Read or Read/Write).