Κέντρο βοήθειας
Ενσωματώσεις chatbot

Ενσωμάτωση με το Shopify

Τελευταία ενημέρωση:

Συνδέστε το chatbot σας στο ChatLab με το κατάστημά σας στο Shopify για να προσφέρετε στους πελάτες σας πρόσβαση σε πραγματικό χρόνο σε πληροφορίες προϊόντων και παρακολούθηση παραγγελιών απευθείας μέσα από τη συνομιλία.

Σημαντικό: Βέλτιστες πρακτικές E-Commerce

Αφού ολοκληρώσετε την παρακάτω σύνδεση, διαβάστε τον αναλυτικό οδηγό σχετικά με τη βελτιστοποίηση του chatbot σας για το ηλεκτρονικό εμπόριο: Πώς να ρυθμίσετε το ChatLab για το κατάστημά σας E-commerce

Τι παρέχει η ενσωμάτωση

Αναζήτηση προϊόντων - Οι πελάτες μπορούν να πραγματοποιήσουν αναζήτηση στον κατάλογο του Shopify πληκτρολογώντας μια φράση. Το chatbot αναζητά σε τίτλους προϊόντων, περιγραφές, τύπους, ετικέτες και προμηθευτές, επιστρέφοντας τα αντίστοιχα ενεργά προϊόντα με:

  • Όνομα προϊόντος, περιγραφή και τύπο
  • Προμηθευτή και ετικέτες
  • Τιμή ή εύρος τιμών (για προϊόντα με πολλαπλές παραλλαγές)
  • Διαθέσιμες παραλλαγές με SKU, αρχική τιμή σύγκρισης (compare-at price), ποσότητα αποθέματος και κατάσταση διαθεσιμότητας
  • Εικόνα προϊόντος και απευθείας σύνδεσμο προς το κατάστημά σας

Μπορείτε να ρυθμίσετε την αναζήτηση προϊόντων ώστε να εμφανίζει μόνο προϊόντα σε απόθεμα. Όταν ενεργοποιηθεί, τα προϊόντα που έχουν εξαντληθεί εξαιρούνται από τα αποτελέσματα. Μια πρόσθετη επιλογή σάς επιτρέπει να συμπεριλάβετε προϊόντα διαθέσιμα για προπαραγγελία, ακόμη και όταν το φίλτρο αποθέματος είναι ενεργό. Ανατρέξτε στο Βήμα 4 για λεπτομέρειες.

Στοιχεία παραγγελίας - Οι πελάτες μπορούν να ελέγξουν την κατάσταση της παραγγελίας τους παρέχοντας τον αριθμό παραγγελίας και τη διεύθυνση ηλεκτρονικού ταχυδρομείου τους. Και οι δύο τιμές επαληθεύονται με βάση τα αρχεία του καταστήματός σας στο Shopify. Το chatbot επιστρέφει:

  • Κωδικό αναφοράς παραγγελίας, ημερομηνία, σύνολο και νόμισμα
  • Προϊόντα παραγγελίας με ονόματα, ποσότητες, τιμές, SKU, τίτλο παραλλαγής και προμηθευτή
  • Κατάσταση εκτέλεσης και πληροφορίες παρακολούθησης αποστολής (αριθμός αποστολής, μεταφορική εταιρεία, URL)
  • Διεύθυνση αποστολής και διεύθυνση χρέωσης
  • Μέθοδο αποστολής και κόστος
  • Στοιχεία επικοινωνίας πελάτη (email, όνομα, τηλέφωνο)
  • Αιτία και ημερομηνία ακύρωσης (για ακυρωμένες παραγγελίες)

Βήμα 1: Δημιουργία διαπιστευτηρίων Shopify API

Σημαντικό για διαφημιστικές εταιρείες και συνεργάτες του Shopify: Η εφαρμογή Shopify ΠΡΕΠΕΙ να δημιουργηθεί στο Dev Dashboard του οργανισμού στον οποίο ανήκει το κατάστημα - ξεκινήστε πάντα από το περιβάλλον διαχείρισης του ίδιου του καταστήματος (Settings > Apps > Develop apps > Build apps in Dev Dashboard [Ρυθμίσεις > Εφαρμογές > Ανάπτυξη εφαρμογών > Δημιουργία εφαρμογών στο Dev Dashboard]). Μια εφαρμογή που δημιουργήθηκε από διαφορετικό οργανισμό (για παράδειγμα, από ένα πρακτορείο ή συνεργάτη του Shopify που εργάζεται στο δικό του Dev Dashboard) και εγκαταστάθηκε στο κατάστημα μέσω προσαρμοσμένου συνδέσμου εγκατάστασης ΔΕΝ θα λειτουργήσει με το ChatLab, παρόλο που η εγκατάσταση ολοκληρώνεται με επιτυχία και η εφαρμογή εμφανίζεται στις εγκατεστημένες εφαρμογές του καταστήματος με τα σωστά δικαιώματα. Ο λόγος: Το ChatLab συνδέεται χρησιμοποιώντας το Client ID και το Secret (μέθοδος χορήγησης client credentials του Shopify) και το Shopify επιτρέπει αυτή τη μέθοδο μόνο για εφαρμογές που έχουν αναπτυχθεί από τον οργανισμό στον οποίο ανήκει το κατάστημα - "Client credentials is only available for apps developed by your own organization and installed in stores that you own" (τεκμηρίωση Shopify). Πρόκειται για περιορισμό του Shopify και όχι του ChatLab. Το σύμπτωμα είναι η αποτυχία σύνδεσης στο ChatLab με το μήνυμα "The app cannot access this store. Create the app in the Dev Dashboard of the organization that owns this store" (που προκαλείται από το σφάλμα OAuth shop_not_permitted του Shopify), ακόμη και όταν το Client ID, το Secret και το υποτομέας (subdomain) του καταστήματος είναι απολύτως σωστά και η εφαρμογή είναι εγκατεστημένη. Χαρακτηριστικό σημάδι μιας εφαρμογής από άλλον οργανισμό: στη διαχείριση του καταστήματος εμφανίζεται η ένδειξη "This custom app was built by a Shopify partner for your store." Η λύση για τα πρακτορεία: δεν χρειάζεται να το κάνει ο προγραμματιστής του εμπόρου - ζητήστε από τον έμπορο να προσθέσει τον λογαριασμό χρήστη σας στον ΔΙΚΟ ΤΟΥ οργανισμό με τον ρόλο App developer ("To give a user in a merchant store access to the Dev Dashboard, assign them the App developer role" - τεκμηρίωση Shopify) και, στη συνέχεια, δημιουργήστε την εφαρμογή ενώ εργάζεστε μέσα στον οργανισμό του εμπόρου. Η απλή πρόσβαση συνεργάτη (collaborator access) δεν επαρκεί - οι εφαρμογές που δημιουργούνται ενώ εργάζεστε στον δικό σας οργανισμό παραμένουν στον δικό σας οργανισμό.

  1. Συνδεθείτε στον πίνακα διαχείρισης του Shopify
  2. Μεταβείτε στην ενότητα Settings > Apps
  3. Κάντε κλικ στην επιλογή Develop apps
  4. Στη σελίδα App Development, κάντε κλικ στην επιλογή Build apps in Dev Dashboard - αυτό θα ανοίξει τη σελίδα dev.shopify.com/dashboard
  5. Κάντε κλικ στην επιλογή Create app και πληκτρολογήστε ένα όνομα (π.χ. "ChatLab Integration")

App development in Shopify

  1. Μόλις δημιουργηθεί, μετακινηθείτε στην ενότητα Access και κάντε κλικ στην επιλογή Select scopes

App access scopes in Shopify

  1. Κάτω από τα πεδία πρόσβασης Admin API, βρείτε και ενεργοποιήστε αυτά τα δικαιώματα:
    • read_products
    • read_orders
  2. Κάντε κλικ στην επιλογή Done

App access scopes to read products and orders in Shopify

  1. Κάντε κλικ στο κουμπί Release για να εκδώσετε την εφαρμογή σας
  2. Μεταβείτε στις ρυθμίσεις App settings και αντιγράψτε τα Client ID και Secret - αποθηκεύστε τα με ασφάλεια, καθώς θα τα χρειαστείτε για να συνδεθείτε με το ChatLab

App settings in Shopify

  1. Μεταβείτε στην ενότητα Home και κάντε κλικ για να εγκαταστήσετε την εφαρμογή στο κατάστημά σας

App install in Shopify

  1. Επιλέξτε το κατάστημά σας και επιβεβαιώστε κάνοντας κλικ στην επιλογή Install

App install confirm in Shopify

Βήμα 2: Εύρεση του υποτομέα (subdomain) του καταστήματός σας

Το subdomain σας είναι το τμήμα πριν από το .myshopify.com στη διεύθυνση URL διαχείρισης του Shopify. Για παράδειγμα, αν η διεύθυνση διαχείρισης είναι https://pizza-delicious.myshopify.com/admin, τότε το subdomain σας είναι pizza-delicious.

Βήμα 3: Σύνδεση του Shopify στο ChatLab

  1. Συνδεθείτε στο ChatLab και επιλέξτε το bot σας
  2. Μεταβείτε στην καρτέλα Connect (Σύνδεση)

Connect tab showing the Shopify integration tile

  1. Κάντε κλικ στο κουμπί Connect στο πλαίσιο του Shopify
  2. Εισαγάγετε το Client ID σας (από το Βήμα 1)
  3. Εισαγάγετε το Secret σας (από το Βήμα 1)
  4. Εισαγάγετε το Shopify subdomain σας (από το Βήμα 2)

Shopify integration form with Client ID, Secret, and subdomain fields

  1. Κάντε κλικ στην επιλογή Connect

Το ChatLab ελέγχει αυτόματα τη σύνδεση επαληθεύοντας ότι τα διαπιστευτήρια API διαθέτουν τα απαιτούμενα πεδία πρόσβασης. Εάν η διαδικασία ολοκληρωθεί επιτυχώς, θα δείτε ένα μήνυμα επιβεβαίωσης.

Βήμα 4: Διαμόρφωση ενεργειών Shopify

Μετά τη σύνδεση, μπορείτε να ενεργοποιήσετε και να προσαρμόσετε μεμονωμένες ενέργειες AI. Μεταβείτε στην ενότητα Settings > Actions (Ρυθμίσεις > Ενέργειες) και φιλτράρετε με βάση την πλατφόρμα Shopify.

Shopify actions in Settings showing product search and order details

Διατίθενται δύο ενέργειες:

  • Shopify - product search - επιτρέπει στο chatbot να πραγματοποιεί αναζήτηση στον κατάλογο προϊόντων σας
  • Shopify - order details - επιτρέπει στο chatbot να αναζητά πληροφορίες παραγγελιών

Κάντε κλικ στο κουμπί ενεργοποίησης σε κάθε ενέργεια για να την θέσετε σε λειτουργία. Μπορείτε επίσης να προσαρμόσετε την ετικέτα ενέργειας (το μήνυμα που εμφανίζεται στους χρήστες κατά την εκτέλεση της ενέργειας) και τις οδηγίες που καθοδηγούν τον τρόπο με τον οποίο το AI χρησιμοποιεί την εκάστοτε ενέργεια.

Αναζήτηση προϊόντων - Ρυθμίσεις αποθέματος

Η ενέργεια αναζήτησης προϊόντων περιλαμβάνει επιλογές φιλτραρίσματος αποθέματος στην καρτέλα Product Search Settings:

  • Products in stock only - Όταν είναι ενεργοποιημένο, το chatbot επιστρέφει μόνο προϊόντα που βρίσκονται αυτή τη στιγμή σε απόθεμα. Τα προϊόντα που έχουν εξαντληθεί εξαιρούνται από τα αποτελέσματα αναζήτησης.
  • Show products available for pre-order - Αυτή η επιλογή εμφανίζεται όταν είναι ενεργοποιημένο το "Products in stock only". Όταν είναι ενεργή, τα προϊόντα που έχουν εξαντληθεί αλλά έχουν ρυθμιστεί στο Shopify ώστε να συνεχίζεται η πώλησή τους (προπαραγγελία), θα εξακολουθούν να εμφανίζονται στα αποτελέσματα αναζήτησης, με επισήμανση ότι είναι διαθέσιμα για προπαραγγελία.

Δοκιμή της ενσωμάτωσής σας

Αφού ενεργοποιήσετε τις ενέργειες, ανοίξτε το widget του chatbot και δοκιμάστε:

  • "Show me running shoes" (ελέγχει την αναζήτηση προϊόντων)
  • "What's the status of my order #1001?" (ελέγχει τα στοιχεία παραγγελίας)

Επαληθεύστε ότι οι απαντήσεις αντιστοιχούν στα δεδομένα από το κατάστημά σας στο Shopify και ότι οι σύνδεσμοι προϊόντων ανοίγουν σωστά.

Εγκατάσταση του chatbot στο κατάστημά σας στο Shopify

Για να προσθέσετε το widget συνομιλίας στη βιτρίνα του καταστήματός σας στο Shopify:

  1. Στο ChatLab, μεταβείτε στην καρτέλα Deploy (Δημοσίευση) για το bot σας
  2. Επιλέξτε την καρτέλα πλατφόρμας Shopify
  3. Αντιγράψτε το απόσπασμα κώδικα (code snippet)
  4. Στη διαχείριση του Shopify, μεταβείτε στην ενότητα Online Store > Themes
  5. Κάντε κλικ στο μενού με τις τρεις κουκκίδες στο ενεργό σας θέμα και επιλέξτε Edit code
  6. Ανοίξτε το αρχείο theme.liquid κάτω από την ενότητα Layout
  7. Επικολλήστε το απόσπασμα κώδικα μέσα στην ενότητα <head>
  8. Κάντε κλικ στην επιλογή Save

Στο τέλος - θα πρέπει να ενεργοποιήσετε τις διαθέσιμες ενέργειες AI Actions για το Shopify - Order details και Product Search.