Τι κάνουν τα webhooks
Ένα webhook εγγράφεται σε ένα συγκεκριμένο συμβάν του καταστήματος. Όταν συμβεί αυτό το συμβάν, το Storeep στέλνει αμέσως τα δεδομένα του συμβάντος σε μια διεύθυνση URL που ορίζετε (API τύπος) ή σε μια διεύθυνση email που ορίζετε (E-mail τύπος). Τα webhooks χρησιμοποιούνται συχνά για ενσωματώσεις παρακολούθησης παραγγελιών, συγχρονισμούς CRM, μετατροπές διαφημιστικών πλατφορμών και αυτοματοποιημένες ειδοποιήσεις.
Για να διαχειριστείτε webhooks, μεταβείτε στις Ρυθμίσεις → Webhooks. Χρειάζεστε το δικαίωμα settings για να δείτε ή να αλλάξετε webhooks.
Όρια webhook
- Μέγιστο 20 webhooks ανά κατάστημα. Αν προσπαθήσετε να προσθέσετε 21ο, εμφανίζεται το σφάλμα "You have reached the maximum of 20 webhooks per store".
- Η λίστα εμφανίζει τα webhooks με τα πιο πρόσφατα πρώτα, με σελιδοποίηση 40 ανά σελίδα.
Δημιουργία webhook
Κάντε κλικ στο Προσθήκη νέου webhook, συμπληρώστε τα παρακάτω πεδία και μετά πατήστε Προσθήκη.
Ενεργοποίηση
Επιλεγμένο από προεπιλογή. Όταν είναι επιλεγμένο, το webhook είναι ενεργό μόλις το αποθηκεύσετε και τα αντίστοιχα συμβάντα αποστέλλονται. Αν το αποεπιλέξετε, το webhook αποθηκεύεται απενεργοποιημένο και δεν λαμβάνει τίποτα. Μπορείτε να το αλλάξετε οποιαδήποτε στιγμή επεξεργάζοντας το webhook.
Όνομα
- Υποχρεωτικό. Μέγιστο 50 χαρακτήρες.
- Περιγραφική ετικέτα που εμφανίζεται στη λίστα, π.χ. Facebook CAPI order created.
Τύπος
- API: Το Storeep στέλνει ένα HTTP POST με τα δεδομένα του συμβάντος στη διεύθυνση URL σας.
- E-mail: Το Storeep στέλνει email με τα δεδομένα του συμβάντος στη διεύθυνσή σας.
Συμβάν
Το συμβάν του καταστήματος που ενεργοποιεί το webhook. Υπάρχουν τρία συμβάντα:
- Session created: δημιουργείται νέα συνεδρία επισκέπτη στο κατάστημά σας.
- Order created: καταχωρείται νέα παραγγελία.
- Order updated: αλλάζει η κατάσταση ή τα δεδομένα υπάρχουσας παραγγελίας.
Σημαντικό: ο τύπος E-mail στέλνει μόνο τα Order created και Order updated. Αν επιλέξετε E-mail με Session created, το webhook αποθηκεύεται αλλά δεν στέλνει τίποτα. Χρησιμοποιήστε τον τύπο API αν χρειάζεστε το συμβάν συνεδρίας.
Μορφή
Υπάρχει μόνο η επιλογή Json: το περιεχόμενο αποστέλλεται ως έγγραφο JSON.
URL (μόνο για τύπο API)
- Υποχρεωτικό όταν ο τύπος είναι API. Μέγιστο 500 χαρακτήρες.
- Το πεδίο εμφανίζει το πρόθεμα
https://για εσάς, οπότε εισάγετε μόνο το host και το path, π.χ.api.example.com/events/order. Αν επικολλήσετε πλήρη διεύθυνσηhttps://ήhttp://, το πρόθεμα αφαιρείται πριν την αποθήκευση. - Δυναμικά placeholders: εισάγετε οποιοδήποτε πεδίο από τα δεδομένα του συμβάντος στη διεύθυνση URL με σύνταξη διπλής αγκύλης
{{field_name}}. Παράδειγμα:example.com/postback?cid={{fbclid}}&payout={{order_total}}. Οι τιμές κωδικοποιούνται για URL και αν λείπει κάποιο πεδίο, το placeholder γίνεται κενό. Έτσι μπορείτε να στείλετε δεδομένα μετατροπής απευθείας σε διαφημιστική πλατφόρμα χωρίς proxy. - Η διεύθυνση ελέγχεται αφού αφαιρεθούν τα placeholders, οπότε μια μη έγκυρη URL εμφανίζει "The url you have entered is incorrect".
Διεύθυνση email (μόνο για τύπο E-mail)
- Υποχρεωτική όταν ο τύπος είναι E-mail. Πρέπει να είναι έγκυρη διεύθυνση, μέγιστο 127 χαρακτήρες.
Επεξεργασία webhook
Κάντε κλικ σε οποιαδήποτε γραμμή για να ανοίξετε τον επεξεργαστή. Όλα τα πεδία είναι επεξεργάσιμα. Το πεδίο URL συμπληρώνεται μόνο αν ο αποθηκευμένος τύπος είναι API, και το πεδίο email μόνο αν είναι E-mail. Πατήστε Αποθήκευση για να εφαρμόσετε. Αν αποθηκεύσετε με απενεργοποιημένο το Ενεργοποίηση, το webhook απενεργοποιείται χωρίς να διαγραφεί.
Στήλες λίστας webhooks
- Όνομα: η ετικέτα με την ημερομηνία δημιουργίας.
- URL / E-mail: ο προορισμός.
- Τύπος: API ή E-mail.
- Συμβάν: Session created, Order created ή Order updated.
- Μορφή: Json.
- Κατάσταση: Ενεργό ή Ανενεργό.
Διαγραφή webhook
Επιλέξτε μία ή περισσότερες γραμμές και πατήστε Διαγραφή webhooks. Η διαγραφή είναι οριστική και σταματά κάθε μελλοντική αποστολή για αυτή τη συνδρομή.
Παράδοση, επαναπροσπάθειες και email αποτυχίας
Αυτή η ενότητα ισχύει για webhooks τύπου API. Τα E-mail webhooks στέλνονται μία φορά χωρίς retry και χωρίς παρακολούθηση αποτυχίας.
Συμπεριφορά επαναπροσπάθειας
- Κάθε αίτημα έχει όριο χρόνου 5 δευτερόλεπτα. Αν ο προορισμός επιστρέψει 5xx σφάλμα, 429 (rate limited), ή δεν είναι προσβάσιμος (σφάλμα σύνδεσης), η παράδοση θεωρείται προσωρινή αποτυχία και επαναλαμβάνεται.
- Μετά την πρώτη αποτυχία, το Storeep επαναπροσπαθεί με εκθετική καθυστέρηση έως 5 φορές: περίπου 30s, 60s, 120s, 240s, και 480s αργότερα. Μετά την τελευταία προσπάθεια, το συμβάν απορρίπτεται.
- Απάντηση 4xx εκτός από 429 (π.χ. 404 ή 403) θεωρείται μόνιμη αποτυχία. Το Storeep δεν επαναπροσπαθεί, γιατί ένα λάθος ή απορριπτικό endpoint δεν θα διορθωθεί μόνο του.
- Αν έχετε πολλά webhooks στο ίδιο συμβάν, η επαναπροσπάθεια στέλνει ξανά μόνο σε όσα απέτυχαν. Τα endpoints που ήδη επέστρεψαν επιτυχία παραλείπονται, ώστε να μην λάβετε διπλές παραδόσεις.
Email ειδοποίησης αποτυχίας
- Το Storeep μετρά διαδοχικές αποτυχίες ανά webhook. Μετά από 5 διαδοχικές αποτυχίες, ο ιδιοκτήτης του καταστήματος λαμβάνει ένα email με τίτλο "Action needed: your Storeep webhook is failing", στη γλώσσα του ιδιοκτήτη, με το όνομα του webhook, τον προορισμό, το συμβάν και τον τελευταίο HTTP status code.
- Λαμβάνετε ακριβώς ένα email ανά αποτυχημένη ακολουθία. Δεν αποστέλλονται άλλα email μέχρι να ανακάμψει το webhook.
- Μόλις μια παράδοση πετύχει ξανά, ο μετρητής αποτυχιών μηδενίζεται και η ειδοποίηση ενεργοποιείται ξανά, ώστε μια μελλοντική αποτυχία να μπορεί να σας ειδοποιήσει ξανά.
Συμβουλές και παγίδες
- Μπορείτε να δημιουργήσετε πολλά webhooks για το ίδιο συμβάν, π.χ. να στείλετε το Order created τόσο σε CRM όσο και σε διαφημιστική πλατφόρμα ως δύο ξεχωριστές εγγραφές.
- Αν το endpoint σας χρειάζεται αυθεντικοποίηση, βάλτε token στο query string της URL, είτε σταθερό είτε μέσω
{{placeholder}}από τα δεδομένα του συμβάντος, ή βάλτε proxy που προσθέτει το auth πριν προωθήσει. - Το Session created ενεργοποιείται για κάθε μοναδική συνεδρία επισκέπτη και μπορεί να έχει μεγάλο όγκο σε πολυσύχναστα καταστήματα. Εγγραφείτε μόνο αν το endpoint σας αντέχει τον ρυθμό, και θυμηθείτε ότι λειτουργεί μόνο με τύπο API.