Digital Employees – WooCommerce Subscriptions

A module plugin for Digital Employees that adds WooCommerce Subscriptions integration. Provides subscription API tools for Digital Employee AI assistants.

Requirements

• Digital Employee Framework - Core (active)
• WooCommerce (active)
• WooCommerce Subscriptions (active)
• WordPress 6.2+ / PHP 8.0+

Installation

1. Download the latest release zip from the button above
2. In WordPress admin: Plugins → Add New → Upload Plugin → select the zip
3. Activate the plugin
4. The /tools/wc/subscriptions endpoint registers automatically when all dependencies are active

What It Does

When a customer interacts with a Digital Employee (via Customer Chat, Staff AI, or any channel), the AI can retrieve their WooCommerce subscription data:

• Active subscriptions with status, dates, and pricing
• Parent order and full renewal history
• Total spend across all subscription orders
• Product names and currency

Results are cached for 7 days with automatic invalidation on subscription status changes, date updates, renewals, and payment events.

API Endpoint

GET /wp-json/a3-ai/v1/tools/wc/subscriptions

Returns subscriptions for the authenticated user (JWT required).

{
  "success": true,
  "total_subscriptions": 1,
  "subscriptions": [
    {
      "id": 123,
      "status": "active",
      "start_date": "2026-01-01 12:00:00",
      "next_payment": "2026-02-01T12:00:00+00:00",
      "total": "29.99",
      "currency": "USD",
      "products": ["Premium Plan"],
      "parent_order": { "id": 456, "status": "completed", "total": "29.99" },
      "renewal_orders": [{ "id": 789, "status": "completed", "total": "29.99" }],
      "renewal_count": 1,
      "total_spent": "59.98"
    }
  ]
}

Why a Separate Plugin?

WooCommerce Subscriptions is a commercial plugin that not all def-core users will have. Per the Module Development Guide, integrations for commercial plugins are built as separate modules rather than bundled into def-core.

This plugin follows the same DEF_Core_Tool_Base pattern as def-core's built-in tools — it just ships independently.

Development

See the Module Development Guide for the full module architecture, base class API, and conventions.

License

GPLv2 or later. See LICENSE.