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.
Passo per passo
- 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.
- Installa il plugin. In WordPress: Plugin → Aggiungi nuovo → cerca “The-Y CRM for WooCommerce” → Installa ora → Attiva. WooCommerce deve essere attivo.
- 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. - 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.
- 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.
Cosa vedi nel CRM
- Contatto: il CRM cerca il cliente in base all'indirizzo email (maiuscole e minuscole non contano), altrimenti in base al numero di telefono (in qualsiasi formato; il Paese dell'ordine lo trasforma in un numero internazionale). Se non c'è, lo crea. Per un contatto esistente compila solo i campi vuoti (nome, telefono) e non sovrascrive mai nulla. Un ordine senza email e telefono viene salvato senza contatto.
- Timeline: il contatto (e la sua azienda) mostra “Order no. …” con importo e stato. Un clic apre l'ordine nel tuo negozio in una nuova scheda.
- Inbox: a destra della conversazione, il riquadro “Recent orders” mostra i cinque ordini più recenti del cliente, con stato, importo, articoli, negozio e “Open in shop”. Lo vede chiunque possa vedere i contatti.
- Più negozi: puoi collegare più negozi a un solo account (meglio una chiave per negozio). Ordini con lo stesso numero da due negozi restano separati.
- Niente doppioni: se il negozio invia di nuovo lo stesso ordine o arriva in ritardo un aggiornamento più vecchio, non cambia nulla. Un nuovo stato aggiorna l'ordine esistente.
Messaggi automatici (flussi)
In Settings → Flows ci sono due trigger per i negozi:
- “Order received”: parte una volta per ordine. Non per gli ordini vecchi trasferiti e non per gli ordini più vecchi di 7 giorni.
- “Order status changed”: parte quando lo stato cambia nel negozio. Con l'opzione “New status” scegli “any” o uno stato preciso: in attesa di pagamento, in lavorazione, in sospeso, completato, cancellato, rimborsato, fallito. Gli stati personalizzati di altri plugin del negozio li verifichi con la condizione “Order: status”.
“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).
- 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”.
- 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.
- Nel flusso imposta la condizione “Consent WhatsApp” = “yes” e usa l'azione “Send WhatsApp template”.
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.
- Testo suggerito per la tua informativa sulla privacy: il plugin lo aggiunge in WordPress in Impostazioni → Privacy → Policy Guide, in base alle tue impostazioni. Controllalo e adattalo al tuo negozio.
- Eliminazione: se elimini definitivamente un contatto nel CRM, spariscono anche i suoi ordini nel CRM (l'ordine in sé resta nel tuo negozio). Quando unisci dei contatti, gli ordini si spostano con loro.
- Registro delle modifiche: ogni ordine trasferito per la prima volta riceve una voce, senza nomi, indirizzi o numeri.
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.
