Ghidul Mokapen

WooCommerce

Conectați magazinul WooCommerce (WordPress) la Mokapen pentru a aduce în CRM clienții (contacte), produsele (cu variații și stoc) și comenzile magazinului, și pentru a exporta către WooCommerce produsele create sau actualizate în Mokapen când direcția de sync o permite. Același obiectiv ca la Shopify: unirea e-commerce-ului cu gestionarea comercială î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

• Site WordPress cu WooCommerce activ și accesibil prin HTTPS.
• Permisiune de a autoriza Mokapen prin fluxul WC Auth (administrator WordPress / WooCommerce).
• Plan Mokapen Premium adecvat pentru integrările e-commerce. Fără plan, butonul de conectare deschide upgrade-ul.
• 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 WooCommerce

1. Meniu utilizator → Integrări → WooCommerce.
2. Introduceți adresa web a magazinului (URL-ul site-ului, ex. https://domeniulmeu.com). O găsiți în bara de adrese când sunteți în backend WordPress / vitrina WooCommerce.
3. Porniți autorizarea: veți fi redirecționat către WordPress/WooCommerce la pagina WC Auth (/wc-auth/v1/authorize) cu scope read_write.
4. Acceptați generarea cheilor API pentru Mokapen (consumer key / secret sunt salvate criptat în Mokapen — nu există formular manual «lipește API key»).
5. Reveniți în Mokapen: magazinul este conectat. Mokapen înregistrează webhook-urile WooCommerce (/wp-json/wc/v3/webhooks) pentru a primi actualizări în timp real.

Dacă nu acceptați autorizarea, nicio dată nu se sincronizează. URL-ul trebuie să fie valid și în HTTPS: altfel validarea eșuează.

Ce solicită Mokapen de la WooCommerce

Fluxul WC Auth acordă Mokapen acces de citire/scriere la API-urile REST WooCommerce necesare pentru clienți, produse (și variații), comenzi și webhook. Mokapen nu înlocuiește panoul WooCommerce/WordPress pentru teme, plăți sau plugin-uri: aliniază datele către (și, pentru produse, din) CRM.

Dacă revocați cheile sau dezinstalați autorizarea în WordPress, deconectați și reconectați din Mokapen.

Ce se sincronizează

Către Mokapen (import / webhook)

• Clienți → Contacte — clienți WooCommerce în agendă (și companie dacă datele permit). Actualizări și prin webhook.
• Produse și variații → Produse — catalog cu variații; stocul WooCommerce (stock_quantity) se mapează pe cantitatea variantă Mokapen.
• Comenzi → Comenzi — comenzile WooCommerce devin comenzi de vânzare în Mokapen (cu linii), nu deal-uri în pipeline. Webhook la actualizări.
• Coșuri abandonate / rapoarte — mențiuni de marketing sau intrări «În curând» în UI nu echivalează cu un import de raportare coșuri deja activ ca în alte fluxuri: nu le considerați funcție completă dacă pe pagină apar încă ca în curând.

Către WooCommerce (export)

• Produse — cu direcția sync «către WooCommerce» sau «ambele», Mokapen poate exporta/actualiza produse în magazin (sync bulk și sync-out la salvarea produsului, dacă integrarea este activă).
• Contacte și comenzi în ieșire — ca la Shopify, exportul automat «sync out» implementat astăzi se referă în practică la produse. Clienții ajung mai ales din WooCommerce către Mokapen (import + webhook). Nu presupuneți un export bidirecțional complet al contactelor doar pentru că textul comercial sugerează: verificați după conectare.

În config apare și serviciile, dar nu există sync dedicat servicii: pentru catalogul magazinului folosiți Produsele.

Setări după conectare

Pe pagina WooCommerce, cu magazin conectat:

Direcție sync

• Doar către Mokapen — WooCommerce → CRM.
• Ambele — import + export (unde este suportat; astăzi mai ales produse în ieșire).
• Doar către WooCommerce — Mokapen → magazin (produse).

Entități

Contacte, comenzi și produse sunt domeniile de sync (adesea preselectate și nemodificabile din UI).

Partajare sync

Cine a conectat poate partaja conexiunea cu întreaga organizație sau utilizatori selectați.

Duplicate și conflicte

• Evitați duplicatele — de obicei recunoaștere contacte după email.
• În caz de conflict — câștigă WooCommerce sau Mokapen.

Confidențialitate (WooCommerce)

Față de Shopify, pe pagina WooCommerce puteți găsi și controale de confidențialitate și colaboratori/stakeholderi legate de vizibilitatea datelor sincronizate în org. Setați-le dacă echipa nu trebuie să vadă întreg catalogul/clienții importați la fel.

Sync automat vs manual

Activați sync automat pentru actualizări continue (împreună cu webhook-urile); folosiți sync manual pentru încărcarea istorică. Bifați autorizarea datelor pe pagină înainte de sincronizare.

Flux recomandat

1. Verificați HTTPS și WooCommerce actualizat pe site.
2. Conectați magazinul din Integrări → WooCommerce și finalizați WC Auth.
3. Setați direcția sync, duplicate, conflicte, confidențialitate (dacă există) și partajare.
4. Autorizați și lansați primul sync.
5. Verificați Contacte, Produse (variații/stoc), Comenzi în Mokapen.
6. Lăsați webhook-urile active pentru evenimente noi fără a relansa totul de fiecare dată.

Deconectare

Din Integrări → WooCommerce → deconectați. În modal alegeți dacă păstrați în Mokapen contactele, comenzile și produsele deja importate. După deconectare webhook-urile nu mai actualizează; datele deja în CRM rămân dacă le-ați păstrat. Puteți revoca cheile/autorizările și din panoul WordPress.

Probleme frecvente

• URL nevalid / fără HTTPS — folosiți adresa completă a site-ului cu https://.
• Autorizare eșuată — este necesar un admin WordPress; verificați că WooCommerce și permalink-urile REST funcționează (firewall/plugin-uri de securitate pot bloca WC Auth sau webhook-urile).
• Buton blocat / upgrade — este necesar un plan Premium adecvat e-commerce-ului.
• Comenzi nu în Oportunități — este corect: merg în Comenzi (Vânzări → Comenzi).
• Stoc / cantitate — vine din stock_quantity al variațiilor; nu este un WMS complet.
• Webhook-uri care nu sosesc — site-ul trebuie să fie accesibil de pe internet; mediile locale sau cu basic auth adesea nu primesc notificările WooCommerce.

Întrebări frecvente

Î: Trebuie să generez manual cheile API în WooCommerce?

R: Nu. Folosiți fluxul WC Auth din pagina Integrări Mokapen: cheile se creează și se salvează la revenirea din autorizare.

Î: Comenzile WooCommerce devin oportunități?

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

Î: Pot actualiza produsele WooCommerce din Mokapen?

R: Da, cu direcție sync care include exportul și integrarea activă.

Î: Care este diferența față de Shopify?

R: Același model de date (contacte, produse, comenzi) și aceeași logică Premium e-commerce. Se schimbă conexiunea: Shopify folosește OAuth în aplicația Shopify; WooCommerce folosește WC Auth pe URL-ul site-ului WordPress. Consultați și ghidul Shopify.

Î: Este necesar HTTPS?

R: Da. Fără HTTPS conexiunea și webhook-urile nu sunt fiabile (și validarea URL poate eșua).