About this plugin
ZenCoupon AI Assistant is a WordPress and WooCommerce plugin that helps store owners create, update, and manage coupons using simple AI-powered commands.
Instead of manually configuring every WooCommerce coupon field, store owners can type a plain-language instruction such as “Create a 20% coupon for Eid sale with minimum spend 1000”, and the plugin converts that command into WooCommerce-ready coupon data.
The plugin supports Groq, OpenAI/GPT, and Google Gemini, giving users flexibility to choose their preferred AI provider for coupon generation.
Key Features
- Create WooCommerce coupons using natural language commands
- Update existing coupons with AI-powered instructions
- Choose between Groq, OpenAI/GPT, and Google Gemini
- Select from curated AI models or enter a custom model name
- Save and manage provider API keys from the admin panel
- Test AI provider connection from plugin settings
- Generate coupon rules automatically
- View generated coupons from the admin dashboard
- Delete and manage coupons easily
- View recent activity inside the plugin panel
- Docs and support admin page
- Support form powered by wp_mail()
- WooCommerce HPOS compatibility
- REST API and JSON-RPC 2.0 style MCP endpoint for integration
Coupon Options Supported
ZenCoupon AI Assistant can create and manage many WooCommerce coupon settings, including:
- Coupon code
- Percentage discount
- Fixed cart discount
- Fixed product discount
- Expiry date
- Minimum spend
- Maximum spend
- Usage limit
- Usage limit per user
- Individual use only
- Free shipping
- Exclude sale items
- Email restrictions
- Product IDs
- Excluded product IDs
- Product categories
- Excluded product categories
Supported AI Providers
ZenCoupon AI Assistant supports three AI providers.
Groq AI
Groq is useful for fast responses and low-latency coupon command processing.
Recommended model:
- llama-3.1-8b-instant
OpenAI/GPT
OpenAI/GPT is useful for high-quality structured coupon output.
Default model:
- gpt-5.5
Other supported options:
- gpt-5.4-mini
- gpt-5.4-nano
Google Gemini
Google Gemini is useful for fast structured JSON responses.
Default model:
- gemini-2.5-flash
Requirements
- WordPress 5.0 or higher
- PHP 7.4 or higher
- WooCommerce 3.0 or higher
- Active API key from Groq, OpenAI, or Google Gemini
External Services
This plugin connects to external AI APIs to process natural language coupon commands and generate WooCommerce coupon configurations.
The plugin only sends the prompt entered by the admin user, such as coupon requirements, discount rules, expiry instructions, or campaign details. No customer personal data, order data, store financial data, or payment data is intentionally transmitted by the plugin.
Groq AI
Service provider: Groq, Inc.
Endpoint used:
com/openai/v1/chat/completions
Terms of Service:
com/terms-of-service/
Privacy Policy:
com/privacy-policy/
OpenAI
C.
Endpoint used:
com/v1/responses
Terms of Use:
com/policies/terms-of-use/
Privacy Policy:
com/policies/privacy-policy/
Google Gemini
Service provider: Google LLC.
Endpoint used:
com/v1beta/models/
Terms of Service:
com/terms
Privacy Policy:
com/privacy
Configuration
1. Get an API Key
Before using the plugin, you need an API key from at least one supported AI provider.
For Groq AI:
- Visit https://console.groq.com
- Create an account or sign in.
- Generate an API key.
- Copy the API key.
For OpenAI:
- Visit https://platform.openai.com
- Create an account or sign in.
- Generate an API key.
- Copy the API key.
For Google Gemini:
- Visit https://aistudio.google.com
- Create an account or sign in.
- Generate an API key.
- Copy the API key.
2. Configure the Plugin
- In your WordPress admin dashboard, go to ZenCoupon AI.
- Select your AI provider.
- Enter your provider API key.
- Choose a model or enter a custom model name.
- Click Save Settings.
- Use the Test Connection button to check your provider connection.
Usage
Creating Coupons with AI
- Go to WordPress Dashboard > ZenCoupon AI.
- Open the command console.
- Type your coupon instruction in natural language.
- Click the generate button.
- Review the generated coupon details.
- Create the coupon.
Example prompts:
- Create a 15% discount coupon for Summer Sale.
- Create BLACKFRIDAY coupon with 30% discount.
- Create a fixed 500 discount coupon with minimum spend 3000.
- Create a free shipping coupon for VIP customers.
- Update recent coupon to 20% discount.
- Create a coupon for category ID 12, expires on 2026-12-31.
Via REST API
0 compatible REST endpoint at:
POST /wp-json/zencoupon/v1/mcp
Creating a Coupon
`bash
com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
0”,
“id”: 1,
“method”: “create_coupon”,
“params”: {
“code”: “SAVE20”,
“amount”: 20,
“discount_type”: “percent”,
“expiry_date”: “2026-12-31”
}
}’
`
Listing Coupons
`bash
com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
0”,
“id”: 2,
“method”: “list_coupons”
}’
`
Listing AI-Generated Coupons
`bash
com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
0”,
“id”: 3,
“method”: “list_generated_coupons”
}’
`
Deleting a Coupon
`bash
com/wp-json/zencoupon/v1/mcp \
-H “Content-Type: application/json” \
-d ‘{
0”,
“id”: 4,
“method”: “delete_coupon”,
“params”: {
“coupon_id”: 123
}
}’
`
Coupon Parameters
Parameter
Type
Required
Description
code
string
Yes
Unique coupon code
amount
float
Yes
Discount amount
discount_type
string
Yes
percent, fixed_cart, or fixed_product
expiry_date
string
No
Date in YYYY-MM-DD format
minimum_amount
float
No
Minimum cart total
maximum_amount
float
No
Maximum cart total
exclude_sale_items
boolean
No
Exclude sale items from discount
individual_use
boolean
No
Allow the coupon to be used individually only
usage_limit
int
No
Total number of times the coupon can be used
usage_limit_per_user
int
No
Number of times each customer can use the coupon
free_shipping
boolean
No
Grant free shipping
email_restrictions
array
No
Allowed customer emails
product_ids
array
No
Specific product IDs
excluded_product_ids
array
No
Excluded product IDs
product_categories
array
No
Specific category IDs
excluded_product_categories
array
No
Excluded category IDs
API Response Examples
Success Response
`json
{
0”,
“id”: 1,
“result”: {
“coupon_id”: 123,
“code”: “SAVE20”,
“amount”: 20,
“discount_type”: “percent”,
”
}
}
`
Error Response
`json
{
0”,
“id”: 1,
“error”: {
“code”: -32600,
”
}
}
`
Security
ZenCoupon AI Assistant follows standard WordPress security practices.
- Direct file access is blocked with ABSPATH checks.
- Admin actions are protected with nonce verification.
- Capability checks are used for coupon and WooCommerce management.
- Input is sanitized before processing.
- REST API access is permission protected.
- API keys are stored in WordPress options.
- Support form submissions are sanitized and nonce protected.
- HTTPS is recommended for all API calls.
Troubleshooting
Missing API Key Error
This error usually means the selected AI provider does not have a saved API key.
Please check that you have:
- Generated an API key from your selected provider
- Entered the API key in the plugin settings
- Saved the settings successfully
API Returned HTTP 429 Error
This means the AI provider is rate-limiting your requests.
Possible solutions:
- Wait a few minutes and try again
- Switch to another AI provider
- Check your provider usage limit
- Upgrade your API plan if needed
Model Not Found Error
This usually means the selected model name is not available or has been deprecated.
Possible solutions:
- Choose a recommended model from the dropdown
- Enter a currently supported custom model name
- Switch to another AI provider
Invalid JSON Response Error
This means the AI provider returned an unexpected response format.
Possible solutions:
- Try the same prompt again
- Use a clearer coupon command
- Check your API key
- Try another AI provider
Performance Tips
- Use Groq for faster responses.
- Use OpenAI/GPT for high-quality structured output.
- Use Gemini Flash models for fast structured JSON responses.
- Use clear prompts for more accurate coupon generation.
- Keep temperature low for more consistent results.
- Monitor provider rate limits when generating many coupons.
Contributing
Contributions are welcome. Please fork the repository and submit a pull request.