Guide > Collegare i canali > WooCommerce

Collegare WooCommerce al CRM

Con il plugin gratuito “The-Y CRM for WooCommerce” ogni ordine del tuo negozio arriva al cliente giusto: il CRM crea o trova il contatto, mostra l'ordine nella timeline e nell'inbox e può inviare un messaggio in automatico quando arriva un ordine o ne cambia lo stato. Quando un cliente scrive o chiama, vedi i suoi ordini proprio accanto alla conversazione.

⏱ circa 5 min · Autorizzazione “Manage integrations” (admin) · Free, Cloud Pro e Paid · WordPress con WooCommerce · Aggiornato al 14 nov 2026 (versione 1.1.67)

Il plugin è attualmente in revisione su wordpress.org. Appena sarà approvato lo troverai in WordPress in Plugin → Aggiungi nuovo cercando “The-Y CRM for WooCommerce”, e qui ci sarà il link diretto. La chiave nel CRM puoi già crearla.

Passo per passo

  1. Crea una chiave. Nel CRM: Settings → Integrations (nel menu sotto “Advanced”; la trovi anche cercando “WooCommerce”) → sezione “WooCommerce (online shop)” → “Create key for WooCommerce”. Copiala subito: viene mostrata solo questa volta. La chiave può solo inviare ordini, non può leggere contatti o conversazioni. Dopo compare più in basso in “API keys”, dove puoi revocarla in qualsiasi momento.
  2. Installa il plugin. In WordPress: Plugin → Aggiungi nuovo → cerca “The-Y CRM for WooCommerce” → Installa ora → Attiva. WooCommerce deve essere attivo.
  3. Collega. In WordPress: WooCommerce → The-Y CRM. In “CRM address” c'è già https://crm.the-y.at: se il CRM lo gestisci tu, inserisci il tuo indirizzo (il CRM te lo mostra da copiare nella sezione “WooCommerce”). Incolla la chiave del passaggio 1 in “API key”, clicca “Test connection” e salva.
  4. Ordine di prova. Fai un ordine nel tuo negozio. Poco dopo compare nel CRM con il negozio (nella sezione “WooCommerce”: ordini, clienti, ultimo ricevuto), nella timeline del cliente e nell'inbox.
  5. Recupera gli ordini più vecchi (facoltativo). Nel plugin, “Transfer recent orders”: fino a 50 ordini degli ultimi 90 giorni, dal più recente. Per questo trasferimento nel CRM non partono flussi, quindi i tuoi clienti non ricevono messaggi sugli ordini vecchi.
Il checkout non aspetta mai il CRM: il plugin invia gli ordini in background (tramite Action Scheduler, incluso in WooCommerce). Se il CRM per un attimo non è raggiungibile, il plugin riprova da solo: dopo 1 minuto, 5 minuti, 30 minuti, 2 ore e 12 ore.

Cosa vedi nel CRM

Messaggi automatici (flussi)

In Settings → Flows ci sono due trigger per i negozi:

“Insert placeholder” aggiunge al tuo messaggio numero d'ordine, stato (come testo nella lingua del cliente, ad es. “Processing”), stato precedente, importo, valuta, articoli (ad es. “2× maglietta, 1× berretto”), quantità, negozio e data dell'ordine: per esempio per un'email di ringraziamento dopo l'ordine o per un “Il Suo ordine è in viaggio” quando lo stato è “completato”.

WhatsApp: consenso al checkout

WhatsApp permette messaggi solo ai clienti che hanno dato il consenso: un numero di telefono al checkout non è ancora un consenso. Inoltre, passate più di 24 ore dall'ultimo messaggio del cliente, si può inviare solo un modello approvato da Meta (categoria “Utility” per gli aggiornamenti sugli ordini).

  1. Nel plugin attiva “Offer WhatsApp consent”. Il checkout mostra allora una casella (checkout classico e a blocchi), facoltativa e mai preselezionata. Puoi cambiarne il testo in “Text of the checkbox”.
  2. Se il cliente la spunta, il negozio salva il consenso con il suo testo sull'ordine. Nel CRM il contatto riceve il consenso “WhatsApp” con la fonte “at the shop checkout (order updates only)”, più negozio, numero d'ordine e testo della casella.
  3. Nel flusso imposta la condizione “Consent WhatsApp” = “yes” e usa l'azione “Send WhatsApp template”.
Questo consenso copre solo gli aggiornamenti sugli ordini, mai la pubblicità: le campagne non raggiungono questi clienti in base a questo consenso. Se un cliente prima ha detto “no” (ad es. con STOP), resta “no”.

Quali dati invia il plugin

Per ogni nuovo ordine e ogni cambio di stato: numero d'ordine, stato, importo, valuta, orari, link all'ordine nel negozio, nome e cognome, indirizzo email, numero di telefono, Paese (solo per convertire il numero di telefono; il CRM non lo salva) e gli articoli (nome, quantità, importo; al massimo 50). Numero di telefono e articoli si possono disattivare nel plugin (“Send phone number”, “Send items”). Se la casella è stata spuntata, si aggiungono il consenso e il suo testo.

Mai inviati: indirizzi, ragione sociale, nota del cliente, indirizzo IP, browser, dati di pagamento, ID cliente, password.

Limiti

Gli ordini contano come richieste all'API: sul piano Free 60 al minuto e 1.000 al giorno, con Cloud Pro, Paid e Founder 300 al minuto. Se diventano troppe, il plugin aspetta il tempo indicato e poi prosegue. Una richiesta può pesare al massimo 256 KB.

Risoluzione dei problemi

“Test connection” segnala un errore

Sotto il messaggio il plugin ti dice cosa fare, con un link a questa pagina. I casi più frequenti: key invalid: la chiave è stata revocata, è scaduta o è stata copiata male; creane una nuova nel CRM. Permission missing: la chiave non può inviare ordini; usa il pulsante “Create key for WooCommerce” (oppure dai alla tua chiave l'autorizzazione “Send orders from a shop”). Not reachable: controlla l'indirizzo del CRM (con https://, senza percorso).

Un ordine non arriva nel CRM

Il plugin mostra l'ultimo trasferimento e l'ultimo errore. I trasferimenti passano da Action Scheduler: WooCommerce → Stato → Azioni programmate, gruppo the-y-crm-for-woocommerce. Se lì restano bloccati, sul tuo sito WP-Cron non sta girando: chiedi al tuo hosting un vero cron job. Bozze, cestino e rimborsi volutamente non vengono inviati.

Il cliente compare due volte nel CRM

Succede quando ha ordinato una volta con un indirizzo email e un'altra volta solo con un numero di telefono diverso. Unisci i contatti: gli ordini si spostano con loro.

Pulsante chat o WhatsApp per il negozio

Per questo c'è il nostro plugin separato “The-Y CRM – Web Chat & Contact Buttons” (guida: Integrare la WebChat). I due plugin funzionano insieme; se è attivo, il plugin WooCommerce lo indica nella sua pagina.

Prossimi passi