WooCommerce Integration

Overview

TotalApp's WooCommerce integration gives you two distinct capabilities: data retrieval via the WooCommerce REST API and real-time event triggering via inbound webhooks. You can use them independently or combine them in a single workflow — for example, trigger on order.created, fetch enriched order details, then send a fulfilment notification.

Prerequisites

• A self-hosted or WooCommerce.com store running WooCommerce 3.5+
• WordPress user with Administrator role (required to create REST API keys)
• HTTPS enabled on the store — WooCommerce refuses REST API and webhook requests over plain HTTP
• For inbound webhooks: the TotalApp server must be publicly reachable (automatic on production; use ngrok for local development)

Setting Up the REST API Connection

The REST API connection allows TotalApp to fetch store data (orders, products, customers, coupons) on demand. Configure it once and all data nodes share the same credentials.

Available Data Nodes

All four nodes appear under Ecommerce → WooCommerce in the palette. They act as data sources — drag, configure, then connect to downstream nodes.

Inbound Webhook Triggers

Webhook trigger nodes let your workflow react to store events the moment they happen — no polling, no cron jobs. When WooCommerce fires a webhook (e.g. a new order is placed), TotalApp receives it immediately and executes only the downstream nodes connected to the matching trigger node.

How it works

TotalApp uses a Server-Sent Events (SSE) bridge: the server receives the incoming webhook POST and immediately forwards it to the open browser session via a persistent SSE connection. The Workflow Editor picks up the event and runs the subgraph starting from the matching trigger node — other trigger nodes on the same canvas are unaffected.

Setting up a WooCommerce Webhook Trigger node

Supported webhook topics

Accessing the Webhook Payload

When a WooCommerce webhook fires, the raw payload (the full WooCommerce object — order, product, customer, etc.) is passed to all nodes downstream of the trigger node. You can access it in a Script node via the input variable:

// input.topic — e.g. "order.created"
// input.payload — the full WooCommerce object

const order = input.payload;
const total = order.total;
const customerEmail = order.billing.email;
const lineItems = order.line_items.map(i => i.name).join(', ');

return `New order #${order.number} from ${customerEmail}: ${lineItems} — £${total}`;

The payload structure follows the WooCommerce REST API v3 schema for the corresponding resource type.

Local Development with ngrok

WooCommerce requires the delivery URL to be publicly accessible over HTTPS. When running TotalApp locally (dev server on port 3000), use ngrok to expose it:

ngrok http --url=<your-static-domain>.ngrok-free.app 3000

Then set the WooCommerce webhook delivery URL to:

https://<your-static-domain>.ngrok-free.app/api/webhooks/woocommerce

For production, change the delivery URL to https://app.totalapp.app/api/webhooks/woocommerce — no ngrok needed, as the Render deployment is publicly reachable.

Connection Status Panel

The WooCommerce Integration screen (Ecommerce → WooCommerce) shows a live connection status panel with:

• Connection badge — green "Connected" when credentials are valid, red "Disconnected" otherwise
• Live stats — product count, order count, customer count fetched from the REST API at connect time
• Recent orders — a live table of the 10 most recent orders with status badges and order totals
• Disconnect button — removes saved credentials from TotalApp (does not delete anything in WooCommerce)

Example Workflows

New order → Slack notification

Fires the moment an order is placed. The Script node extracts input.payload.billing.email, input.payload.total, and line item names, then formats them into a Slack message.

Low stock alert → Email

Triggers on any product save. The Script node checks input.payload.stock_quantity; if it falls below a threshold, it returns a message — otherwise returns null to stop execution. Connect a downstream Send Email node for the alert.

Daily order export

Runs at 08:00 every day. Fetches all processing orders, formats them as CSV in a Script node, and emails the result. Uses the REST API data node — no webhook required.

New customer → CRM sync

Fires when a new account is registered. Maps WooCommerce customer fields to your CRM's schema in a Script node, then sends the data via an HTTP Request node.

Workflow Editor — WooCommerce Nodes

Every WooCommerce node lives in the Workflow Editor (Automation → Workflow Editor). Open the node palette on the left, expand Ecommerce, and you will see three sub-groups: Triggers, Shopify, and WooCommerce. Drag any node onto the canvas and wire it to downstream nodes to build real-time automations without writing code.

Node Palette — Ecommerce section

The palette screenshot below shows the exact layout: the Triggers group contains both the Shopify Webhook and WooCommerce Webhook nodes (blue dot, ec-triggers category). The WooCommerce group holds the four REST API data nodes (purple dot, ec-woocommerce category).

What you can connect to a trigger

A WooCommerce Webhook node is the start of a chain. Any node in the palette can be connected downstream — here are the most powerful combinations:

Frequently Asked Questions