Mετάβαση στο κύριο περιεχόμενο

Webhooks

Λάβετε ένα μήνυμα στο δικό σας σύστημα όταν οι πελάτες εγγράφονται ή κερδίζουν.

Συντάχθηκε από: Berke Atik

Τα Webhooks επιτρέπουν στο Loyaltify να ενημερώνει αμέσως τα άλλα συστήματά σας όταν συμβαίνει κάτι, όπως όταν εγγράφεται ένας νέος πελάτης ή όταν ένας πελάτης κερδίζει πόντους. Το Loyaltify στέλνει ένα σύντομο μήνυμα σε μια διεύθυνση της επιλογής σας και το σύστημά σας μπορεί να ενεργήσει ανάλογα.

Είναι χρήσιμα για να διατηρείτε ενημερωμένο ένα CRM, για να ενεργοποιείτε email στα δικά σας εργαλεία ή για να δημιουργείτε αναφορές. Αυτός ο οδηγός εξηγεί πώς να ρυθμίσετε ένα webhook, τι περιέχει κάθε μήνυμα και πώς να ελέγξετε ότι τα μηνύματα φτάνουν.

💡 Καλό να ξέρετε: Αυτό αποτελεί μέρος του πακέτου Advanced. Σταματά να λειτουργεί αν μεταβείτε σε χαμηλότερο πακέτο.

Ρυθμίστε ένα webhook

Βήμα 1: Ανοίξτε τη ρύθμιση του webhook

Μεταβείτε στις Ενσωματώσεις και κάντε κλικ στο Σύνδεση στην κάρτα Webhook.


​

Βήμα 2: Συμπληρώστε τα στοιχεία

Στο παράθυρο Ρύθμιση webhook:

  • Διεύθυνση URL endpoint: η διεύθυνση https στο σύστημά σας που θα λαμβάνει τα μηνύματα.

  • Εξουσιοδότηση: επιλέξτε Bearer και πληκτρολογήστε ένα δικό σας token ή επιλέξτε Καμία.

  • Συμβάντα: τσεκάρετε όσα θέλετε. Χρειάζεστε τουλάχιστον ένα.

Στη συνέχεια, αποθηκεύστε και το webhook σας είναι ενεργό.

💡 Συμβουλή: Επιλέξτε Bearer και ένα μεγάλο, τυχαίο token. Κάθε μήνυμα θα περιλαμβάνει τότε την κεφαλίδα Authorization: Bearer ακολουθούμενη από το token σας, ώστε το σύστημά σας να μπορεί να ελέγξει ότι το μήνυμα προέρχεται πράγματι από το Loyaltify. Αυτό το token είναι ξεχωριστό από το κλειδί API σας.

Αλλαγές αργότερα

Μπορείτε να αλλάξετε το endpoint, την εξουσιοδότηση και τα συμβάντα οποιαδήποτε στιγμή στη σελίδα Διαμόρφωση webhook. Κάντε κλικ στο Αποθήκευση όταν τελειώσετε.

Συμβάντα που μπορείτε να επιλέξετε

  • Δημιουργήθηκε πελάτης (customer.created): εγγράφεται ένας νέος πελάτης.

  • Ενημερώθηκε πελάτης (customer.updated): γίνεται επεξεργασία των στοιχείων ενός πελάτη.

  • Δημιουργήθηκε συναλλαγή (transaction.created): ένας πελάτης λαμβάνει το αρχικό του υπόλοιπο, κερδίζει, εξαργυρώνει, λαμβάνει ανταμοιβή σύστασης ή του λήγουν πόντοι.

  • Απόπειρα εγγραφής υπάρχοντος πελάτη (customer.signup_attempt): κάποιος που έχει ήδη την κάρτα συμπληρώνει ξανά τη φόρμα σας. Τα αποθηκευμένα στοιχεία του δεν αλλάζουν από τη νέα υποβολή.

Τι περιέχει κάθε μήνυμα

Το Loyaltify στέλνει κάθε μήνυμα σε μορφή JSON, με τις κεφαλίδες Content-Type: application/json και User-Agent: Loyaltify-Webhook/1.0. Κάθε μήνυμα έχει τρία μέρη:

  • event: ποιο συμβάν είναι, όπως customer.created.

  • timestamp: πότε συνέβη, σε UTC (για παράδειγμα 2026-10-16T16:38:46Z).

  • data: οι λεπτομέρειες, που εξαρτώνται από το συμβάν.

Οι αριθμοί, όπως τα point και balance_after, στέλνονται ως κείμενο, για παράδειγμα "1.0", και οι κενές τιμές είναι null.

«Δημιουργήθηκε πελάτης» και «Ενημερώθηκε πελάτης»

  • name, email, phone και birthday

  • uuid: το ID του πελάτη (το ίδιο που υπάρχει στον κωδικό QR της κάρτας του)

  • point: το υπόλοιπό του (στο «Δημιουργήθηκε πελάτης», το αρχικό υπόλοιπο)

  • custom_fields: οι απαντήσεις στις προσαρμοσμένες ερωτήσεις σας, μαζί με κρυφές τιμές από τον σύνδεσμο της φόρμας, όπως το click_id

  • is_marketing_opted_in: αν έδωσε συναίνεση μάρκετινγκ

  • created_at, updated_at και store_uuid

Το «Ενημερώθηκε πελάτης» περιέχει τα ίδια πεδία, με τις νέες τιμές. Ακολουθεί ένα παράδειγμα του «Δημιουργήθηκε πελάτης»:

{
  "data": {
    "name": "Alex",
    "uuid": "7f3e9a21",
    "email": "[email protected]",
    "phone": null,
    "point": "1.0",
    "birthday": null,
    "created_at": "2026-10-16T16:38:41.704Z",
    "store_uuid": "a1b2c3d4",
    "updated_at": "2026-10-16T16:38:46.790Z",
    "custom_fields": {},
    "is_marketing_opted_in": true
  },
  "event": "customer.created",
  "timestamp": "2026-10-16T16:38:46Z"
}

«Δημιουργήθηκε συναλλαγή»

  • kind: ο τύπος της συναλλαγής, για παράδειγμα initial (το αρχικό υπόλοιπο κατά την εγγραφή), manual, redeem, expired, referee ή referrer

  • point και amount: οι τιμές της συναλλαγής. Στις λήξεις, το point είναι αρνητικό.

  • balance_after: το υπόλοιπο του πελάτη μετά τη συναλλαγή

  • campaign: στις εξαργυρώσεις, η καμπάνια που εξαργυρώθηκε

  • user: το μέλος της ομάδας που έκανε τη σάρωση (όνομα, ID και email) ή null για αυτόματα συμβάντα, όπως οι λήξεις

  • customer_uuid, customer_email και customer_phone

  • referred_by_uuid: στις ανταμοιβές συστάσεων, ποιος σύστησε τον πελάτη

  • uuid: το ID της ίδιας της συναλλαγής

  • created_at και store_uuid

Ακολουθεί ένα παράδειγμα όπου ένα μέλος της ομάδας προσθέτει έναν πόντο:

{
  "data": {
    "kind": "manual",
    "user": {
      "name": "Sam Taylor",
      "uuid": "0b8e7d4c-1f2a-4c3b-9d5e-6a7b8c9d0e1f",
      "email": "[email protected]"
    },
    "uuid": "5c9d2e7a-3b4f-4a1c-8e6d-2f7a9b0c1d3e",
    "point": "1.0",
    "amount": null,
    "campaign": null,
    "created_at": "2026-10-16T16:45:10.375Z",
    "store_uuid": "a1b2c3d4",
    "balance_after": "2.0",
    "customer_uuid": "7f3e9a21",
    "customer_email": "[email protected]",
    "customer_phone": null,
    "referred_by_uuid": null
  },
  "event": "transaction.created",
  "timestamp": "2026-10-16T16:45:10Z"
}

Μια ανταμοιβή σύστασης στέλνει δύο συναλλαγές την ίδια στιγμή: referee για τον νέο πελάτη, με το referred_by_uuid να περιέχει το ID του πελάτη που τον σύστησε, και referrer για τον πελάτη που έκανε τη σύσταση.

«Απόπειρα εγγραφής υπάρχοντος πελάτη»

  • customer: ποιος είναι ο υπάρχων πελάτης, με το uuid και τα custom_fields του

  • matched_on: πώς αναγνωρίστηκε, για παράδειγμα μέσω email

  • submission: τι μόλις συμπλήρωσε στη φόρμα

  • form: ποια φόρμα χρησιμοποίησε

Για να δείτε ένα ολόκληρο μήνυμα, ανοίξτε οποιαδήποτε αποστολή στα Πρόσφατα συμβάντα (δείτε παρακάτω).

Ελέγξτε τις αποστολές σας

Η σελίδα Διαμόρφωση webhook εμφανίζει τα Πρόσφατα συμβάντα με την κατάστασή τους, τον κωδικό απάντησης, τον αριθμό προσπαθειών και την ημερομηνία. Κάντε κλικ στο εικονίδιο με το μάτι για να δείτε ακριβώς τι στάλθηκε, τις κεφαλίδες και την απάντηση του συστήματός σας.

Τα μηνύματα δεν φτάνουν;

  • Ελέγξτε ότι η Διεύθυνση URL endpoint είναι μια έγκυρη διεύθυνση https. Οι browser μερικές φορές συμπληρώνουν αυτόματα μια διεύθυνση email σε αυτό το πεδίο.

  • Ελέγξτε ότι το συμβάν είναι τσεκαρισμένο στη σελίδα Διαμόρφωση webhook.

  • Ελέγξτε ότι έχετε το πακέτο Advanced.

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

Ακόμη δεν λειτουργεί; Επικοινωνήστε με την υποστήριξη μέσω της ζωντανής συνομιλίας.

Καλό να ξέρετε

  • Τα μηνύματα μπορεί να μη φτάνουν με τη σειρά, οπότε χρησιμοποιήστε το timestamp αν η σειρά έχει σημασία.

  • Σχεδιάστε το σύστημά σας ώστε να χειρίζεται το ίδιο συμβάν δύο φορές, για κάθε ενδεχόμενο. Για τις συναλλαγές, το uuid μέσα στο data είναι μοναδικό για την καθεμία.

  • Δουλεύετε με το API; Τα webhooks στέλνουν το σύντομο ID του πελάτη. Ορισμένα αιτήματα API χρειάζονται αντί γι’ αυτό τον εσωτερικό αριθμό του πελάτη, και η τεκμηρίωση του API δείχνει πώς να βρείτε το ένα από το άλλο.

  • Χρησιμοποιείτε Omnisend; Ο οδηγός της ίδιας της Omnisend χρησιμοποιεί ένα webhook για τη σύνδεση με το Loyaltify. Δείτε το άρθρο Επισκόπηση ενσωματώσεων για τον σύνδεσμο.
    ​

Χρειάζεστε βοήθεια;

Είμαστε εδώ για να βοηθήσουμε!

Αν έχετε οποιαδήποτε ερώτηση για τα webhooks, επικοινωνήστε μαζί μας μέσω της ζωντανής συνομιλίας μέσα στο Loyaltify ή χρησιμοποιήστε το κουμπί συνομιλίας κάτω δεξιά σε αυτή τη σελίδα. Η ομάδα μας θα χαρεί να σας βοηθήσει.

Σχετικά άρθρα
Απαντήθηκε η ερώτησή σας;