Πώς ρυθμίζω webhooks για να στέλνω τις νέες παραγγελίες στο δικό μου σύστημα ή σε email;

Τι κάνει ένα webhook

Ένα webhook στέλνει τα στοιχεία ενός συμβάντος του καταστήματός σας σε άλλο σημείο τη στιγμή που συμβαίνει. Εσείς επιλέγετε το συμβάν και πού πηγαίνει:

• API: το Storeep στέλνει τα δεδομένα του συμβάντος σε μια διεύθυνση ιστού (URL) του διακομιστή σας, του CRM σας, ενός σεναρίου Zapier ή Make ή ενός εργαλείου παρακολούθησης διαφημίσεων.
• E-Mail: το Storeep στέλνει τα δεδομένα του συμβάντος σε μια διεύθυνση email, για παράδειγμα για να λαμβάνετε ένα email για κάθε νέα παραγγελία.

Ανοίξτε τις Ρυθμίσεις > Webhooks. Χρειάζεστε το δικαίωμα Ρυθμίσεις.

Πολλά εργαλεία έχουν ήδη έτοιμη εφαρμογή, που είναι πιο εύκολη: Google Sheets, δίκτυα courier και pixel διαφημίσεων. Ελέγξτε πρώτα την αγορά εφαρμογών.

Δημιουργία webhook

Κάντε κλικ στο Προσθήκη νέου webhook, συμπληρώστε τη φόρμα και κάντε κλικ στο Προσθήκη.

• Ενεργοποίηση: επιλεγμένο από προεπιλογή. Όταν είναι επιλεγμένο, τα συμβάντα στέλνονται αμέσως. Αποεπιλέξτε το για να κρατήσετε το webhook αλλά σε παύση.
• Όνομα: μια ετικέτα για τη λίστα σας, για παράδειγμα "Νέες παραγγελίες CRM".
• Τύπος: API ή E-Mail.
• Συμβάν:
  • Η παραγγελία δημιουργήθηκε: ένας πελάτης κάνει νέα παραγγελία.
  • Η παραγγελία ενημερώθηκε: αλλάζει η κατάσταση ή τα στοιχεία μιας παραγγελίας.
  • Σύνοδος που δημιουργήθηκε: ένας νέος επισκέπτης φτάνει στο κατάστημά σας. Μόνο για τύπο API.
• Μορφή: Json.
• URL (τύπος API): η διεύθυνση προς την οποία στέλνονται τα δεδομένα. Το τμήμα https:// προστίθεται για εσάς, οπότε πληκτρολογήστε το υπόλοιπο, όπως api.example.com/orders.
• Διεύθυνση email (τύπος E-mail): πού πηγαίνει το email.

Ένα webhook E-Mail στέλνει μόνο συμβάντα παραγγελιών. Αν επιλέξετε E-mail με Σύνοδος που δημιουργήθηκε, δεν στέλνεται τίποτα.

Δεδομένα παραγγελίας μέσα στο URL

Μπορείτε να βάλετε οποιοδήποτε πεδίο των δεδομένων του συμβάντος μέσα στο URL με διπλά άγκιστρα, {{field_name}}. Για παράδειγμα:

example.com/postback?cid={{fbclid}}&payout={{order_total}}

Αυτό στέλνει το αναγνωριστικό κλικ του Facebook και το σύνολο της παραγγελίας σε μια πλατφόρμα παρακολούθησης διαφημίσεων ή affiliate, χωρίς επιπλέον διακομιστή. Ένα πεδίο που δεν υπάρχει μένει κενό. Για να δείτε τα ονόματα των πεδίων, δημιουργήστε ένα webhook E-mail για το ίδιο συμβάν και δείτε τα δεδομένα που λαμβάνετε.

Η λίστα webhooks

Κάθε γραμμή δείχνει τις στήλες Όνομα, URL / E-mail, Τύπος, Συμβάν, Μορφή και Κατάσταση (Ενεργοποιήθηκε ή Απενεργοποιημένο). Κάντε κλικ σε μια γραμμή για να την επεξεργαστείτε. Επιλέξτε γραμμές και διαλέξτε Διαγραφή webhooks για να τις αφαιρέσετε οριστικά. Υπάρχει μέγιστος αριθμός webhooks ανά κατάστημα και βλέπετε μήνυμα όταν τον φτάσετε.

Μπορείτε να δημιουργήσετε αρκετά webhooks για το ίδιο συμβάν, για παράδειγμα ένα προς το CRM σας και ένα προς το εργαλείο παρακολούθησης διαφημίσεων.

Όταν μια παράδοση αποτυγχάνει

• Ο διακομιστής σας πρέπει να απαντά γρήγορα με κωδικό επιτυχίας (2xx). Μια αργή απάντηση μετράει ως αποτυχία.
• Αν ο διακομιστής σας είναι εκτός λειτουργίας ή απασχολημένος (απάντηση 5xx ή 429, ή καμία απάντηση), το Storeep ξαναδοκιμάζει αρκετές φορές τα επόμενα λεπτά. Ξαναστέλνονται μόνο τα webhooks που απέτυχαν, οπότε τα άλλα δεν λαμβάνουν διπλότυπα.
• Αν ο διακομιστής σας απορρίψει το αίτημα (απάντηση 4xx όπως 404 ή 403), το Storeep δεν ξαναδοκιμάζει, γιατί η διεύθυνση ή η ασφάλειά της είναι λάθος.
• Όταν ένα webhook αποτυγχάνει αρκετές φορές στη σειρά, ο ιδιοκτήτης του καταστήματος λαμβάνει ένα email: "Απαιτείται ενέργεια: το webhook σας στο Storeep αποτυγχάνει", με το όνομα, τη διεύθυνση, το συμβάν και τον τελευταίο κωδικό σφάλματος του webhook. Αφού το webhook λειτουργήσει ξανά, ένα μελλοντικό πρόβλημα μπορεί να στείλει νέα προειδοποίηση. Μπορείτε να απενεργοποιήσετε αυτό το email στις Ειδοποιήσεις.
• Τα webhooks E-mail στέλνονται μία φορά, χωρίς επανάληψη.

Webhooks σε παύση λόγω απλήρωτου υπολοίπου

Αν το κατάστημά σας έχει απλήρωτο οφειλόμενο ποσό και το πορτοφόλι σας δεν μπορεί να το καλύψει, τα webhooks περιμένουν. Στέλνονται αφού προσθέσετε κεφάλαια και εξοφληθεί το ποσό. Δείτε Πορτοφόλι και χρέωση.

Συμβουλές

• Αν ο διακομιστής σας χρειάζεται κωδικό ή κλειδί, βάλτε το στο query του URL, για παράδειγμα ?key=yoursecret.
• Το Σύνοδος που δημιουργήθηκε ενεργοποιείται για κάθε επισκέπτη, κάτι που μπορεί να είναι πολύ σε ένα πολυσύχναστο κατάστημα. Χρησιμοποιήστε το μόνο αν ο διακομιστής σας μπορεί να το αντέξει.
• Για να επιτρέψετε σε ένα εργαλείο να διαβάζει τις παραγγελίες και τα προϊόντα σας όποτε θέλει, χρησιμοποιήστε αντί γι' αυτό ένα διακριτικό πρόσβασης.