Docs › Connect channels › WooCommerce

Connect WooCommerce to the CRM

With the free plugin “The-Y CRM for WooCommerce”, every order from your shop lands with the right customer: the CRM creates or finds the contact, shows the order in the timeline and in the inbox, and can send a message automatically when an order comes in or its status changes. When a customer writes or calls, you see their orders right next to the conversation.

⏱ approx. 5 min · Permission “Manage integrations” (admin) · Free, Cloud Pro & Paid · WordPress with WooCommerce · As of 14 Nov 2026 (version 1.1.67)

The plugin is currently being reviewed by wordpress.org. As soon as it is approved, you will find it in WordPress under Plugins → Add New by searching for “The-Y CRM for WooCommerce”, and the direct link will be here. You can already create the key in the CRM.

Step by step

  1. Create a key. In the CRM: Settings → Integrations (in the menu under “Advanced”; searching for “WooCommerce” finds it too) → section “WooCommerce (online shop)” → “Create key for WooCommerce”. Copy it right away: it is shown only this once. The key can only send orders – it cannot read contacts or conversations. Afterwards it is listed below under “API keys”, where you can revoke it at any time.
  2. Install the plugin. In WordPress: Plugins → Add New → search for “The-Y CRM for WooCommerce” → Install → Activate. WooCommerce must be active.
  3. Connect. In WordPress: WooCommerce → The-Y CRM. “CRM address” already says https://crm.the-y.at – if you run the CRM yourself, enter your own address (the CRM shows it in the “WooCommerce” section for copying). Paste the key from step 1 into “API key”, click “Test connection” and save.
  4. Test order. Place an order in your shop. Shortly afterwards it shows up in the CRM with the shop (in the “WooCommerce” section: orders, customers, last received), in the customer's timeline and in the inbox.
  5. Fetch older orders (optional). In the plugin, “Transfer recent orders”: up to 50 orders from the last 90 days, newest first. No flows run in the CRM for this transfer – so your customers get no message about old orders.
Checkout never waits for the CRM: the plugin sends orders in the background (via Action Scheduler, which comes with WooCommerce). If the CRM is briefly unreachable, the plugin tries again by itself – after 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours.

What you see in the CRM

Automatic messages (flows)

Under Settings → Automations there are two triggers for shops:

“Insert placeholder” adds order number, status (as text in the customer's language, e.g. “Processing”), previous status, amount, currency, items (e.g. “2× T-shirt, 1× beanie”), quantity, shop and order date to your message – for example a thank-you e-mail after the order or “Your order is on its way” once the status is “completed”.

WhatsApp: consent at checkout

WhatsApp only allows messages to customers who agreed – a phone number at checkout is not consent yet. Also, more than 24 hours after the customer's last message, only a template approved by Meta can be sent (category “Utility” for order updates).

  1. In the plugin, switch on “Offer WhatsApp consent”. Checkout then shows a checkbox (classic and block checkout), optional and never pre-selected. You can change its wording under “Text of the checkbox”.
  2. If the customer ticks it, the shop stores the consent with its text on the order. In the CRM, the contact gets the consent “WhatsApp” with the source “at the shop checkout (order updates only)”, plus shop, order number and the text of the checkbox.
  3. In the flow, set the condition “Consent WhatsApp” = “yes” and use the action “Send WhatsApp template”.
This consent only covers order updates, never advertising – campaigns do not reach these customers through it. If a customer said “no” before (e.g. with STOP), it stays “no”.

Which data the plugin sends

For every new order and every status change: order number, status, amount, currency, times, link to the order in the shop, first and last name, e-mail address, phone number, country (only to convert the phone number; the CRM does not store it) and the items (name, quantity, amount; at most 50). Phone number and items can be switched off in the plugin (“Send phone number”, “Send items”). If the checkbox was ticked, consent and its text are added.

Never sent: addresses, company name, customer note, IP address, browser, payment data, customer ID, passwords.

Limits

Orders count as requests to the API: on the Free plan 60 per minute and 1,000 per day, with Cloud Pro, Paid and Founder 300 per minute. If it gets too much, the plugin waits the time given and then continues. A request may be at most 256 KB.

Troubleshooting

“Test connection” reports an error

Below the message, the plugin says what to do, with a link to this page. The most common cases: key invalid – the key was revoked, has expired or was copied incorrectly; create a new one in the CRM. Permission missing – the key may not send orders; use the button “Create key for WooCommerce” (or give your own key the permission “Send orders from a shop”). Not reachable – check the CRM address (with https://, without a path).

An order does not arrive in the CRM

The plugin shows the last transfer and the last error. Transfers run via Action Scheduler: WooCommerce → Status → Scheduled Actions, group the-y-crm-for-woocommerce. If they get stuck there, WP-Cron is not running on your website – ask your host for a real cron job. Drafts, trash and refunds are deliberately not sent.

The customer exists twice in the CRM

This happens when they ordered once with an e-mail address and once only with a different phone number. Merge the contacts – the orders move along.

Chat or WhatsApp button for the shop

That comes with our separate plugin “The-Y CRM – Web Chat & Contact Buttons” (guide: Embed the WebChat). Both plugins work together; if it is active, the WooCommerce plugin says so on its page.

What's next