Guide

WooCommerce integration

How to connect a WooCommerce/WordPress store to Vigent: plugin install, webhook setup, and product/order sync.

Connecting WooCommerce to Vigent keeps your store’s product catalog and orders in sync automatically. The agent can read live prices, stock, and product details, and every new order is attached to the matching contact profile. Setup is now simpler than ever: just enter your site URL and Vigent auto-generates the webhook link and secret for you.

Two connection modes

Vigent supports two connection modes. “Webhook-only” (the default and simplest) where the WordPress plugin pushes data to Vigent in real time without needing REST API keys. “Full sync” mode where, in addition to webhooks, Vigent polls your store every 30 minutes to catch any changes that missed the webhook — this mode requires WooCommerce Consumer Key/Secret.

What this integration does

Products: creating/editing/deleting a product in WooCommerce is mirrored in the Vigent catalog instantly (with automatic re-embedding for semantic search).
Orders: an order status change (e.g. to “Processing” or “Completed”) creates a StoreOrder record and links it to the matching contact by phone/email.
Manual sync: hit “Refresh products” any time on the products page to re-fetch the full product list and recent orders (in full mode).

Prerequisites

You need WordPress 5.8+ and admin access to install the plugin. If WooCommerce 6+ is installed, products and orders sync too; otherwise only site content syncs. For “full sync” mode you also need WooCommerce Consumer Key/Secret (from WooCommerce → Settings → Advanced → REST API).

Step 1 — Create the integration in Vigent (auto-generated link & key)

Go to the “Products” page in the Vigent dashboard. At the top you’ll see a WooCommerce connection card. Click “Connect WooCommerce”, enter your site URL, and click “Create integration”. Vigent auto-generates a webhook URL and a random secret, and shows both with copy buttons.

Important: you don’t need to enter Consumer Key/Secret at this stage. Those keys are only needed if you want Vigent to poll your store every 30 minutes. For initial setup and real-time data, webhook-only mode is enough.

Step 2 — Install the WordPress plugin

1Download the plugin zip from the Vigent panel (Products or Integrations page) or from /downloads/vigent-wordpress.zip.
2In WordPress go to “Plugins → Add New → Upload Plugin” and upload vigent-woo.zip.
3Activate the plugin. A new top-level “Vigent” menu appears in the WordPress admin sidebar (not under WooCommerce).
4Go to “Vigent → Settings” and paste the webhook URL and webhook secret you copied from the Vigent panel.
5Hit “Save settings” then “Test connection”. The plugin sends a sample ping to Vigent to confirm the link works.

Step 3 — Initial sync

After a successful test, go to the “Sync” tab in the plugin and click “Send all products” (then orders and content) to push all current data to Vigent once. For large stores this can take a few minutes. After that, every product/order change is pushed to Vigent instantly via the webhook.

Note: if your host restricts outgoing webhooks, make sure vigent.ir is on the allow-list. Otherwise the plugin cannot push to Vigent and (in full mode) only the pull sync will work.

Step 4 — Verify in the Vigent panel

Back on the “Products” page in the Vigent panel you should see the connection status change to “Connected”, the sync checklist fill in, and the product list update. If any errors occur, they appear in the same card. You can also run a manual sync with the “Refresh products” button.

Step 5 (optional) — Enable full sync

If you want Vigent to also poll your store every 30 minutes (in addition to webhooks), enter your WooCommerce Consumer Key/Secret in the Vigent panel. To create these keys: in WordPress go to WooCommerce → Settings → Advanced → REST API, click “Add key”, choose “Read/Write” permission, and copy the keys. Then enter them in the Vigent panel (Integrations section).

Troubleshooting

Fatal error: Call to undefined method ... Order::get_billing() — this happened in older plugin versions. Update to plugin version 2.0.0 or higher.
401 error (woocommerce_rest_cannot_view) in the Vigent panel? This happens in poll mode and is caused by wrong/missing Consumer Key/Secret. Recreate the keys in WooCommerce and update them in the Vigent panel, or switch to webhook-only mode which doesn’t need them.
Products not showing in Vigent? Make sure the plugin is active, the webhook URL and secret are correct, and you’ve run a full sync. To check, hit “Test connection” in the plugin.
Orders not linking to contacts? The order phone/email must match the field stored on the Vigent contact profile (0 and 98+ normalization is supported).
No log rows in the panel? After “Test connection” in the plugin, a log row should appear in the Vigent panel immediately. If not, the webhook URL is likely wrong or the host is blocking outgoing requests.

Best practice: after any major WooCommerce upgrade, run a “Full sync” once to make sure no product was left behind.