WooCommerce

WooCommerce is the native connector for WordPress stores. Once connected, it syncs your store's customers and orders into Instasent so your audience and purchase events stay current.

How to connect

WooCommerce connects with an API key: you create a REST API key in your store first and paste it into Instasent. The key is a Consumer Key and a Consumer Secret pair.

1. 1

   Create a REST API key in WooCommerce

   In your WordPress admin, open WooCommerce → Settings → Advanced → REST API and create a key with Read/Write permissions. WooCommerce gives you a Consumer Key and a Consumer Secret.

2. 2

   Add the data source

   In Data sources, select Add data source and choose WooCommerce from the Integrations section.

3. 3

   Enter your credentials and connect

   On the Connect step, fill in the Connection name, your Shop domain, and the Consumer Key and Consumer Secret, then connect.

4. 4

   Initial import

   The connector imports your existing customers and orders, then keeps syncing.

After connecting, the wizard continues through Mapping, Merge and Tags, the same steps as a CSV import.

What it syncs

• Contacts — your store's customers, with name, email and phone.
• Orders — purchase events for use in segments and automations.

The direction is one-way, from WooCommerce into Instasent, and contacts unify by email and phone — see unification.

The events it brings in

The real value of the store connection is its events: every order and checkout moment Instasent receives becomes something you can segment on or trigger an automation from — a paid order to thank a buyer, an abandoned checkout to win the sale back, a new customer to welcome. The connector covers the full order lifecycle (created, paid, cancelled, refunded), the checkout (started, updated) and customer events.

Field mapping

WooCommerce customer fields map to the matching Instasent attributes (email to _email, phone to _phone_mobile, name fields to theirs), and order data arrives as ecommerce events. Confirm the mapping on setup; see field mapping.

Consent mapping

Map WooCommerce's marketing status to Instasent's marketing-preference attribute (_accepts_marketing_*) following the consent golden rule:

WooCommerce status	Instasent value	Meaning
Opted in	true	Accepted marketing
No status recorded	null	No preference
Opted out	false	Actively declined marketing

Only an active opt-out becomes false. A customer with no recorded marketing status maps to no preference (null), never to false. See Consent.