Skip to content
Contlo by QuestionPro
Browse documentation

WooCommerce

The Contlo for WooCommerce plugin links your WordPress store to your Contlo account. Contlo imports your products, customers and orders, keeps them up to date, and tracks carts and checkouts on your storefront, so you can recover abandoned checkouts, follow up after a purchase and bring customers back for the next order.

Get started → Connect your store → Woo CommercePlugin for WordPressProducts, customers and ordersCart and checkout tracking

Before you start

  • A Contlo account, signed in on the same browser you use for WordPress.
  • A WordPress site running WooCommerce 2.2 or later on PHP 5.6 or later. The plugin is compatible with WooCommerce High-Performance Order Storage (HPOS).
  • A WordPress administrator login. Only administrators see the Contlo menu and can approve the connection.
  • Your store must be reachable over HTTPS, because Contlo reads your store data and receives updates over secure connections.

Connect your store

The connection has two halves: you install the plugin in WordPress, then you approve access so Contlo can read your store. The platform choice at the start is covered in Connect your store.

  1. In Contlo, choose Woo Commerce as your platform, enter your store URL (for example www.yourstoreurl.com) and continue. If you see Invalid Shop Domain, check the address for typos.
  2. On the Connect to your Woo Commerce store page, click Download ZIP file under Step 1: Download Contlo plugin for WooCommerce and download the plugin.
  3. Under Step 2: Upload and activate Contlo plugin on WooCommerce, click Go to WooCommerce. Your store's plugin page opens in WordPress. Upload the ZIP file, then install and activate the plugin.
  4. In WordPress, open the new Contlo item in the admin menu and click Connect your account. Contlo opens in a new tab. Sign in if asked.
  5. WooCommerce asks you to approve access for Contlo App with read and write permission. Click Approve.
  6. You return to Contlo. Under Step 3: Verify Contlo plugin setup on WooCommerce, click Verify setup.

When the connection works you see Successfully connected to WooCommerce and Contlo takes you to Home. In WordPress, the Contlo page changes to You are connected to Contlo with a Go to Contlo button.

What Contlo is allowed to do

Approving the connection gives Contlo read and write access to the WooCommerce REST API for your store. Contlo uses it to:

  • Read your products, customers and orders.
  • Read your store address, which sets your business address in Contlo.
  • Create and manage its own webhooks, so WooCommerce tells Contlo when something changes.

The webhooks appear in WooCommerce under Settings → Advanced → Webhooks with names that start with Contlo:, such as Contlo: Order Created. Don't delete or pause them. Contlo checks them every day and restores any that are missing or inactive.

The first sync

Right after you connect, Contlo imports your existing store data in this order. There is nothing to start by hand.

OrderWhat is importedWhere you see it
1Products, including variationsProduct pickers in emails and automations, product feeds
2CustomersAudience → contacts
3Orders, with their full historyContact timelines, segments, revenue reports, RFM and cohorts

Contlo also adds a set of starter segments to Audience so you can send your first campaign sooner. A large store takes longer to import. Orders arrive last, so revenue numbers and order-based segments keep filling in until the import finishes.

What stays in sync

After the first import, WooCommerce notifies Contlo each time one of these changes.

In WooCommerceIn Contlo
Customer created or updatedThe contact is created or updated with name, email, phone number and address.
Customer deletedThe matching contact is deleted.
Product created or updatedThe product and its variations are created or updated.
Product deletedThe product is removed.
Order created or updatedThe order is saved on the contact, and events are recorded as the order moves through its statuses (see the next table).
Order deletedThe order is marked as deleted.

Order statuses and the events they record

Contlo turns WooCommerce order statuses into events you can use in segments and as automation triggers.

WooCommerce order statusEvents recorded in Contlo
pending, on-holdNone yet. The order is saved as pending.
processing, pending-approvalPlaced Order, Ordered Product (one per product) and Fulfillment Created
shipped, dispatchedOrder In Transit
delivered, completedDelivered Order
cancelledCancelled Order. Not recorded when the order was still pending.
refunded, rtoThe order is marked as refunded.

Storefront tracking

Once the plugin is connected it adds Contlo's script to every page of your storefront. You don't edit your theme. The script and the plugin together give you:

WhatHow it works
Viewed ProductRecorded when a shopper Contlo recognizes opens a product page.
Added To CartRecorded when a recognized shopper adds an item to the cart, with the cart contents and total.
Checkout StartedRecorded on the checkout page as soon as the shopper enters a valid email or phone number, even if they never place the order. This is what powers abandoned checkout automations.
Cart recovery linksRecovery links in your messages rebuild the shopper's cart on your store and take them to the cart page.
Forms and popupsForms you publish in Contlo show on your storefront. See Forms overview.
Web pushThe plugin adds the file browsers need for web push, so shoppers can be asked to allow notifications. See Push settings.

Product views and cart events are recorded only for shoppers Contlo can recognize: someone logged in to your store, or someone Contlo has already identified on this browser. Anonymous visits are not turned into contacts.

To build flows on these events, see Automation triggers and actions. To check what is arriving, open Events analytics.

Using WooCommerce data in Contlo

  • Segments: filter on order events, products bought, amount spent and storefront activity. See Segments.
  • Automations: trigger on Checkout Started, Added To Cart, Viewed Product, Placed Order, Order In Transit, Delivered Order and the other order events. See Automations overview.
  • RFM and Cohorts: install them from the App Market to see who buys again and when. See RFM analysis and Cohorts.
  • Revenue reporting: total revenue and order counts include every order status except pending, cancelled, refunded, failed and trash.

Pause or disconnect

What you do in WordPressWhat happens
Deactivate the pluginStorefront tracking stops and Contlo pauses its webhooks, so new orders, customers and products stop syncing. Nothing is deleted in Contlo.
Delete the pluginContlo removes its webhooks from your store and the connection is closed. The plugin's settings are removed from WordPress.

Contacts, orders and events already in Contlo stay in your account. Automations that depend on store events stop receiving new triggers, so pause them if you disconnect for good.

To reconnect, activate the plugin again, open Contlo in the WordPress admin menu, click Connect your account and approve access as you did the first time.

Troubleshooting

What you seeWhat to do
Failed to connect to WooCommerce, Contact Support after Verify setupThe approval step hasn't finished. In WordPress, open Contlo, click Connect your account, click Approve on the WooCommerce screen, then click Verify setup again. Make sure you are signed in to the same Contlo account in both tabs.
Verification failed. Please try again.Contlo couldn't check the connection. Reload the page and click Verify setup again.
Invalid Shop DomainEnter the store's web address only, for example www.yourstoreurl.com.
The WordPress Contlo page still shows Connect your account after you approvedThe page refreshes on its own once the connection is saved. If it doesn't, check that security or caching plugins are not blocking requests to your site's REST API, then try again.
No Contlo item in the WordPress menuThe plugin isn't activated, or you are not signed in as an administrator.
Orders stopped syncingIn WooCommerce, open Settings → Advanced → Webhooks and check that the Contlo: webhooks are active. Contlo re-enables its webhooks once a day, or you can set them back to active yourself.
No Checkout Started eventsThe checkout page must have the standard billing email or billing phone field. Heavily customized checkouts that rename these fields are not detected.
No Viewed Product or Added To Cart events for a shopperThese are recorded only for shoppers Contlo recognizes. Test while logged in to a customer account on your store.
Phone numbers have the wrong country codeContlo uses the dialing code of your business address country. Check your business address in Account settings.

Still stuck? Write to hello@contlo.com with your store URL.

Related guides

Can't find something? Email us