外掛標籤
開發者團隊
原文外掛簡介
ZenCoupon AI Assistant is a powerful WordPress plugin that integrates with WooCommerce and AI providers to help you generate and manage coupons using simple, natural language commands.
External Services
This plugin connects to external AI APIs (Groq and Google Gemini) to process natural language commands and generate WooCommerce coupon configurations.
Data Sent: User-provided natural language prompts describing coupon requirements. No user personal data, customer data, or store financial data is transmitted.
Groq AI: Service provided by Groq, Inc. Endpoint: https://api.groq.com/openai/v1/chat/completions. Terms of Service | Privacy Policy
Google Gemini: Service provided by Google LLC. Endpoint: https://generativelanguage.googleapis.com/v1beta/models/. Terms of Service | Privacy Policy
Features
AI-Powered Coupon Generation: Create coupons using natural language instructions
Multiple AI Providers: Support for Groq and Google Gemini AI. Currently working with Groq AI only, others will be added soon.
Easy Management: List, delete, and manage your AI-generated coupons
Flexible Discount Types: Percent or fixed amount discounts
Advanced Settings:
Minimum/Maximum cart amounts
Product and category restrictions
Email restrictions
Usage limits per user
Free shipping options
Expiration dates
Exclude sale items
Individual use settings
HPOS Compatible: Full support for WooCommerce High-Performance Order Storage
REST API: JSON-RPC 2.0 compatible API for integration
Supported AI Providers
Groq AI (Recommended for speed)
* Model: llama3-8b-8192
* Fast inference with excellent accuracy
Requirements
WordPress 5.0 or higher
PHP 7.4 or higher
WooCommerce 3.0 or higher
Active API key from Groq or Google Gemini
From WordPress Plugin Directory
Go to Plugins > Add New in your WordPress admin
Search for “ZenCoupon AI Assistant”
Click Install Now and then Activate
Manual Installation
Download the plugin as a ZIP file
Go to Plugins > Add New > Upload Plugin
Choose the ZIP file and click Install Now
Click Activate Plugin
Configuration
1. Get API Keys
For Groq AI:
* Visit console.groq.com
* Create an account or sign in
* Generate an API key
2. Configure Plugin
In WordPress admin, go to WordPress Dashboard > ZenCoupon AI
Select your preferred AI provider (Groq or Gemini)
Enter your API key
(Optional) Change the model name
Click Save Settings
Usage
Via REST API
The plugin provides a JSON-RPC 2.0 compatible REST endpoint at:
POST /wp-json/zencoupon/v1/mcp
Creating a Coupon
`bash
curl -X POST https://yoursite.com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
“jsonrpc”: “2.0”,
“id”: 1,
“method”: “create_coupon”,
“params”: {
“code”: “SAVE20”,
“amount”: 20,
“discount_type”: “percent”,
“expiry_date”: “2026-12-31”
}
}’
Listing Coupons:
curl -X POST https://yoursite.com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
“jsonrpc”: “2.0”,
“id”: 2,
“method”: “list_coupons”
}’
Listing AI-Generated Coupons:
curl -X POST https://yoursite.com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
“jsonrpc”: “2.0”,
“id”: 3,
“method”: “list_generated_coupons”
}’
Deleting a Coupon:
curl -X POST https://yoursite.com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
“jsonrpc”: “2.0”,
“id”: 4,
“method”: “delete_coupon”,
“params”: {
“coupon_id”: 123
}
}’
Coupon Parameters ===ParameterTypeRequiredDescriptioncodestring✓Unique coupon codeamountfloat✓Discount amountdiscount_typestring✓percent, fixed_cart, or fixed_productexpiry_datestringDate in YYYY-MM-DD formatminimum_amountfloatMinimum cart totalmaximum_amountfloatMaximum cart totalexclude_sale_itemsbooleanExclude sale items from discountindividual_usebooleanUse coupon only onceusage_limitintTotal times coupon can be usedusage_limit_per_userintTimes per customerfree_shippingbooleanGrant free shippingemail_restrictionsarrayAllowed customer emailsproduct_idsarraySpecific product IDsexcluded_product_idsarrayExcluded product IDsproduct_categoriesarraySpecific category IDsexcluded_product_categoriesarrayExcluded category IDs
Troubleshooting
“Missing API Key” Error
Solution: Ensure you have:
Generated an API key from your chosen AI provider
Entered it in the plugin settings
Saved the settings
“API returned HTTP 429” (Rate Limited)
Solution:
The AI provider is rate-limiting your requests
The plugin will automatically retry with exponential backoff
If it persists, try switching AI providers or wait a few minutes
Consider upgrading your API plan with the provider
“Model not found” Error
Solution:
The model name may be deprecated
The plugin auto-updates deprecated models to current versions
Try switching between Groq and Gemini to find a working option
“Invalid JSON Response” Error
Solution:
The AI model returned unexpected format
This is usually temporary – try again
If persistent, check your API key validity
Consider using a different AI provider
API Response Examples
Success Response
{
“jsonrpc”: “2.0”,
“id”: 1,
“result”: {
“coupon_id”: 123,
“code”: “SAVE20”,
“amount”: 20,
“discount_type”: “percent”,
“message”: “Coupon created successfully.”
}
}
Error Response
{
“jsonrpc”: “2.0”,
“id”: 1,
“error”: {
“code”: -32600,
“message”: “Coupon code is required.”
}
}
Security
All API keys are stored encrypted in WordPress options
REST endpoint requires manage_shop_coupons or manage_woocommerce capability
Only authenticated users with proper permissions can access the API
HTTPS is recommended for all API calls
Performance Tips
Use Groq AI for faster responses (recommended)
Set lower temperatures (0.0-0.3) for more consistent results
Batch operations when creating multiple coupons
Monitor rate limits and adjust request frequency
Contributing
Contributions are welcome! Please fork the repository and submit a pull request.
1.0.1
Fixed unique prefix constraints and refactored plugin structure.
Updated text domain to match plugin slug.
Added missing external services disclosure for Groq and Gemini.
1.0.0
Initial release
Groq AI integration
WooCommerce HPOS support
REST API endpoint
Coupon management features
