WooCommerce Integration

CraftChat integrates deeply with WooCommerce to deliver product-aware conversations. When enabled, the AI can answer questions about product details, pricing, availability, shipping options, and even recommend products based on visitor intent.

WooCommerce integration is available on the Business plan and above. You need WooCommerce 7.0 or later installed and activated.

Enabling the Integration

1. Navigate to CraftChat → Integrations in your WordPress admin.
2. Locate the WooCommerce card and click Enable.
3. CraftChat will request read access to your WooCommerce product data through the WooCommerce REST API. Click Approve when prompted.
4. Once approved, CraftChat begins its initial product sync. This typically takes 1–3 minutes for stores with up to 1,000 products.

You can verify the integration status at any time on the Integrations page. A green checkmark indicates that the sync is active and up to date.

Synced Data

When the WooCommerce integration is active, CraftChat syncs the following data from your store:

Products

• Product name and slug
• Short description and full description
• Regular price and sale price
• SKU
• Product images (URL and alt text)
• Product URL
• Product status (published, draft, etc.)

Categories & Tags

• Category name, slug, and hierarchy (parent/child)
• Tag name and slug
• Category descriptions

Variations

For variable products, CraftChat indexes each variation individually:

• Variation attributes (size, color, etc.)
• Variation-specific pricing
• Variation-specific stock status
• Variation SKU

Stock & Inventory

• Stock status (in stock, out of stock, on backorder)
• Stock quantity (if "Manage stock" is enabled)
• Low stock threshold

Stock data is synced in near-real-time. When a customer completes a purchase and stock changes, CraftChat receives a webhook notification and updates its data within 60 seconds.

Shipping

• Shipping zones and methods
• Flat rate, free shipping, and local pickup configurations
• Shipping class assignments per product

The AI uses shipping data to answer questions like "How much is shipping to Tokyo?" or "Do you offer free shipping?"

Configuration Options

Fine-tune the WooCommerce integration from CraftChat → Integrations → WooCommerce Settings:

Product Recommendation Settings

CraftChat can proactively suggest products during conversations based on visitor intent. This feature uses semantic matching to find the most relevant products.

Recommendation Modes

• Passive (default) — The AI mentions relevant products only when the visitor’s question directly relates to products (e.g., "Do you have wireless headphones?").
• Active — The AI suggests related products proactively when it detects purchase intent, even if the visitor didn’t ask about a specific product.
• Disabled — The AI never suggests products. Useful if you want the chatbot to handle support only.

Recommendation Display

When the AI recommends products, it can display them in two formats:

• Text link: A simple hyperlinked product name within the chat message.
• Product card: A rich card showing the product image, name, price, and a "View Product" button. Up to 3 cards are displayed per message.

Maximum Products per Response

Controls how many products the AI can recommend in a single response. Default is 3, maximum is 5. Setting this too high can make responses feel spammy.

Conversation Examples

Here are examples of how CraftChat handles WooCommerce-aware conversations:

Product Inquiry

Visitor: "How much is the Premium Wireless Headset?"

CraftChat: "The Premium Wireless Headset is currently priced at $149.99
(regular price $199.99 — that's 25% off!). It's in stock and ships
within 1-2 business days. Would you like to know more about its
features, or shall I help you with anything else?"

[Product Card: Premium Wireless Headset - $149.99 - View Product]

Stock Availability

Visitor: "Do you have the Blue Running Shoes in size 10?"

CraftChat: "Let me check that for you. The Blue Running Shoes are
available in size 10 with 3 pairs currently in stock. The price is
$89.99 with free shipping on orders over $50. Here's a direct link
to the product page where you can add it to your cart."

[Product Card: Blue Running Shoes (Size 10) - $89.99 - View Product]

Shipping Question

Visitor: "What are your shipping options?"

CraftChat: "We offer the following shipping methods:

• Standard Shipping (5-7 business days): $5.99
• Express Shipping (2-3 business days): $12.99
• Free Shipping: Available on all orders over $50

Delivery times are estimated from the date of shipment. All orders
are processed within 1 business day. Is there anything else I can
help you with?"

Product Comparison

Visitor: "What's the difference between the Standard and Pro plan?"

CraftChat: "Here's a quick comparison of our Standing Desk models:

Standard Standing Desk ($399):
• Manual height adjustment
• Weight capacity: 150 lbs
• 1-year warranty

Pro Standing Desk ($699):
• Electric height adjustment with memory presets
• Weight capacity: 300 lbs
• 5-year warranty
• Built-in cable management

Both are in stock and ship free. Would you like more details on
either model?"

[Product Card: Standard Standing Desk - $399]
[Product Card: Pro Standing Desk - $699]

Troubleshooting

Products not appearing in chat responses

• Verify the WooCommerce integration is enabled and showing a green status on the Integrations page.
• Check that the products are published (not draft or private) unless you have enabled "Include Draft Products."
• Trigger a manual product sync from CraftChat → Integrations → Sync Now.
• Ensure your WooCommerce REST API is accessible. Some security plugins block REST API access by default.

Incorrect pricing displayed

• CraftChat syncs prices as they are configured in WooCommerce. Verify that the product’s regular price and sale price are set correctly in WooCommerce.
• Check the "Price Display" setting to ensure it matches your preferred tax display option (including vs. excluding tax).
• If using dynamic pricing plugins, note that CraftChat syncs the base price. Customer-specific or role-based pricing may not be reflected.

Stock status out of date

• If using real-time sync, ensure the WooCommerce webhook is firing correctly. Go to WooCommerce → Settings → Advanced → Webhooks and verify the CraftChat webhook shows a "200" delivery status.
• If the webhook shows errors, check that your server can reach api.craftchat.net on port 443.
• As a fallback, switch the sync frequency to "Hourly" if real-time webhooks are unreliable on your hosting.

WooCommerce REST API blocked

Some security plugins (Wordfence, iThemes Security, etc.) block REST API access for unauthenticated users. CraftChat uses authenticated API keys, but you may need to:

1. Allow-list the CraftChat application password in your security plugin.
2. Ensure the /wp-json/wc/v3/ endpoint is accessible. You can test by visiting https://your-site.com/wp-json/wc/v3/products directly (you should see a JSON response or an authentication error, not a 403 or 404).