WooCommerce Integration

How It Works

Every order — and every status change — is pushed to WA Orbit in real time over a webhook. WA Orbit then sends the customer (or you, or both) a WhatsApp message for that event, including the invoice.

Step 1 — Connect Your Store

You connect with WooCommerce's built-in REST API keys — no coding required.

1. In WordPress admin, go to WooCommerce → Settings → Advanced → REST API and click Add key.
2. Give it a description, set permissions to Read/Write, and click Generate API key. Copy the Consumer key and Consumer secret.
3. In WA Orbit, open WooCommerce and click Connect. Enter your Store URL, Consumer key, and Consumer secret, then Test and Save.

On save, WA Orbit auto-registers the order webhooks on your store (order.created, order.updated, and more) and generates a unique webhook secret for your store.

Step 2 — Install the Companion Plugin (Recommended)

WooCommerce's REST webhooks can't send everything — notably the PDF invoice link and a few extra order fields. The optional WA Orbit companion plugin fills that gap.

1. On the WA Orbit WooCommerce screen, click Download plugin. The ZIP is pre-configured with your store's webhook URL and secret — nothing to edit.
2. In WordPress, go to Plugins → Add New → Upload Plugin, upload the ZIP, and Activate.

Step 3 — Arm Your Order Automations

On the WA Orbit WooCommerce screen, each event has its own row. Turn on the ones you want, pick the WhatsApp template, map the variables, and choose who it goes to.

Available Events

• Order lifecycle — order placed, processing, completed, on-hold, cancelled, refunded, failed.
• Cash on Delivery (COD) — COD confirm, COD → prepaid nudge, and risk scoring for suspicious orders.
• Back in stock — notify customers who joined a product's waitlist.
• Abandoned cart — multi-step recovery nudges.
• Win-back and review reward broadcasts.

Per-Event Settings

• Template — which approved message to send.
• Send to — customer, admin, or both (with an admin number).
• Delay — wait N seconds before sending (e.g. a 1-hour completed-order follow-up).
• Variable map — bind template placeholders to order fields.

Sending the Invoice

The headline of this integration: send the invoice on WhatsApp automatically when an order is placed or completed.

• Every order automation exposes the merge tag {{invoice_url}}. Put it in your template and WA Orbit fills it per order.
• It points to a real PDF invoice from your store's invoice plugin when one exists — or falls back to the customer's order page.
• Companion field invoice_is_pdf is 1 when the link is a direct PDF, 0 when it's the order page.

Order Variables

Alongside {{invoice_url}}, order automations expose the usual order fields — customer name, order number and total, currency, status, and the order URL. Map them to your template placeholders in the event's Variable map.

Verify It's Working

• Place a test order in WooCommerce (or move an existing order to a status you armed).
• Within a moment the customer number should receive the WhatsApp message with the invoice link.
• Check the WA Orbit WooCommerceactivity log — each received webhook and the message it triggered is recorded.

Troubleshooting

• No message on an order — confirm the event row is on and has a template selected, the store's webhook is still active, and the customer's phone number is present on the order.
• invoice_url shows the order page, not a PDF — install a PDF-invoice plugin and the WA Orbit companion plugin; without them WooCommerce has no invoice file to link to.
• Connection test fails — re-check the Store URL (must be reachable over HTTPS) and that the REST key permission is Read/Write.
• Duplicate messages — a status-change automation fires once per status; make sure you didn't arm both a generic and a per-status template for the same transition.