Ghidul Mokapen

Shopify

Conectați magazinul Shopify la Mokapen pentru a aduce în CRM clienții (contacte), produsele (cu variante și cantități) și comenzile magazinului, și pentru a exporta către Shopify produsele create sau actualizate în Mokapen când direcția de sync o permite. Scopul este unirea e-commerce-ului cu gestionarea comercială: date master, catalog și istoric de achiziții în același workspace.

Prezentare generală: Integrări. Comenzile importate devin comenzi de vânzare în Mokapen (modulul Comenzi), nu oportunități în pipeline.

Cerințe

• Magazin Shopify activ (URL care se termină cu .myshopify.com).
• Permisiune de a autoriza aplicația Mokapen în Shopify (OAuth) cu un cont de administrator al magazinului.
• Plan Mokapen Premium adecvat pentru integrările e-commerce. Fără plan, butonul de conectare deschide upgrade-ul; în unele fluxuri Shopify poate propune și o taxă recurentă legată de aplicație.
• Permisiuni Mokapen pentru contacte, produse și comenzi în organizația dvs. (consultați Roluri și permisiuni).
• Acces la Integrări (membru/admin conform white-label și rol org).

Conectarea magazinului Shopify

1. Meniu utilizator → Integrări → Shopify.
2. Introduceți numele magazinului (ca în Shopify Admin; URL-ul complet se termină cu myshopify.com). Dacă nu sunteți sigur, deschideți panoul Shopify și verificați bara de adrese a browserului.
3. Porniți autorizarea: veți fi redirecționat către Shopify pentru a accepta permisiunile.
4. Acceptați scope-urile solicitate (citire/scriere clienți și produse, citire comenzi — vezi mai jos).
5. Reveniți în Mokapen: magazinul apare conectat. Dacă ajungeți din Shopify App Store, poate fi necesar să alegeți organizația Mokapen pe care instalați conexiunea.

Dacă nu acceptați în Shopify, nicio dată nu se sincronizează. După conectare Mokapen înregistrează webhook-urile în magazin: astfel actualizările clienților, produselor și comenzilor pot ajunge în timp real, pe lângă sync-ul bulk pe care îl lansați dvs.

Ce solicită Mokapen de la Shopify

La autorizarea OAuth Mokapen solicită de obicei:

• read_customers / write_customers — citire (și eventual scriere) a clienților Shopify.
• read_products / write_products — citire și actualizare produse/variante.
• read_orders — citire comenzilor magazinului.

Mokapen nu înlocuiește panoul Shopify pentru checkout, teme sau plăți: aliniază datele către (și, pentru produse, din) CRM. Dacă revocați aplicația din Shopify sau tokenul expiră, deconectați și reconectați din Mokapen. Shopify solicită și endpoint-uri GDPR (cerere date / redact): Mokapen le gestionează prin webhook.

Ce se sincronizează

Către Mokapen (import / webhook)

• Clienți → Contacte — datele master Shopify intră în agenda; dacă există date de companie, se poate crea/conecta și compania. Webhook la create/update/delete clienți.
• Produse și variante → Produse — catalog cu variante; cantitatea de inventar Shopify pe variantă se mapează pe câmpul cantitate variantă Mokapen (nu este un modul de depozit separat).
• Comenzi → Comenzi — comenzile Shopify devin comenzi de vânzare în Mokapen (cu linii articol), nu deal-uri în pipeline. Webhook la actualizări comenzi.
• Checkout-uri abandonate — în sync poate exista o cale de import a checkout-urilor abandonate Shopify (ca comenzi/date conexe). Rapoartele dedicate coșurilor abandonate / analytics e-commerce pe pagină sunt încă În curând: nu le considerați funcție deja activă.

Către Shopify (export)

• Produse — cu direcția sync «către Shopify» sau «ambele», Mokapen poate exporta/actualiza produse în magazin (sync bulk și sync-out la salvarea produsului conectat, dacă integrarea este activă).
• Contacte și comenzi în ieșire — deși există scope write_customers, exportul automat «sync out» implementat astăzi se referă în practică la produse. Nu presupuneți un export bidirecțional complet al contactelor sau comenzilor: clienții ajung mai ales din Shopify către Mokapen (import + webhook). Dacă textul de marketing vorbește de «bidirecțional doar contacte», verificați în mediul dvs. ce face sync-ul după conectare.

În config integrarea listează și serviciile, dar nu există sync dedicat servicii e-commerce ca pentru produse: folosiți Produsele pentru catalogul magazinului.

Setări după conectare

Pe pagina Shopify, cu magazin conectat, configurați de obicei:

Direcție sync

• Doar către Mokapen — datele pleacă din Shopify și intră în CRM.
• Ambele — import + export (unde este suportat; astăzi mai ales produse în ieșire).
• Doar către Shopify — impuls din Mokapen către magazin (produse).

Entități

Contacte, comenzi și produse apar ca domenii de sync (adesea deja selectate și nemodificabile din UI). Sync-ul istoric și webhook-urile acoperă aceste trei blocuri.

Partajare sync

Cine a conectat magazinul poate permite altor membri să folosească aceeași conexiune (organizație întreagă sau utilizatori selectați), astfel încât nu toți refac OAuth.

Duplicate și conflicte

• Evitați duplicatele — opțiune tipică: contacte recunoscute după email, pentru a nu crea dubluri în agendă.
• În caz de conflict — alegeți dacă câștigă Shopify sau Mokapen când același record a fost modificat de ambele părți.

Sync automat vs manual

Cu sync automat activ, actualizările (și webhook-urile) mențin datele aliniate; puteți totuși lansa o sincronizare manuală pentru încărcarea istorică inițială. Înainte de sincronizare bifați autorizarea pentru prelucrarea/partajarea datelor cerută pe pagină.

Flux recomandat

1. Conectați magazinul și verificați Cont conectat.
2. Setați direcția sync (pentru majoritatea cazurilor: Doar către Mokapen sau Ambele dacă doriți să actualizați produsele Shopify din Mokapen).
3. Configurați duplicate/conflicte și partajare.
4. Autorizați și lansați primul sync (poate dura pe cataloage mari).
5. Verificați în Mokapen: Contacte, Produse (variante/cant.), Comenzi.
6. Lăsați webhook-urile active: comenzile noi și actualizările clienților/produselor vor ajunge fără a relansa totul de fiecare dată.

Deconectare

Din Integrări → Shopify → deconectați. În modal puteți alege dacă păstrați în Mokapen contactele, comenzile și produsele deja importate, sau le gestionați conform opțiunilor propuse. După deconectare webhook-urile nu mai actualizează; datele deja în CRM rămân dacă ați ales să le păstrați. Puteți revoca aplicația și din panoul Shopify.

Probleme frecvente

• Nume magazin nevalid — folosiți subdomeniul *.myshopify.com, nu doar domeniul custom al vitrinei.
• Buton blocat / upgrade — este necesar un plan Premium adecvat e-commerce-ului.
• Comenzi nu în Oportunități — este corect: merg în Comenzi. Deschideți Vânzări → Comenzi.
• Cantitate produs — vine din cantitatea variantă Shopify; nu este un WMS complet.
• Rapoarte coșuri / analytics — dacă pe pagină apar «În curând», nu sunt încă operaționale.
• Token expirat / sync oprit — deconectați și reconectați; verificați că aplicația nu a fost dezinstalată din Shopify.

Întrebări frecvente

Î: Unde găsesc URL-ul magazinului?

R: În bara de adrese a panoului Shopify Admin: se termină cu myshopify.com.

Î: Comenzile Shopify devin oportunități?

R: Nu. În Mokapen devin comenzi de vânzare (cu linii). Orice texte care vorbesc de «oportunități» sunt imprecise față de comportamentul actual.

Î: Pot actualiza produsele Shopify din Mokapen?

R: Da, cu direcție sync care include exportul și integrarea activă: produsele (variante) pot fi trimise/actualizate în magazin.

Î: Contactele se actualizează și din Mokapen către Shopify?

R: Importul și webhook-urile aduc clienții Shopify în CRM. Exportul automat de contacte nu este calea principală astăzi (spre deosebire de produse): verificați pe planul/mediul dvs. după conectare.

Î: Am nevoie de WooCommerce împreună cu Shopify?

R: Nu: sunt două integrări e-commerce alternative. Folosiți Shopify dacă magazinul este pe Shopify; consultați ghidul WooCommerce dacă folosiți WordPress/Woo.