Ενοποίηση προγραμματιστή
Ωθήστε κάθε εκδήλωση αφοσίωσης από το 7Stamp στα δικά σας συστήματα σε πραγματικό χρόνο. Χωρίς ψηφοφορία και χωρίς προγραμματισμένες κλήσεις API. Τα συμβάντα φτάνουν σύμφωνα με τα αιτήματα του HTTPS POST μέσα σε δευτερόλεπτα από τη στιγμή που θα συμβούν.
Χρησιμοποιήστε webhook για να διατηρήσετε το CRM, ERP ή το προσαρμοσμένο backend σας σε συγχρονισμό με αυτό που συμβαίνει στην πλευρά της αφοσίωσης: ποιος έγινε μέλος, ποιος πήρε γραμματόσημο, ποιος εξαργύρωσε ένα κουπόνι, ποιος ενεργοποίησε ένα ενεργό δώρο γενεθλίων και ποιος. Στη συνέχεια, τα συστήματά σας αποφασίζουν τι να κάνουν με αυτά τα δεδομένα.
Οι στοίβες ενσωμάτωσης στο Web είναι οι έξω. Αντικατοπτρίζουν τη δραστηριότητα πελατών και ανταμείβουν στα συστήματα που ήδη εμπιστεύεστε για πωλήσεις, υπηρεσίες, αναλυτικά στοιχεία και μηνύματα.
Κάθε ενεργοποίηση σφραγίδας, κουπονιού, γενεθλίων και αδράνειας προσγειώνεται στο αρχείο πελάτη στο CRM σας. Βλέπετε το πλήρες χρονοδιάγραμμα αφοσίωσης δίπλα στις εκπτώσεις, τις κλήσεις και τα εισιτήρια χωρίς να συνδεθείτε στο 7Stamp.
Όταν ένας πελάτης εξαργυρώσει ένα κουπόνι, στείλτε ένα ευχαριστήριο SMS από την υπάρχουσα πύλη SMS. Όταν ένας πελάτης πετύχει τον στόχο, δημοσιεύστε μια γιορτή στο Slack. Όταν κάποιος γίνει ανενεργός, δρομολογήστε την υπόθεση στον διαχειριστή του λογαριασμού σας.
Stream συμβάντα στο BI εργαλείο, την αποθήκη ή τη σωλήνωση συμφιλίωσης. Αντιστοιχίστε τις εξαργυρώσεις κουπονιών με POS αποδείξεις και υπολογίστε την αφοσίωση ROI στις δικές σας μετρήσεις.
Το τελικό σημείο σας θα πρέπει να αποδέχεται το HTTPS POST, να επικυρώνει το σχήμα του αιτήματος, να παραμένει ή να τοποθετεί το συμβάν στην ουρά και, στη συνέχεια, να επιστρέψει μια επιτυχημένη απάντηση 2xx. Μην πραγματοποιείτε αργή κλήση CRM ή μέσω μηνυμάτων πριν από την επιβεβαίωση, εάν μπορεί να τεθεί σε ουρά με ασφάλεια.
Κάθε σχετικό συμβάν μπορεί να φέρει το External ID και το προαιρετικό External Source που χρησιμοποιήσατε κατά τη δημιουργία ή τη σάρωση της κάρτας. Χρησιμοποιήστε αυτό το ζευγάρι για να ενημερώσετε τα δικά σας CRM, POS ή να παραγγείλετε την εγγραφή χωρίς να μαντέψετε από όνομα ή email.
Αποθηκεύστε ένα ανθεκτικό κλειδί επεξεργασίας ή ένα δακτυλικό αποτύπωμα συμβάντος πριν προκαλέσετε παρενέργειες. Εάν ο παραλήπτης σας δει ξανά την ίδια παράδοση, δεν θα πρέπει να προσθέσει διπλότυπη σημείωση, κουπόνι ή μήνυμα CRM. Αντιμετωπίστε το τελικό σημείο URL ως μυστικό.
json {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}Δημιουργήστε ένα τελικό σημείο HTTPS στο backend σας, CRM2 επίπεδο ενσωμάτωσης webhook, ⟦66, ⟧ Zapier Catch Hook. Make βεβαιωθείτε ότι ελέγχετε τον προορισμό πριν αντιγράψετε το URL του.
Στο 7Stamp Admin, ανοίξτε το Stamp Cards → API & Integrations → Webhooks.
Προσθέστε το URL του endpoint. Το webhook λαμβάνει κάθε συμβάν κάρτας του προφίλ, οπότε φιλτράρετε κατά data.event_type στον δέκτη σας.
Αποθηκεύστε τις ρυθμίσεις προφίλ και, στη συνέχεια, ενεργοποιήστε μια δοκιμαστική ενέργεια σάρωσης ή κάρτας μιας χρήσης για να δημιουργήσετε ένα συμβάν.
Επιθεωρήστε το ληφθέν ωφέλιμο φορτίο. Ταιριάξτε τα External ID και External Source με την αναμενόμενη εγγραφή και επιβεβαιώστε ότι ο δέκτης επιστρέφει μια επιτυχημένη απάντηση.
Ενεργοποιήστε τις παρενέργειες CRM, κουπονιών ή μηνυμάτων μόνο αφού έχετε ασφαλή για επανάληψη χειρισμό και παρακολούθηση για αποτυχίες.
Στο Make, χρησιμοποιήστε το Webhooks → Custom webhook για να δημιουργήσετε ένα δέκτη URL και να το επικολλήσετε στο προφίλ 7Stamp. Στο Zapier, χρησιμοποιήστε το Webhooks by Zapier → Catch Hook για τον ίδιο σκοπό. Το προφίλ 7Stamp κατέχει τη συνδρομή, επειδή το τρέχον API δεν εκθέτει τα αυτόματα τελικά σημεία εγγραφής webhook.
Χρησιμοποιήστε την ενότητα Webhooks της δημόσιας τεκμηρίωσης OpenAPI ως πηγή για το τρέχον σχήμα του payload. Το σώμα είναι ένας φάκελος: τα profile_id και profile_name προσδιορίζουν το προφίλ 7Stamp, το event_id αναγνωρίζει το συμβάν και το ίδιο το συμβάν κάρτας βρίσκεται στο data (για URL του Make ή του Zapier το κλειδί είναι card_event). Κάθε παράδοση υπογράφεται σε μία κεφαλίδα, X-Webhook-Signature: t=…,s=…. Υπολογίστε το HMAC-SHA256 με το μυστικό του webhook πάνω στο t ακολουθούμενο από το ακατέργαστο σώμα του αιτήματος, κωδικοποιήστε το σε δεκαεξαδική μορφή και συγκρίνετέ το με το s· το μυστικό βρίσκεται στη σελίδα του webhook στο 7Stamp Admin. Χρησιμοποιήστε το X-Webhook-Event-Id για να απορρίπτετε επαναλαμβανόμενες παραδόσεις: μια επανάληψη υπογράφεται ξανά με νέο t. Μπορείτε επίσης να προστατέψετε το endpoint με Basic Auth. Απαιτήστε HTTPS και κρατήστε το URL του δέκτη εκτός δημόσιων αρχείων καταγραφής.
Όχι. Ένα webhook του 7Stamp λαμβάνει κάθε συμβάν κάρτας του προφίλ. Φιλτράρετε κατά data.event_type στον δέκτη σας· στο Make και στο Zapier το συμβάν έρχεται κάτω από το card_event, οπότε φιλτράρετε κατά card_event.event_type.
Δημιουργήστε το webhook λήψης στο Make ή ένα Catch Hook στο Zapier, αντιγράψτε το URL που δημιουργήθηκε και, στη συνέχεια, επικολλήστε το στις ρυθμίσεις ⟦24679 δοκιμής webhook.
Χρησιμοποιήστε το data.external_id και, όταν υπάρχει, το data.external_source: επιστρέφουν σε κάθε webhook για κάρτες που εκδώσατε μέσω του API με το δικό σας ID. Ένας πελάτης που πήρε την κάρτα μόνος του δεν έχει External ID, οπότε αντιστοιχίστε τον μέσω του data.user.email. Μια διεύθυνση Apple «Hide My Email» είναι διεύθυνση αναμετάδοσης, όχι αυτή που υπάρχει στο CRM σας.
Χωρίστε την κεφαλίδα X-Webhook-Signature σε t και s, υπολογίστε το HMAC-SHA256 με το μυστικό του webhook από το 7Stamp Admin πάνω στο t ακολουθούμενο από το ακατέργαστο σώμα του αιτήματος, κωδικοποιήστε το σε δεκαεξαδική μορφή και συγκρίνετέ το με το s. Πάρτε το t ακριβώς όπως στάλθηκε και το σώμα ως τα ακατέργαστα bytes που λάβατε, πριν από οποιαδήποτε ανάλυση JSON. Απορρίψτε μια παράδοση της οποίας το X-Webhook-Event-Id έχετε ήδη επεξεργαστεί: μια επανάληψη υπογράφεται ξανά με νέο t.
Σχετικές σελίδες
Επόμενο βήμα
Δημιουργήστε έναν δέκτη, επικολλήστε το HTTPS URL του στο προφίλ, εκτελέστε μια σάρωση μιας χρήσης και επικυρώστε το αντίστοιχο External ID προτού ενεργοποιήσετε τον αυτοματισμό κατάντη.