La Guida di Mokapen

Shopify

Collega il tuo negozio Shopify a Mokapen per portare in CRM i clienti (contatti), i prodotti (con varianti e quantità) e gli ordini dello store, e per esportare verso Shopify i prodotti creati o aggiornati in Mokapen quando la direzione sync lo consente. Serve a unire e-commerce e gestione commerciale: anagrafiche, catalogo e storico acquisti nello stesso workspace.

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

Requisiti

• Negozio Shopify attivo (URL che termina con .myshopify.com).
• Permesso di autorizzare l'app Mokapen su Shopify (OAuth) con account admin dello store.
• Piano Mokapen Premium adeguato per le integrazioni e-commerce. Senza piano, il pulsante di collegamento apre l'upgrade; in alcuni percorsi Shopify può proporre anche un addebito ricorrente legato all'app.
• 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 Shopify

1. Menu utente → Integrazioni → Shopify.
2. Inserisci il nome del negozio (come in Shopify Admin; l'URL completo finisce con myshopify.com). Se non sei sicuro, apri la dashboard Shopify e guarda la barra indirizzi del browser.
3. Avvia l'autorizzazione: vieni portato su Shopify per accettare i permessi.
4. Accetta gli scope richiesti (lettura/scrittura clienti e prodotti, lettura ordini — vedi sotto).
5. Torna in Mokapen: compare lo store collegato. Se arrivi dall'App Store Shopify, potresti dover scegliere l'organizzazione Mokapen su cui installare il collegamento.

Se non accetti su Shopify, nessun dato viene sincronizzato. Dopo il collegamento Mokapen registra i webhook sullo store: così aggiornamenti su clienti, prodotti e ordini possono arrivare in tempo reale, oltre alla sync bulk che lanci tu.

Cosa chiede Mokapen a Shopify

In autorizzazione OAuth Mokapen richiede tipicamente:

• read_customers / write_customers — leggere (e potenzialmente scrivere) i clienti Shopify.
• read_products / write_products — leggere e aggiornare prodotti/varianti.
• read_orders — leggere gli ordini dello store.

Mokapen non sostituisce il pannello Shopify per checkout, temi o pagamenti: allinea i dati verso (e, per i prodotti, da) il CRM. Se revochi l'app da Shopify o scade il token, disconnetti e collega di nuovo da Mokapen. Shopify richiede anche endpoint GDPR (richiesta dati / redact): Mokapen li gestisce lato webhook.

Cosa viene sincronizzato

Verso Mokapen (import / webhook)

• Clienti → Contatti — anagrafiche Shopify entrano in rubrica; se presenti dati azienda possono creare/collegare anche l'azienda. Webhook su create/update/delete clienti.
• Prodotti e varianti → Prodotti — catalogo con varianti; la quantità inventario Shopify sulla variante viene mappata sul campo quantità della variante Mokapen (non è un modulo magazzino separato).
• Ordini → Ordini — gli ordini Shopify diventano ordini di vendita in Mokapen (con righe articoli), non deal in pipeline. Webhook sugli aggiornamenti ordine.
• Checkout abbandonati — in sync può esserci un percorso di import dei checkout abbandonati Shopify (come ordini/dati correlati). I report dedicati a carrelli abbandonati / analytics e-commerce in pagina risultano ancora In arrivo: non contarli come feature già attiva.

Verso Shopify (export)

• Prodotti — con direzione sync «verso Shopify» o «entrambe», Mokapen può esportare/aggiornare prodotti sullo store (sync bulk e sync-out quando salvi un prodotto collegato, se l'integrazione è attiva).
• Contatti e ordini in uscita — nonostante gli scope write_customers, l'export automatico «sync out» implementato oggi riguarda in pratica i prodotti. Non dare per scontato un export completo bidirezionale dei contatti o degli ordini: i clienti arrivano soprattutto da Shopify verso Mokapen (import + webhook). Se il testo marketing parla di «bidirezionale solo contatti», verifica nel tuo ambiente cosa fa realmente la sync dopo il collegamento.

In config l'integrazione elenca anche i servizi, ma non c'è una sync servizi e-commerce dedicata come per i prodotti: usa i Prodotti per il catalogo store.

Impostazioni dopo il collegamento

Sulla pagina Shopify, con store connesso, configuri tipicamente:

Direzione sync

• Solo verso Mokapen — i dati partono da Shopify e entrano in CRM.
• Entrambe — import + export (dove supportato; oggi soprattutto prodotti in uscita).
• Solo verso Shopify — spinta da Mokapen verso lo store (prodotti).

Entità

Contatti, ordini e prodotti compaiono come ambiti di sync (spesso già selezionati e non modificabili dalla UI). La sync storica e i webhook coprono questi tre blocchi.

Condividi sync

Chi ha collegato lo store può far usare lo stesso collegamento ad altri membri (organizzazione intera o utenti selezionati), così non tutti devono rifare OAuth.

Duplicati e conflitti

• Evita duplicati — opzione tipica: contatti riconosciuti per email, per non creare doppioni in rubrica.
• In caso di conflitto — scegli se vince Shopify o Mokapen quando lo stesso record è stato modificato da entrambe le parti.

Sync automatica vs manuale

Con sync automatica attiva, gli aggiornamenti (e i webhook) mantengono allineati i dati; puoi comunque lanciare una sincronizzazione manuale per il carico storico iniziale. Prima di sincronizzare spunta l'autorizzazione al trattamento/condivisione dati richiesta in pagina.

Flusso consigliato

1. Collega lo store e verifica Account collegato.
2. Imposta direzione sync (per la maggior parte dei casi: Solo verso Mokapen o Entrambe se vuoi aggiornare i prodotti Shopify da Mokapen).
3. Configura duplicati/conflitti e condivisione.
4. Autorizza e lancia la prima sync (può richiedere tempo su cataloghi grandi).
5. Controlla in Mokapen: Contatti, Prodotti (varianti/qty), Ordini.
6. Lascia attivi i webhook: i nuovi ordini e aggiornamenti clienti/prodotti arriveranno senza rilanciare tutto ogni volta.

Disconnettere

Da Integrazioni → Shopify → disconnetti. Nel modale puoi scegliere se mantenere in Mokapen i contatti, gli ordini e i prodotti già importati, oppure gestirli secondo le opzioni proposte. Dopo la disconnessione i webhook smettono di aggiornare; i dati già in CRM restano se hai scelto di tenerli. Puoi anche revocare l'app dal pannello Shopify.

Problemi frequenti

• Nome negozio non valido — usa il sottodominio *.myshopify.com, non solo il dominio custom di vetrina.
• Pulsante bloccato / upgrade — serve un piano Premium adeguato all'e-commerce.
• Ordini non in Opportunità — è corretto: vanno negli Ordini. Apri Vendite → Ordini.
• Quantità prodotto — arriva dalla quantità variante Shopify; non è un WMS completo.
• Report carrelli / analytics — se in pagina risultano «In arrivo», non sono ancora operativi.
• Token scaduto / sync ferma — disconnetti e collega di nuovo; verifica che l'app non sia stata disinstallata da Shopify.

Domande frequenti

D: Dove trovo l'URL del negozio?

A: Nella barra indirizzi della dashboard Shopify Admin: termina con myshopify.com.

D: Gli ordini Shopify diventano opportunità?

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

D: Posso aggiornare i prodotti Shopify da Mokapen?

A: Sì, con direzione sync che include l'export e l'integrazione attiva: i prodotti (varianti) possono essere inviati/aggiornati sullo store.

D: I contatti si aggiornano anche da Mokapen a Shopify?

A: L'import e i webhook portano i clienti Shopify in CRM. L'export contatti automatico non è il percorso principale oggi (a differenza dei prodotti): verifica sul tuo piano/ambiente dopo il collegamento.

D: Serve WooCommerce insieme a Shopify?

A: No: sono due integrazioni e-commerce alternative. Usa Shopify se lo store è su Shopify; vedi la guida WooCommerce se usi WordPress/Woo.