Ο οδηγός Mokapen

WooCommerce

Συνδέστε το κατάστημα WooCommerce (WordPress) με το Mokapen για να φέρετε στο CRM πελάτες (επαφές), προϊόντα (με παραλλαγές και απόθεμα) και παραγγελίες καταστήματος, και να εξαγάγετε προϊόντα που δημιουργήθηκαν ή ενημερώθηκαν στο Mokapen στο WooCommerce όταν η κατεύθυνση συγχρονισμού το επιτρέπει. Ίδιος στόχος με το Shopify: ενοποίηση e-commerce και διαχείρισης πωλήσεων στον ίδιο χώρο εργασίας.

Γενική επισκόπηση: Ενσωματώσεις. Οι εισαγμένες παραγγελίες γίνονται παραγγελίες πωλήσεων στο Mokapen (ενότητα Παραγγελίες), όχι ευκαιρίες pipeline.

Απαιτήσεις

• Ιστότοπος WordPress με ενεργό WooCommerce, προσβάσιμος μέσω HTTPS.
• Άδεια εξουσιοδότησης του Mokapen μέσω ροής WC Auth (διαχειριστής WordPress / WooCommerce).
• Κατάλληλο πλάνο Mokapen Premium για ενσωματώσεις e-commerce. Χωρίς πλάνο, το κουμπί σύνδεσης ανοίγει την οθόνη αναβάθμισης.
• Δικαιώματα Mokapen σε επαφές, προϊόντα και παραγγελίες στον οργανισμό σας (δείτε Ρόλοι και δικαιώματα).
• Πρόσβαση στις Ενσωματώσεις (μέλος/διαχειριστής ανάλογα με white-label και ρόλο οργανισμού).

Σύνδεση καταστήματος WooCommerce

1. Μενού χρήστη → Ενσωματώσεις → WooCommerce.
2. Εισαγάγετε τη διεύθυνση ιστού του καταστήματος (URL ιστότοπου, π.χ. https://yourdomain.com). Τη βρίσκεται στη γραμμή διευθύνσεων όταν είστε στο backend WordPress / βιτρίνα WooCommerce.
3. Ξεκινήστε την εξουσιοδότηση: ανακατευθύνεστε στο WordPress/WooCommerce στη σελίδα WC Auth (/wc-auth/v1/authorize) με εύρος read_write.
4. Αποδεχτείτε τη δημιουργία API keys για το Mokapen (consumer key / secret αποθηκεύονται κρυπτογραφημένα στο Mokapen — δεν υπάρχει χειροκίνητη φόρμα «επικόλληση API key»).
5. Επιστρέψτε στο Mokapen: το κατάστημα είναι συνδεδεμένο. Το Mokapen καταχωρεί webhooks WooCommerce (/wp-json/wc/v3/webhooks) για ενημερώσεις σε πραγματικό χρόνο.

Αν δεν αποδεχτείτε την εξουσιοδότηση, δεν συγχρονίζονται δεδομένα. Το URL πρέπει να είναι έγκυρο και HTTPS: διαφορετικά η επικύρωση αποτυγχάνει.

Τι ζητά το Mokapen από το WooCommerce

Η ροή WC Auth παραχωρεί στο Mokapen πρόσβαση ανάγνωσης/εγγραφής στα REST API WooCommerce που χρειάζονται για πελάτες, προϊόντα (και παραλλαγές), παραγγελίες και webhooks. Το Mokapen δεν αντικαθιστά το πάνελ WooCommerce/WordPress για θέματα, πληρωμές ή plugins: ευθυγραμμίζει δεδομένα προς (και, για προϊόντα, από) το CRM.

Αν ανακαλέσετε κλειδιά ή αφαιρέσετε την εξουσιοδότηση στο WordPress, αποσυνδέστε και επανασυνδέστε από το Mokapen.

Τι συγχρονίζεται

Προς Mokapen (εισαγωγή / webhook)

• Πελάτες → Επαφές — πελάτες WooCommerce στο βιβλίο διευθύνσεων (και εταιρεία αν τα δεδομένα το επιτρέπουν). Ενημερώσεις και μέσω webhook.
• Προϊόντα και παραλλαγές → Προϊόντα — κατάλογος με παραλλαγές· το απόθεμα WooCommerce (stock_quantity) αντιστοιχίζεται στην ποσότητα παραλλαγής Mokapen.
• Παραγγελίες → Παραγγελίες — παραγγελίες WooCommerce γίνονται παραγγελίες πωλήσεων στο Mokapen (με γραμμές), όχι deals pipeline. Webhooks σε ενημερώσεις.
• Εγκαταλειμμένα καλάθια / αναφορές — αναφορές marketing ή καταχωρήσεις «Coming soon» στο UI δεν ισοδυναμούν με ενεργή εισαγωγή αναφορών καλαθιού όπως άλλες ροές: μην τις μετράτε ως πλήρη λειτουργία αν εμφανίζονται ακόμα ως coming soon στη σελίδα.

Προς WooCommerce (εξαγωγή)

• Προϊόντα — με κατεύθυνση συγχρονισμού «προς WooCommerce» ή «και τα δύο», το Mokapen μπορεί να εξαγάγει/ενημερώσει προϊόντα στο κατάστημα (μαζικός συγχρονισμός και sync-out σε αποθήκευση προϊόντος, αν η ενσωμάτωση είναι ενεργή).
• Εξερχόμενες επαφές και παραγγελίες — όπως στο Shopify, η αυτόματη εξαγωγή «sync out» που εφαρμόζεται σήμερα αφορά στην πράξη τα προϊόντα. Οι πελάτες έρχονται κυρίως από WooCommerce στο Mokapen (εισαγωγή + webhook). Μην υποθέτετε πλήρη αμφίδρομη εξαγωγή επαφών μόνο επειδή το εμπορικό κείμενο το υποδηλώνει: επαληθεύστε μετά τη σύνδεση.

Η διαμόρφωση δείχνει επίσης υπηρεσίες, αλλά δεν υπάρχει ειδικός συγχρονισμός υπηρεσιών: χρησιμοποιήστε Προϊόντα για τον κατάλογο καταστήματος.

Ρυθμίσεις μετά τη σύνδεση

Στη σελίδα WooCommerce, με συνδεδεμένο κατάστημα:

Κατεύθυνση συγχρονισμού

• Μόνο προς Mokapen — WooCommerce → CRM.
• Και τα δύο — εισαγωγή + εξαγωγή (όπου υποστηρίζεται· σήμερα κυρίως εξερχόμενα προϊόντα).
• Μόνο προς WooCommerce — Mokapen → κατάστημα (προϊόντα).

Οντότητες

Επαφές, παραγγελίες και προϊόντα είναι τα πεδία συγχρονισμού (συχνά προεπιλεγμένα και μη επεξεργάσιμα από το UI).

Κοινοποίηση συγχρονισμού

Όποιος συνέδεσε μπορεί να κοινοποιήσει τη σύνδεση σε ολόκληρο τον οργανισμό ή σε επιλεγμένους χρήστες.

Διπλότυπα και συγκρούσεις

• Αποφυγή διπλότυπων — συνήθως αναγνώριση επαφής μέσω email.
• Σε περίπτωση σύγκρουσης — κερδίζει το WooCommerce ή το Mokapen.

Απόρρητο (WooCommerce)

Σε αντίθεση με το Shopify, στη σελίδα WooCommerce μπορείτε επίσης να βρείτε στοιχεία ελέγχου απορρήτου και συνεργατών/stakeholder σχετικά με το πώς είναι ορατά τα συγχρονισμένα δεδομένα στον οργανισμό. Ρυθμίστε τα αν η ομάδα δεν πρέπει να βλέπει όλο τον εισαγμένο κατάλογο/πελάτες με τον ίδιο τρόπο.

Αυτόματος έναντι χειροκίνητου συγχρονισμού

Ενεργοποιήστε αυτόματο συγχρονισμό για συνεχείς ενημερώσεις (μαζί με webhooks)· χρησιμοποιήστε χειροκίνητο συγχρονισμό για το ιστορικό φορτίο. Ελέγξτε την εξουσιοδότηση δεδομένων στη σελίδα πριν τον συγχρονισμό.

Προτεινόμενη ροή

1. Επαληθεύστε HTTPS και ενημερωμένο WooCommerce στον ιστότοπο.
2. Συνδέστε το κατάστημα από Ενσωματώσεις → WooCommerce και ολοκληρώστε το WC Auth.
3. Ορίστε κατεύθυνση συγχρονισμού, διπλότυπα, συγκρούσεις, απόρρητο (αν υπάρχει) και κοινοποίηση.
4. Εξουσιοδοτήστε και ξεκινήστε τον πρώτο συγχρονισμό.
5. Ελέγξτε Επαφές, Προϊόντα (παραλλαγές/απόθεμα), Παραγγελίες στο Mokapen.
6. Κρατήστε τα webhooks ενεργά για νέα συμβάντα χωρίς επανεκκίνηση όλων κάθε φορά.

Αποσύνδεση

Από Ενσωματώσεις → WooCommerce → αποσύνδεση. Στο παράθυρο επιλέξτε αν θα διατηρήσετε επαφές, παραγγελίες και προϊόντα ήδη εισαγμένα στο Mokapen. Μετά την αποσύνδεση, τα webhooks δεν ενημερώνουν πλέον· δεδομένα ήδη στο CRM παραμένουν αν τα διατηρήσατε. Μπορείτε επίσης να ανακαλέσετε κλειδιά/εξουσιοδοτήσεις από το πάνελ WordPress.

Συχνά προβλήματα

• Μη έγκυρο URL / όχι HTTPS — χρησιμοποιήστε την πλήρη διεύθυνση ιστότοπου με https://.
• Αποτυχία εξουσιοδότησης — απαιτείται διαχειριστής WordPress· επαληθεύστε ότι WooCommerce και REST permalinks λειτουργούν (firewall/plugins ασφαλείας μπορεί να μπλοκάρουν WC Auth ή webhooks).
• Κουμπί αποκλεισμένο / αναβάθμιση — απαιτείται κατάλληλο πλάνο Premium για e-commerce.
• Παραγγελίες όχι στις Ευκαιρίες — αυτό είναι σωστό: πηγαίνουν στις Παραγγελίες (Πωλήσεις → Παραγγελίες).
• Απόθεμα / ποσότητα — προέρχεται από stock_quantity παραλλαγής· δεν είναι πλήρες WMS.
• Webhooks δεν φτάνουν — ο ιστότοπος πρέπει να είναι προσβάσιμος από το διαδίκτυο· τοπικά ή basic-auth περιβάλλοντα συχνά δεν λαμβάνουν ειδοποιήσεις WooCommerce.

Συχνές ερωτήσεις

Q: Πρέπει να δημιουργήσω API keys χειροκίνητα στο WooCommerce;

A: Όχι. Χρησιμοποιήστε τη ροή WC Auth από τη σελίδα Ενσωματώσεων Mokapen: τα κλειδιά δημιουργούνται και αποθηκεύονται όταν επιστρέφετε από την εξουσιοδότηση.

Q: Οι παραγγελίες WooCommerce γίνονται ευκαιρίες;

A: Όχι. Στο Mokapen γίνονται παραγγελίες πωλήσεων. Κείμενο που αναφέρεται σε «ευκαιρίες» είναι ανακριβές σε σχέση με την τρέχουσα συμπεριφορά.

Q: Μπορώ να ενημερώσω προϊόντα WooCommerce από το Mokapen;

A: Ναι, με κατεύθυνση συγχρονισμού που περιλαμβάνει εξαγωγή και ενεργή ενσωμάτωση.

Q: Διαφορά από το Shopify;

A: Ίδιο μοντέλο δεδομένων (επαφές, προϊόντα, παραγγελίες) και ίδια λογική Premium e-commerce. Η σύνδεση διαφέρει: το Shopify χρησιμοποιεί OAuth στην εφαρμογή Shopify· το WooCommerce χρησιμοποιεί WC Auth στο URL του ιστότοπου WordPress. Δείτε επίσης τον οδηγό Shopify.

Q: Απαιτείται HTTPS;

A: Ναι. Χωρίς HTTPS η σύνδεση και τα webhooks δεν είναι αξιόπιστα (και η επικύρωση URL μπορεί να αποτύχει).