Webhooks στο API FoodSoul: Το CRM ενημερώνει αυτόματα τις υπηρεσίες σας για νέα συμβάντα

Τώρα το FoodSoul στέλνει αυτόματα ειδοποιήσεις στα συστήματά σας όταν κάτι συμβαίνει στο CRM. Για παράδειγμα, έφτασε νέα παραγγελία, ο πελάτης πλήρωσε ή επέστρεψε χρήματα, εγγράφηκε νέος επισκέπτης. Αρκεί να δηλώσετε μία φορά τη διεύθυνση της υπηρεσίας σας και τα δεδομένα θα αποστέλλονται αμέσως στο λογιστικό σας σύστημα, το bot σας, δεύτερο CRM ή την ανάλυση.

Για ποια γεγονότα μπορείτε να λαμβάνετε ειδοποιήσεις

1. Νέα παραγγελία με πλήρη κάρτα. Χρήσιμο για το λογιστικό σύστημα, την κουζίνα και την ανάλυση.
2. Αλλαγή κατάστασης παραγγελίας. Κατάλληλο για bot που ενημερώνει τον πελάτη για την παραγγελία και για το τηλεφωνικό κέντρο.
3. Αλλαγή κατάστασης πληρωμής, συμπεριλαμβανομένης της επιστροφής. Απαραίτητο για τη λογιστική και την οικονομική διαχείριση.
4. Νέος πελάτης και αλλαγή των στοιχείων του. Για εξωτερικό CRM και υπηρεσίες αποστολής ενημερώσεων.
5. Πίστωση, χρέωση και λήξη πόντων. Για το πρόγραμμα επιβράβευσης και την επικοινωνία με τους επισκέπτες.
6. Νέα αξιολόγηση. Για τον διαχειριστή και την υπηρεσία ποιότητας.
7. Ανάθεση διανομέα. Για τη λογιστική και τις ειδοποιήσεις προς τον πελάτη.
8. Αλλαγή στη λίστα διακοπής προϊόντων. Για την ιστοσελίδα, την κουζίνα και τις πλατφόρμες πώλησης.
9. Το κατάστημα σταμάτησε ή επανέλαβε τη λήψη παραγγελιών. Για τον επιχειρησιακό έλεγχο και τη διοίκηση του δικτύου.

Εσείς επιλέγετε ποια γεγονότα θα λαμβάνετε. Μπορείτε να ενεργοποιήσετε μόνο όσα χρειάζεστε, για παράδειγμα “νέα παραγγελία” και “πληρωμή”. Δεν βρήκατε το γεγονός που χρειάζεστε; Γράψτε μας — θα το προσθέσουμε με χαρά.

Πώς να συνδεθείτε

1. Ενεργοποιήστε τα webhooks για το κατάλληλο κατάστημα — το κλειδί υπογραφής θα δημιουργηθεί αυτόματα.
2. Επιλέξτε τα γεγονότα για τα οποία θέλετε να λαμβάνετε ειδοποιήσεις.
3. Δηλώστε τη διεύθυνση της υπηρεσίας σας στην οποία το FoodSoul θα στέλνει τα δεδομένα. Αποδεκτή μόνο διεύθυνση με HTTPS.
4. Προσθέστε το κλειδί υπογραφής στην υπηρεσία που λαμβάνει τις ειδοποιήσεις και ρυθμίστε τον έλεγχο της υπογραφής. Αν κατά τη δημιουργία των webhooks δηλώσατε διαφορετικές διευθύνσεις, προσθέστε το κλειδί σε κάθε υπηρεσία.
5. Βεβαιωθείτε ότι η υπηρεσία επιβεβαιώνει τη λήψη της ειδοποίησης εντός 10 δευτερολέπτων, αλλιώς το FoodSoul θα την αποστείλει ξανά.

6. Ρυθμίστε έλεγχο για διπλότυπα: η ίδια ειδοποίηση μπορεί να φτάσει πολλές φορές. Όλα τα διπλότυπα έχουν το ίδιο ID (κεφαλίδα X-Webhook-ID). Ας αποθηκεύει η υπηρεσία σας τα ID των επεξεργασμένων ειδοποιήσεων και να αγνοεί τα διπλότυπα — έτσι μία πληρωμή δεν θα καταχωρηθεί δύο φορές.

    

Ασφάλεια: γιατί χρειάζεται το κλειδί υπογραφής
 

Το FoodSoul υπογράφει κάθε ειδοποίηση με το κλειδί υπογραφής — ένα σύνολο χαρακτήρων που έχετε μόνο εσείς κι εμείς. Με αυτή την υπογραφή το σύστημά σας ελέγχει ότι η ειδοποίηση ήρθε από το FoodSoul και δεν αλλοιώθηκε στη διαδρομή.
 

Οποιοσδήποτε μπορεί να στείλει αίτημα στη διεύθυνση της υπηρεσίας σας. Για παράδειγμα, ένας απατεώνας μπορεί να στείλει ψεύτικη ειδοποίηση “η παραγγελία πληρώθηκε” και να παραδώσετε παραγγελία που δεν έχει πληρωθεί.
 

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

 

Αν κάτι πάει στραβά

• Αν η υπηρεσία σας είναι προσωρινά μη διαθέσιμη, το FoodSoul θα προσπαθήσει να παραδώσει ξανά την ειδοποίηση αρκετές φορές εντός 10 ωρών. Μια σύντομη διακοπή ή επανεκκίνηση του διακομιστή δεν θα οδηγήσει σε απώλεια γεγονότων.
• Αν το πρόβλημα παραταθεί, η συνδρομή θα απενεργοποιηθεί και θα λάβετε email: έτσι θα ενημερωθείτε για το πρόβλημα.
• Για να ενεργοποιήσετε ξανά τη συνδρομή, επικοινωνήστε με την τεχνική υποστήριξη. Εκεί μπορείτε επίσης να ζητήσετε επαναποστολή ειδοποιήσεων που δεν παραδόθηκαν κατά τη διάρκεια της διακοπής.
   

Αναλυτική περιγραφή των γεγονότων και της μορφής των δεδομένων — στη τεκμηρίωση του API.

Με εκτίμηση, η ομάδα του FoodSoul! Εργαζόμαστε για εσάς!