Ενοποίηση προγραμματιστή

7stamp Webhooks

Διαθέσιμο

Ωθήστε κάθε εκδήλωση αφοσίωσης από το 7stamp στα δικά σας συστήματα σε πραγματικό χρόνο. Χωρίς ψηφοφορία και χωρίς προγραμματισμένες κλήσεις API. Τα συμβάντα φτάνουν σύμφωνα με τα αιτήματα του HTTPS POST μέσα σε δευτερόλεπτα από τη στιγμή που θα συμβούν.

Χρησιμοποιήστε webhook για να διατηρήσετε το CRM, ERP ή το προσαρμοσμένο backend σας σε συγχρονισμό με αυτό που συμβαίνει στην πλευρά της αφοσίωσης: ποιος έγινε μέλος, ποιος πήρε γραμματόσημο, ποιος εξαργύρωσε ένα κουπόνι, ποιος ενεργοποίησε ένα ενεργό δώρο γενεθλίων και ποιος. Στη συνέχεια, τα συστήματά σας αποφασίζουν τι να κάνουν με αυτά τα δεδομένα.

Τι μπορείτε να κάνετε με τα webhook

Οι στοίβες ενσωμάτωσης στο Web είναι οι έξω. Αντικατοπτρίζουν τη δραστηριότητα πελατών και ανταμείβουν στα συστήματα που ήδη εμπιστεύεστε για πωλήσεις, υπηρεσίες, αναλυτικά στοιχεία και μηνύματα.

Αντικατοπτρίστε το ιστορικό αφοσίωσης στο CRM σας

Κάθε ενεργοποίηση σφραγίδας, κουπονιού, γενεθλίων και αδράνειας προσγειώνεται στο αρχείο πελάτη στο CRM σας. Βλέπετε το πλήρες χρονοδιάγραμμα αφοσίωσης δίπλα στις εκπτώσεις, τις κλήσεις και τα εισιτήρια χωρίς να συνδεθείτε στο 7stamp.

Ενεργοποιήστε τη δική σας στοίβα μηνυμάτων

Όταν ένας πελάτης εξαργυρώσει ένα κουπόνι, στείλτε ένα ευχαριστήριο SMS από την υπάρχουσα πύλη SMS. Όταν ένας πελάτης πετύχει τον στόχο, δημοσιεύστε μια γιορτή στο Slack. Όταν κάποιος γίνει ανενεργός, δρομολογήστε την υπόθεση στον διαχειριστή του λογαριασμού σας.

Power analytics and conciliation

Stream συμβάντα στο BI εργαλείο, την αποθήκη ή τη σωλήνωση συμφιλίωσης. Αντιστοιχίστε τις εξαργυρώσεις κουπονιών με POS αποδείξεις και υπολογίστε την αφοσίωση ROI στις δικές σας μετρήσεις.

Τύποι συμβάντων κάρτας

SCAN — Μια κάρτα έλαβε μια ενέργεια σάρωσης/stamp.
REWARD_EARNED — Κερδίστηκε μια ανταμοιβή στην κάρτα.
VOUCHER_ISSUED — Εκδόθηκε κουπόνι.
VOUCHER_REDEEMED — Ένα κουπόνι εξαργυρώθηκε.
LOTTERY_WIN — Μια λαχειοφόρος αγορά κατέληξε σε νίκη.
DELIVERY_INSERT — Καταγράφηκε ροή ένθετου παράδοσης.
CARD_JOINED — Ένας πελάτης ένωσε μια κάρτα.
CARD_CAMPAIGN — Παρουσιάστηκε ένα συμβάν καμπάνιας κάρτας.
BIRTHDAY_GREETING — Έγινε εκδήλωση χαιρετισμού γενεθλίων.
ADMIN_VOUCHER_ISSUE — Ένας διαχειριστής εξέδωσε ένα κουπόνι.
CARD_ADDED_TO_WALLET — Ένας πελάτης πρόσθεσε την κάρτα στο πορτοφόλι του.
CARD_REMOVED_FROM_WALLET — Ένας πελάτης αφαίρεσε την κάρτα από το πορτοφόλι του.

Κατασκευάστε έναν ασφαλή δέκτη webhook

Αναγνωρίστε μετά από ανθεκτικό χειρισμό

Το τελικό σημείο σας θα πρέπει να αποδέχεται το HTTPS POST, να επικυρώνει το σχήμα του αιτήματος, να παραμένει ή να τοποθετεί το συμβάν στην ουρά και, στη συνέχεια, να επιστρέψει μια επιτυχημένη απάντηση 2xx. Μην πραγματοποιείτε αργή κλήση CRM ή μέσω μηνυμάτων πριν από την επιβεβαίωση, εάν μπορεί να τεθεί σε ουρά με ασφάλεια.

Συσχετίστε με External ID

Κάθε σχετικό συμβάν μπορεί να φέρει το External ID και το προαιρετικό External Source που χρησιμοποιήσατε κατά τη δημιουργία ή τη σάρωση της κάρτας. Χρησιμοποιήστε αυτό το ζευγάρι για να ενημερώσετε τα δικά σας CRM, POS ή να παραγγείλετε την εγγραφή χωρίς να μαντέψετε από όνομα ή email.

Make ανεπαρκής παράδοση

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

Παράδειγμα σχήματος ωφέλιμου φορτίου συμβάντος

Αντιγράψτε το στο βήμα αυτοματισμού json
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

Διαμόρφωση και δοκιμή ενός webhook

01

Δημιουργήστε ένα τελικό σημείο HTTPS στο backend σας, CRM2 επίπεδο ενσωμάτωσης webhook, ⟦66, ⟧ Zapier Catch Hook. Make βεβαιωθείτε ότι ελέγχετε τον προορισμό πριν αντιγράψετε το URL του.

02

Στο 7stamp Admin, ανοίξτε το Stamp Cards → API & Integrations → Webhooks.

03

Προσθέστε το τελικό σημείο URL και επιλέξτε μόνο τους τύπους συμβάντων που πραγματικά χρειάζεται η ροή εργασίας λήψης.

04

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

05

Επιθεωρήστε το ληφθέν ωφέλιμο φορτίο. Ταιριάξτε τα External ID και External Source με την αναμενόμενη εγγραφή και επιβεβαιώστε ότι ο δέκτης επιστρέφει μια επιτυχημένη απάντηση.

06

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

Επιλογές χωρίς κωδικό: Make και Zapier

Στο Make, χρησιμοποιήστε το Webhooks → Custom webhook για να δημιουργήσετε ένα δέκτη URL και να το επικολλήσετε στο προφίλ 7stamp. Στο Zapier, χρησιμοποιήστε το Webhooks by Zapier → Catch Hook για τον ίδιο σκοπό. Το προφίλ 7stamp κατέχει τη συνδρομή, επειδή το τρέχον API δεν εκθέτει τα αυτόματα τελικά σημεία εγγραφής webhook.

Ασφάλεια και σύμβαση παράδοσης

Χρησιμοποιήστε την ενότητα Webhooks της δημόσιας αναφοράς OpenAPI ως πηγή για το τρέχον σχήμα ωφέλιμου φορτίου και τη σημασία του πεδίου. Απαιτήστε HTTPS, διατηρήστε τον δέκτη URL μακριά από δημόσια αρχεία καταγραφής και κάντε την επεξεργασία ανεπαρκή. Επιβεβαιώστε τη διαδικασία ελέγχου ταυτότητας/signature για το προφίλ σας 7stamp κατά τη διάρκεια της ενσωμάτωσης προτού επιβάλετε ένα συγκεκριμένο όνομα κεφαλίδας ή επαναλάβετε την πολιτική στην παραγωγή.

Συχνές ερωτήσεις

Μπορώ να επιλέξω μόνο ορισμένα συμβάντα webhook;

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

Πώς μπορώ να συνδέσω webhook στο Make ή στο Zapier;

Δημιουργήστε το webhook λήψης στο Make ή ένα Catch Hook στο Zapier, αντιγράψτε το URL που δημιουργήθηκε και, στη συνέχεια, επικολλήστε το στις ρυθμίσεις ⟦24679 δοκιμής webhook.

Πώς πρέπει να αντιστοιχίσω ένα συμβάν με την επαφή μου CRM;

Χρησιμοποιήστε External ID και, όταν υπάρχει, External Source. Αυτά είναι τα αναγνωριστικά που παρείχε η ενσωμάτωσή σας κατά τη δημιουργία ή τη σάρωση της κάρτας.

Πρέπει να υποθέσω μια κεφαλίδα υπογραφής ή να δοκιμάσω ξανά το χρονοδιάγραμμα;

Όχι. Χρησιμοποιήστε το τρέχον συμβόλαιο παράδοσης OpenAPI/profile και επιβεβαιώστε τη διαδικασία ελέγχου ταυτότητας για το προφίλ σας κατά την ενσωμάτωση πριν κωδικοποιήσετε μια κεφαλίδα ή δοκιμάστε ξανά την υπόθεση.

Επόμενο βήμα

Είστε έτοιμοι να στείλετε το πρώτο συμβάν κάρτας;

Δημιουργήστε έναν δέκτη, επικολλήστε το HTTPS URL του στο προφίλ, εκτελέστε μια σάρωση μιας χρήσης και επικυρώστε το αντίστοιχο External ID προτού ενεργοποιήσετε τον αυτοματισμό κατάντη.