Integrasi pengembang
Dorong setiap acara loyalitas dari 7stamp ke sistem Anda sendiri secara real-time. Tidak ada polling dan tidak ada panggilan API terjadwal. Acara tiba sesuai permintaan HTTPS POST dalam beberapa detik setelah kejadian.
Gunakan webhook untuk menjaga CRM, ERP, atau backend khusus Anda tetap sinkron dengan apa yang terjadi di sisi loyalitas: siapa yang bergabung, siapa yang mendapat stempel, siapa yang menukarkan voucher, siapa yang memicu hadiah ulang tahun, dan siapa yang menjadi tidak aktif. Kemudian sistem Anda memutuskan apa yang harus dilakukan dengan data tersebut.
Webhook adalah sisi keluar dari tumpukan integrasi. Mereka mencerminkan aktivitas pelanggan dan penghargaan ke dalam sistem yang Anda percayai untuk penjualan, layanan, analitik, dan pengiriman pesan.
Setiap pemicu prangko, voucher, ulang tahun, dan ketidakaktifan masuk ke catatan pelanggan di CRM Anda. Anda melihat garis waktu loyalitas lengkap di samping penjualan, panggilan, dan tiket tanpa masuk ke 7stamp.
Saat pelanggan menukarkan voucher, kirimkan ucapan terima kasih SMS dari gerbang SMS Anda yang ada. Saat pelanggan mencapai sasaran, posting perayaan di Slack. Jika seseorang menjadi tidak aktif, sampaikan kasus tersebut ke manajer akun Anda.
Alirkan peristiwa ke dalam alat BI, gudang, atau jalur rekonsiliasi Anda. Cocokkan penukaran voucher dengan POS tanda terima dan hitung loyalitas ROI dalam metrik Anda sendiri.
Titik akhir Anda harus menerima HTTPS POST, validasi bentuk permintaan, pertahankan atau antri acara, lalu kembalikan respons 2xx yang berhasil. Jangan melakukan panggilan lambat CRM atau pengiriman pesan sebelum pemberitahuan jika dapat diantri dengan aman.
Setiap peristiwa terkait dapat membawa External ID dan External Source opsional yang Anda gunakan saat membuat atau memindai kartu. Gunakan pasangan ini untuk memperbarui CRM, POS, atau catatan pesanan Anda tanpa menebak nama atau email.
Simpan kunci pemrosesan yang tahan lama atau sidik jari kejadian sebelum memicu efek samping. Jika penerima Anda melihat kiriman yang sama lagi, ia tidak boleh menambahkan duplikat catatan, voucher, atau pesan CRM. Perlakukan titik akhir URL sebagai rahasia.
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"
}Buat titik akhir HTTPS di backend Anda, CRM lapisan integrasi, Make webhook, atau Zapier Catch Hook. Make pastikan Anda mengontrol tujuannya sebelum menyalin URL-nya.
Di 7stamp Admin, buka Stamp Cards → API & Integrations → Webhooks.
Tambahkan titik akhir URL dan pilih hanya jenis kejadian yang benar-benar dibutuhkan oleh alur kerja penerimaan.
Simpan pengaturan profil, lalu picu pemindaian tes sekali pakai atau tindakan kartu untuk menghasilkan suatu peristiwa.
Periksa muatan yang diterima. Cocokkan External ID dan External Source dengan catatan yang diharapkan dan konfirmasikan bahwa penerima mengembalikan respons yang berhasil.
Aktifkan CRM, voucher, atau efek samping perpesanan hanya setelah Anda memiliki penanganan yang aman untuk diputar ulang dan memantau kegagalan.
Di Make, gunakan Webhooks → Custom webhook untuk menghasilkan URL penerima dan tempelkan ke profil 7stamp. Di Zapier, gunakan Webhooks by Zapier → Catch Hook untuk tujuan yang sama. Profil 7stamp memiliki langganan karena API saat ini tidak mengekspos titik akhir pendaftaran webhook otomatis.
Gunakan bagian Webhook dari referensi publik OpenAPI sebagai sumber skema muatan saat ini dan arti bidang. Memerlukan HTTPS, jauhkan penerima URL dari log publik, dan jadikan pemrosesan idempoten. Konfirmasikan prosedur otentikasi permintaan/signature untuk profil 7stamp Anda selama orientasi sebelum menerapkan nama header tertentu atau kebijakan coba lagi dalam produksi.
Ya. Pilih jenis peristiwa di pengaturan webhook profil 7stamp sehingga penerima hanya mendapatkan peristiwa yang penting bagi alur kerjanya.
Buat webhook penerima di Make atau Catch Hook di Zapier, salin URL yang dihasilkan, lalu tempelkan ke pengaturan webhook profil 7stamp dan kirim acara pengujian.
Gunakan External ID dan, jika ada, External Source. Ini adalah pengidentifikasi yang diberikan integrasi Anda saat kartu dibuat atau dipindai.
Tidak. Gunakan kontrak pengiriman OpenAPI/profile saat ini dan konfirmasikan prosedur autentikasi untuk profil Anda selama orientasi sebelum melakukan hardcoding pada header atau coba lagi asumsi.
Halaman terkait
Langkah selanjutnya
Buat receiver, tempelkan HTTPS URL ke dalam profil, jalankan pemindaian sekali pakai, dan validasi External ID yang cocok sebelum mengaktifkan otomatisasi hilir.