Ο οδηγός Mokapen

Shopify

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

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

Απαιτήσεις

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

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

1. Μενού χρήστη → Ενσωματώσεις → Shopify.
2. Εισαγάγετε το όνομα καταστήματος (όπως στο Shopify Admin· το πλήρες URL τελειώνει σε myshopify.com). Αν δεν είστε βέβαιοι, ανοίξτε το ταμπλό Shopify και ελέγξτε τη γραμμή διευθύνσεων του προγράμματος περιήγησης.
3. Ξεκινήστε την εξουσιοδότηση: ανακατευθύνεστε στο Shopify για αποδοχή δικαιωμάτων.
4. Αποδεχτείτε τα ζητούμενα scopes (ανάγνωση/εγγραφή πελατών και προϊόντων, ανάγνωση παραγγελιών — δείτε παρακάτω).
5. Επιστρέψτε στο Mokapen: το κατάστημα εμφανίζεται συνδεδεμένο. Αν φτάνετε από το Shopify App Store, μπορεί να χρειαστεί να επιλέξετε τον οργανισμό Mokapen στον οποίο θα εγκατασταθεί η σύνδεση.

Αν δεν αποδεχτείτε στο Shopify, δεν συγχρονίζονται δεδομένα. Μετά τη σύνδεση, το Mokapen καταχωρεί webhooks στο κατάστημα: έτσι ενημερώσεις πελατών, προϊόντων και παραγγελιών μπορούν να φτάνουν σε πραγματικό χρόνο, επιπλέον του μαζικού συγχρονισμού που ξεκινάτε εσείς.

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

Κατά την εξουσιοδότηση OAuth το Mokapen ζητά συνήθως:

• read_customers / write_customers — ανάγνωση (και πιθανώς εγγραφή) πελατών Shopify.
• read_products / write_products — ανάγνωση και ενημέρωση προϊόντων/παραλλαγών.
• read_orders — ανάγνωση παραγγελιών καταστήματος.

Το Mokapen δεν αντικαθιστά το πάνελ Shopify για checkout, θέματα ή πληρωμές: ευθυγραμμίζει δεδομένα προς (και, για προϊόντα, από) το CRM. Αν ανακαλέσετε την εφαρμογή από το Shopify ή λήξει το token, αποσυνδέστε και επανασυνδέστε από το Mokapen. Το Shopify απαιτεί επίσης endpoints GDPR (data request / redact): το Mokapen τα χειρίζεται μέσω webhook.

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

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

• Πελάτες → Επαφές — κύρια δεδομένα Shopify μπαίνουν στο βιβλίο διευθύνσεων· αν υπάρχουν δεδομένα εταιρείας, μπορεί να δημιουργηθεί/συνδεθεί και η εταιρεία. Webhooks σε δημιουργία/ενημέρωση/διαγραφή πελάτη.
• Προϊόντα και παραλλαγές → Προϊόντα — κατάλογος με παραλλαγές· η ποσότητα αποθέματος παραλλαγής Shopify αντιστοιχίζεται στο πεδίο ποσότητας παραλλαγής Mokapen (όχι ξεχωριστή ενότητα αποθήκης).
• Παραγγελίες → Παραγγελίες — παραγγελίες Shopify γίνονται παραγγελίες πωλήσεων στο Mokapen (με γραμμές), όχι deals pipeline. Webhooks σε ενημερώσεις παραγγελιών.
• Εγκαταλειμμένα checkouts — ο συγχρονισμός μπορεί να περιλαμβάνει διαδρομή εισαγωγής εγκαταλειμμένων checkouts Shopify (ως παραγγελίες/σχετικά δεδομένα). Αφιερωμένες αναφορές για εγκαταλειμμένα καλάθια / αναλυτικά e-commerce στη σελίδα εμφανίζονται ακόμα ως Coming soon: μην τις μετράτε ως ενεργή λειτουργία ακόμη.

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

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

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

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

Στη σελίδα Shopify, με συνδεδεμένο κατάστημα, συνήθως διαμορφώνετε:

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

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

Οντότητες

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

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

Όποιος συνέδεσε το κατάστημα μπορεί να επιτρέψει σε άλλα μέλη να χρησιμοποιούν την ίδια σύνδεση (ολόκληρος οργανισμός ή επιλεγμένοι χρήστες), ώστε να μην επαναλαμβάνει ο καθένας το OAuth.

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

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

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

Με ενεργό αυτόματο συγχρονισμό, ενημερώσεις (και webhooks) κρατούν τα δεδομένα ευθυγραμμισμένα· μπορείτε ακόμα να ξεκινήσετε χειροκίνητο συγχρονισμό για το αρχικό ιστορικό φορτίο. Πριν τον συγχρονισμό, ελέγξτε την απαιτούμενη εξουσιοδότηση επεξεργασίας/κοινοποίησης δεδομένων στη σελίδα.

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

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

Αποσύνδεση

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

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

• Μη έγκυρο όνομα καταστήματος — χρησιμοποιήστε το υποτομέα *.myshopify.com, όχι μόνο τον προσαρμοσμένο τομέα βιτρίνας.
• Κουμπί αποκλεισμένο / αναβάθμιση — απαιτείται κατάλληλο πλάνο Premium για e-commerce.
• Παραγγελίες όχι στις Ευκαιρίες — αυτό είναι σωστό: πηγαίνουν στις Παραγγελίες. Ανοίξτε Πωλήσεις → Παραγγελίες.
• Ποσότητα προϊόντος — προέρχεται από την ποσότητα παραλλαγής Shopify· δεν είναι πλήρες WMS.
• Αναφορές καλαθιού / αναλυτικά — αν εμφανίζουν «Coming soon» στη σελίδα, δεν είναι ακόμα λειτουργικά.
• Ληγμένο token / σταματημένος συγχρονισμός — αποσυνδέστε και επανασυνδέστε· επαληθεύστε ότι η εφαρμογή δεν απεγκαταστάθηκε από το Shopify.

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

Q: Πού βρίσκω το URL καταστήματος;

A: Στη γραμμή διευθύνσεων του ταμπλό Shopify Admin: τελειώνει σε myshopify.com.

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

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

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

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

Q: Ενημερώνονται και οι επαφές από Mokapen προς Shopify;

A: Εισαγωγή και webhooks φέρνουν πελάτες Shopify στο CRM. Η αυτόματη εξαγωγή επαφών δεν είναι η κύρια διαδρομή σήμερα (σε αντίθεση με τα προϊόντα): επαληθεύστε στο πλάνο/περιβάλλον σας μετά τη σύνδεση.

Q: Χρειάζομαι WooCommerce παράλληλα με Shopify;

A: Όχι: είναι δύο εναλλακτικές ενσωματώσεις e-commerce. Χρησιμοποιήστε Shopify αν το κατάστημά σας είναι στο Shopify· δείτε τον οδηγό WooCommerce αν χρησιμοποιείτε WordPress/Woo.