Tusher Ikbal

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


ZenCoupon AI Assistant

Generate and manage WooCommerce coupons using AI with natural language commands.

ZenCoupon AI Assistant vs Discount Rules and Dynamic Pricing for WooCommerce