WooCommerce Integration Guide
Connect your WordPress store to ZaLinkAI using REST API v3 and unlock AI-powered commerce capabilities.
API Key Setup
WooCommerce uses consumer key/secret authentication instead of OAuth. Generate credentials from WP Admin.
Open WP Admin
Navigate to your WordPress admin panel at yoursite.com/wp-admin. Go to WooCommerce > Settings > Advanced > REST API.
Generate API Keys
Click "Add key" and set a description (e.g., "ZaLinkAI"). Select a user with admin privileges and set permissions to Read/Write.
Copy Credentials
Copy the Consumer Key and Consumer Secret. These are shown only once. ZaLinkAI encrypts them with AES-256 before storage.
Enter in ZaLinkAI
Paste the consumer key, consumer secret, and your store URL into the ZaLinkAI onboarding form. Connection is verified instantly.
REST API v3 Capabilities
Everything AI agents can accomplish through the WooCommerce REST API v3 connector.
Product Management
- Simple and variable product support
- Product variations with attributes
- Category hierarchies and tags
- Image gallery management
Order Processing
- Create, read, and update orders
- Order notes for internal communication
- Fulfillment and tracking updates
- Refund processing via API
Coupons & Discounts
- Create and validate coupons
- Percentage and fixed-amount discounts
- Usage limits and expiry dates
- Free shipping coupon support
Customer Data
- Customer profiles and addresses
- Purchase history and order count
- Guest checkout customer handling
- Customer notes and metadata
Variable Products & Coupons
WooCommerce excels at complex product structures and flexible promotions.
Variable products with unlimited attributes (size, color, material, etc.).
Each variation can have its own price, SKU, stock level, and image.
Coupons support percentage, fixed cart, and fixed product discount types.
Coupon restrictions include minimum spend, product/category exclusions, and usage caps.
AI agents can validate coupons and calculate discounts in real-time during conversations.
WordPress Requirements
Minimum environment needed for a reliable ZaLinkAI connection.
WordPress
6.0+
WooCommerce
8.0+
PHP
8.1+
REST API
Enabled (default)
Permalinks
Pretty permalinks (not Plain)
SSL
HTTPS required for API key auth
Troubleshooting
Common issues and resolutions for the WooCommerce integration.
woocommerce_rest_authentication_error
Consumer key or secret is invalid or was regenerated.
Generate new API keys in WP Admin > WooCommerce > Settings > Advanced > REST API. Update credentials in ZaLinkAI.
401 Unauthorized (SSL)
HTTP used instead of HTTPS for API key authentication.
WooCommerce requires HTTPS for consumer key/secret auth. Ensure your site has a valid SSL certificate.
rest_no_route
WooCommerce REST API is disabled or permalinks are set to "Plain".
Enable pretty permalinks in WP Admin > Settings > Permalinks. Choose any option except "Plain".
product_variations_not_found
Variable product exists but has no variations configured.
In WP Admin, go to the product editor and add variations under the "Variations" tab. Save and publish.