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.
Step by step
- 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.
- Install the plugin. In WordPress: Plugins → Add New → search for “The-Y CRM for WooCommerce” → Install → Activate. WooCommerce must be active.
- 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. - 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.
- 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.
What you see in the CRM
- Contact: the CRM looks for the customer by e-mail address (upper/lower case does not matter), otherwise by phone number (in any format; the country of the order turns it into an international number). If there is none, it creates one. For an existing contact it only fills empty fields (name, phone) and never overwrites anything. An order without e-mail and phone is stored without a contact.
- Timeline: the contact (and their company) shows “Order no. …” with amount and status. A click opens the order in your shop in a new tab.
- Inbox: on the right of the conversation, the box “Recent orders” shows the customer's five newest orders – with status, amount, items, shop and “Open in shop”. Everyone who may view contacts sees it.
- Several shops: you can connect several shops to one account (ideally one key per shop). Orders with the same number from two shops stay separate.
- Nothing twice: if the shop sends the same order again or an older update arrives late, nothing changes. A new status updates the existing order.
Automatic messages (flows)
Under Settings → Automations there are two triggers for shops:
- “Order received” – starts once per order. Not for transferred old orders and not for orders older than 7 days.
- “Order status changed” – starts when the status changes in the shop. With the option “New status” you choose “any” or a specific one: pending payment, processing, on hold, completed, cancelled, refunded, failed. Check custom statuses of other shop plugins with the condition “Order: status”.
“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).
- 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”.
- 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.
- In the flow, set the condition “Consent WhatsApp” = “yes” and use the action “Send WhatsApp template”.
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.
- Suggested text for your privacy policy: the plugin adds it in WordPress under Settings → Privacy → Policy Guide – matching your settings. Please check it and adapt it to your shop.
- Deleting: if you delete a contact permanently in the CRM, their orders in the CRM are gone too (the order itself stays in your shop). When contacts are merged, the orders move along.
- Change log: every newly transferred order gets an entry – without names, addresses or numbers.
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.
