La Guida di Mokapen

WooCommerce

Collega il tuo negozio WooCommerce (WordPress) a Mokapen per portare in CRM i clienti (contatti), i prodotti (con variazioni e stock) e gli ordini dello store, e per esportare verso WooCommerce i prodotti creati o aggiornati in Mokapen quando la direzione sync lo consente. Stesso obiettivo di Shopify: unire e-commerce e gestione commerciale nello stesso workspace.

Panoramica generale: Integrazioni. Gli ordini importati diventano ordini di vendita in Mokapen (modulo Ordini), non opportunità di pipeline.

Requisiti

• Sito WordPress con WooCommerce attivo e raggiungibile in HTTPS.
• Permesso di autorizzare Mokapen tramite il flusso WC Auth (amministratore WordPress / WooCommerce).
• Piano Mokapen Premium adeguato per le integrazioni e-commerce. Senza piano, il pulsante di collegamento apre l'upgrade.
• Permessi Mokapen su contatti, prodotti e ordini nella tua organizzazione (vedi Ruoli e permessi).
• Accesso alle Integrazioni (membro/admin secondo white-label e ruolo org).

Collegare il negozio WooCommerce

1. Menu utente → Integrazioni → WooCommerce.
2. Inserisci l'indirizzo web del negozio (URL del sito, es. https://tuodominio.com). Lo trovi nella barra indirizzi quando sei nel backend WordPress / vetrina WooCommerce.
3. Avvia l'autorizzazione: vieni portato su WordPress/WooCommerce alla pagina WC Auth (/wc-auth/v1/authorize) con scope read_write.
4. Accetta di generare le chiavi API per Mokapen (consumer key / secret vengono salvate cifrate in Mokapen — non c'è un form «incolla API key» manuale).
5. Torna in Mokapen: lo store risulta collegato. Mokapen registra i webhook WooCommerce (/wp-json/wc/v3/webhooks) per ricevere aggiornamenti in tempo reale.

Se non accetti l'autorizzazione, nessun dato viene sincronizzato. L'URL deve essere valido e in HTTPS: altrimenti la validazione fallisce.

Cosa chiede Mokapen a WooCommerce

Il flusso WC Auth concede a Mokapen accesso in lettura/scrittura alle API REST WooCommerce necessarie per clienti, prodotti (e variazioni), ordini e webhook. Mokapen non sostituisce il pannello WooCommerce/WordPress per temi, pagamenti o plugin: allinea i dati verso (e, per i prodotti, da) il CRM.

Se revochi le chiavi o disinstalli l'autorizzazione lato WordPress, disconnetti e collega di nuovo da Mokapen.

Cosa viene sincronizzato

Verso Mokapen (import / webhook)

• Clienti → Contatti — clienti WooCommerce in rubrica (e azienda se i dati lo consentono). Aggiornamenti anche via webhook.
• Prodotti e variazioni → Prodotti — catalogo con variazioni; lo stock WooCommerce (stock_quantity) viene mappato sulla quantità variante Mokapen.
• Ordini → Ordini — gli ordini WooCommerce diventano ordini di vendita in Mokapen (con righe), non deal in pipeline. Webhook sugli aggiornamenti.
• Carrelli abbandonati / report — eventuali menzioni marketing o voci «In arrivo» in UI non equivalgono a un import reportistica carrelli già attiva come su altri flussi: non contarli come feature completa se in pagina risultano ancora in arrivo.

Verso WooCommerce (export)

• Prodotti — con direzione sync «verso WooCommerce» o «entrambe», Mokapen può esportare/aggiornare prodotti sullo store (sync bulk e sync-out al salvataggio prodotto, se l'integrazione è attiva).
• Contatti e ordini in uscita — come per Shopify, l'export automatico «sync out» implementato oggi riguarda in pratica i prodotti. I clienti arrivano soprattutto da WooCommerce verso Mokapen (import + webhook). Non dare per scontato un export contatti bidirezionale completo solo perché il testo commerciale lo suggerisce: verifica dopo il collegamento.

In config compare anche servizi, ma non c'è una sync servizi dedicata: per il catalogo store usa i Prodotti.

Impostazioni dopo il collegamento

Sulla pagina WooCommerce, con store connesso:

Direzione sync

• Solo verso Mokapen — WooCommerce → CRM.
• Entrambe — import + export (dove supportato; oggi soprattutto prodotti in uscita).
• Solo verso WooCommerce — Mokapen → store (prodotti).

Entità

Contatti, ordini e prodotti sono gli ambiti di sync (spesso preselezionati e non modificabili dalla UI).

Condividi sync

Chi ha collegato può condividere il collegamento con tutta l'organizzazione o utenti selezionati.

Duplicati e conflitti

• Evita duplicati — tipicamente riconoscimento contatti per email.
• In caso di conflitto — vince WooCommerce oppure Mokapen.

Privacy (WooCommerce)

Rispetto a Shopify, sulla pagina WooCommerce puoi trovare anche controlli di privacy e collaboratori/stakeholder legati a come i dati sincronizzati sono visibili in org. Impostali se il team non deve vedere tutto il catalogo/clienti importati allo stesso modo.

Sync automatica vs manuale

Attiva la sync automatica per gli aggiornamenti continui (insieme ai webhook); usa la sync manuale per il carico storico. Spunta l'autorizzazione dati in pagina prima di sincronizzare.

Flusso consigliato

1. Verifica HTTPS e WooCommerce aggiornato sul sito.
2. Collega lo store da Integrazioni → WooCommerce e completa WC Auth.
3. Imposta direzione sync, duplicati, conflitti, privacy (se presente) e condivisione.
4. Autorizza e lancia la prima sync.
5. Controlla Contatti, Prodotti (variazioni/stock), Ordini in Mokapen.
6. Lascia i webhook attivi per i nuovi eventi senza rilanciare tutto ogni volta.

Disconnettere

Da Integrazioni → WooCommerce → disconnetti. Nel modale scegli se mantenere in Mokapen contatti, ordini e prodotti già importati. Dopo la disconnessione i webhook non aggiornano più; i dati già in CRM restano se li hai tenuti. Puoi anche revocare le chiavi/autorizzazioni dal pannello WordPress.

Problemi frequenti

• URL non valido / non HTTPS — usa l'indirizzo completo del sito con https://.
• Autorizzazione fallita — serve un admin WordPress; verifica che WooCommerce e i permalink REST siano operativi (firewall/plugin di sicurezza possono bloccare WC Auth o i webhook).
• Pulsante bloccato / upgrade — serve un piano Premium adeguato all'e-commerce.
• Ordini non in Opportunità — è corretto: vanno negli Ordini (Vendite → Ordini).
• Stock / quantità — arriva da stock_quantity delle variazioni; non è un WMS completo.
• Webhook che non arrivano — il sito deve essere raggiungibile da internet; ambienti locali o con basic auth spesso non ricevono le notifiche WooCommerce.

Domande frequenti

D: Devo generare le API key a mano in WooCommerce?

A: No. Usa il flusso WC Auth dalla pagina Integrazioni Mokapen: le chiavi vengono create e salvate al ritorno dall'autorizzazione.

D: Gli ordini WooCommerce diventano opportunità?

A: No. In Mokapen diventano ordini di vendita. Eventuali testi che parlano di «opportunità» sono imprecisi rispetto al comportamento attuale.

D: Posso aggiornare i prodotti WooCommerce da Mokapen?

A: Sì, con direzione sync che include l'export e l'integrazione attiva.

D: Differenza con Shopify?

A: Stesso modello dati (contatti, prodotti, ordini) e stessa logica Premium e-commerce. Cambia il collegamento: Shopify usa OAuth sull'app Shopify; WooCommerce usa WC Auth sull'URL del tuo sito WordPress. Vedi anche la guida Shopify.

D: Serve HTTPS?

A: Sì. Senza HTTPS il collegamento e i webhook non sono affidabili (e la validazione URL può fallire).