WooCommerce setup
Install the checkout plugin, connect your store, verify checkout events and choose them in a campaign.
Connect WooCommerce as a VYG data source to receive order, customer and checkout events. Checkout capture requires the VYG AI Checkout for WooCommerce WordPress plugin. Install it once, then VYG configures its checkout webhook when you check the connection.
You need access to your store's WordPress admin with permission to install and activate plugins, and access to Settings → Data sources in VYG. WooCommerce must be active on the store.
Install the checkout plugin
- Download the checkout plugin ZIP.
- Open your store's WordPress admin and go to Plugins → Add New Plugin → Upload Plugin.
- Choose the ZIP, click Install Now, then Activate Plugin.
- Confirm that VYG AI Checkout for WooCommerce is active on the Plugins page.
Keep the ZIP intact when uploading it. You do not need to paste a script into your theme or install the VYG browser pixel. The plugin loads its checkout script on WooCommerce cart and checkout pages. It supports both classic pages and Cart and Checkout Blocks.
Connect the store
- From the VYG homepage, open Settings → Data sources.
- Click Add data source, choose WooCommerce, and enter your store's HTTPS URL.
- Continue to WooCommerce, sign in to your store if needed, and approve access for VYG AI.
- Return to VYG and open the new WooCommerce data source.
- In Checkout capture, click Check setup after activating the plugin.
If the store is already connected, open that existing data source and click Check setup after installation. You do not need to add a second data source.
VYG detects the active plugin and configures its checkout webhook with this data source's webhook URL and signing secret. It also sets up the Checkout updated event. You do not need to copy the URL or secret into WordPress. The signing secret stays on the servers and is never sent to a shopper's browser.
Verify a checkout update
The setup result confirms configuration. Use a real checkout interaction to confirm that events are arriving.
- Open the store in a separate browser session and add a product to the cart.
- Open checkout, enter a test email address or phone number that you control, and change a checkout field or cart item. You do not need to place an order.
- In VYG, open the WooCommerce data source's Events tab and look for Checkout updated.
- Open Activity and select the new event to inspect its contact details, checkout total and items.
- Return to Overview to see the received-event count and latest activity.
Checkout updates include the available email or phone, a checkout ID, the event time, cart items, total and checkout URL. Anonymous cart changes without a usable email or phone do not identify a customer for a campaign.
Use the event in a checkout campaign
- Open Campaigns in VYG and create a campaign with a customer event trigger.
- In the event picker, choose Checkout updated under the connected WooCommerce data source.
- Configure the campaign's timing, messages and eligibility conditions, then save it as a draft.
- Review the campaign and test it before activating it.
A checkout update means the shopper changed their cart or checkout. It does not mean they abandoned the checkout. The plugin sends updates as shoppers interact with the store; it does not wait for an abandonment timer or schedule recovery messages. Configure the campaign to match the recovery timing you want.
The checkout URL is the store's normal checkout page. It does not restore a cart on another device.
Discount codes
When a campaign is triggered by this data source, VYG creates its unique discount codes as WooCommerce coupons on your store. It uses the read/write access you approved when you connected the store.
- Each code is created for one conversation. Codes start with
LR-unless the discount uses a custom prefix. WooCommerce shows codes in lowercase. Shoppers can type them in any case. - A coupon is single use unless the discount sets a different usage limit. Percentage, fixed amount and free shipping discounts are supported, with minimum spend, expiry, once per customer and combination settings. Buy X get Y and minimum quantity discounts are not supported.
- Amounts use your store's base currency.
- The same applies to discount codes that agents send from the inbox for these campaigns.
- If the data source is disabled, or its store cannot create coupons, the message is sent without a code. VYG never creates the code on another store connected to your brand.
Purchase attribution
A new WooCommerce connection credits purchases from the Order paid event, with these attribution fields already set:
| Field | Value |
|---|---|
| Total amount | total |
| Status | status |
| Allowed statuses | processing, completed |
| Discount codes | coupon_lines[].code |
| Link tracking | meta_data[].value matches source LiveRecover and medium SMS |
coupon_lines[].code reads the code from every coupon on the order. An order that uses an LR- code
or the LiveRecover SMS link tracking is credited to the shopper's most recent recovery conversation
within the attribution window.
Pending, on-hold, failed, cancelled and refunded orders are not counted.
Walkthrough
Connection walkthrough (access required)
The recording begins after plugin installation. It shows navigation from the homepage, store approval, the connected data source's Overview, Events and Activity tabs, and selection of the WooCommerce event in a new campaign. Follow the installation steps above before using the recording.
Troubleshooting
| What you see | What to check |
|---|---|
| The plugin is not detected | Confirm that the plugin and WooCommerce are active on the same store you connected, then click Check setup again. |
| The connection cannot check the store | Confirm that the store is reachable over HTTPS and that its security rules allow the WooCommerce API. Reconnect if its approved API access was revoked. |
| Setup succeeds but no checkout event appears | Test on a cart or checkout page, provide a usable email or phone, and make a change. Check that the data source is enabled and the WooCommerce webhook has no delivery errors. |
| The event picker has several WooCommerce sources | Choose Checkout updated under the data source connected to the store you want to use. |
See Data sources in the app for the event inspector and Errors and retries for webhook delivery responses.