Penyepaduan pemaju
Tolak setiap acara kesetiaan daripada 7Stamp ke sistem anda sendiri dalam masa nyata. Tiada pengundian dan tiada panggilan API berjadual. Acara tiba sebagai HTTPS POST permintaan dalam beberapa saat selepas berlaku.
Gunakan webhooks untuk memastikan CRM, ERP atau hujung belakang tersuai anda selari dengan perkara yang berlaku di sisi kesetiaan: siapa yang menyertai, siapa yang mendapat setem, siapa yang menebus baucar, siapa yang mencetuskan hadiah hari jadi dan siapa yang menjadi tidak aktif. Kemudian sistem anda memutuskan perkara yang perlu dilakukan dengan data tersebut.
Webhooks ialah bahagian keluar timbunan penyepaduan. Mereka mencerminkan aktiviti pelanggan dan ganjaran ke dalam sistem yang anda sudah percayai untuk jualan, perkhidmatan, analitis dan pemesejan.
Setiap setem, baucar, hari lahir dan pencetus ketidakaktifan sampai ke rekod pelanggan dalam CRM anda. Anda melihat garis masa kesetiaan penuh di sebelah jualan, panggilan dan tiket tanpa log masuk ke 7Stamp.
Apabila pelanggan menebus baucar, hantarkan ucapan terima kasih SMS daripada gerbang SMS anda yang sedia ada. Apabila pelanggan mencapai matlamat, siarkan perayaan di Slack. Apabila seseorang menjadi tidak aktif, halakan kes itu kepada pengurus akaun anda.
Strim acara ke dalam alat BI anda, gudang atau saluran paip perdamaian. Padankan penebusan baucar dengan POS resit dan hitung kesetiaan ROI dalam metrik anda sendiri.
anda harus terima ⟦9999995 POST, sahkan bentuk permintaan, kekalkan atau baris gilir acara, kemudian kembalikan respons 2xx yang berjaya. Jangan buat panggilan CRM atau pemesejan perlahan sebelum pengakuan jika ia boleh beratur dengan selamat.
Setiap acara berkaitan boleh membawa External ID dan pilihan External Source yang anda gunakan semasa membuat atau mengimbas kad. Gunakan pasangan ini untuk mengemas kini CRM, POS, atau rekod pesanan anda sendiri tanpa meneka daripada nama atau e-mel.
Simpan kunci pemprosesan yang tahan lama atau cap jari peristiwa sebelum mencetuskan kesan sampingan. Jika penerima anda melihat penghantaran yang sama sekali lagi, ia tidak sepatutnya menambah nota, baucar atau mesej pendua CRM. Anggap titik akhir URL sebagai rahsia.
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
}
}
}Buat titik HTTPS pada hujung belakang anda, CRM lapisan penyepaduan, ⟦1716, atau ⟦1716 Catch Hook. Make pastikan anda mengawal destinasi sebelum menyalin URLnya.
Dalam 7Stamp Admin, buka Stamp Cards → API & Integrations → Webhooks.
Tambahkan URL titik akhir. Webhook menerima setiap peristiwa kad profil, jadi tapis mengikut data.event_type dalam penerima anda.
Simpan tetapan profil, kemudian cetuskan imbasan ujian pakai buang atau tindakan kad untuk menghasilkan acara.
Periksa muatan yang diterima. Padankan External ID dan External Source dengan rekod yang dijangkakan dan sahkan penerima mengembalikan respons yang berjaya.
Dayakan CRM, baucar, atau kesan sampingan pemesejan hanya selepas anda mempunyai pengendalian dan pemantauan selamat ulang tayang untuk kegagalan.
Dalam Make, gunakan Webhooks → Custom webhook untuk menjana penerimaan URL7 dan tampalkannya ke dalam profil URL7. Dalam Zapier, gunakan Webhooks by Zapier → Catch Hook untuk tujuan yang sama. Profil 7Stamp memiliki langganan kerana API semasa tidak mendedahkan titik akhir pendaftaran webhook automatik.
Gunakan bahagian Webhooks dalam rujukan OpenAPI awam sebagai sumber skema muatan semasa. Badan permintaan ialah sampul: profile_id dan profile_name menamakan profil 7Stamp, event_id mengenal pasti peristiwa, dan peristiwa kad itu sendiri berada dalam data (untuk URL Make atau Zapier, kuncinya ialah card_event). Setiap penghantaran ditandatangani dalam satu pengepala, X-Webhook-Signature: t=…,s=…. Kira HMAC-SHA256 dengan rahsia webhook anda ke atas t ditambah badan permintaan mentah, kodkan dalam hex dan bandingkan dengan s; rahsia itu terdapat pada halaman webhook dalam 7Stamp Admin. Gunakan X-Webhook-Event-Id untuk membuang penghantaran berulang: percubaan semula ditandatangani sekali lagi dengan t baharu. Anda juga boleh melindungi titik akhir dengan Basic Auth. Wajibkan HTTPS dan jauhkan URL penerima daripada log awam.
Tidak. Webhook 7Stamp menerima setiap peristiwa kad profil. Tapis mengikut data.event_type dalam penerima anda; dalam Make dan Zapier, peristiwa itu berada di bawah card_event, jadi tapis mengikut card_event.event_type.
Cipta webhook penerima dalam Make atau Catch Hook dalam Zapier, salin URL yang dijana, kemudian tampalkannya ke dalam tetapan 7Stamp.
Gunakan data.external_id dan, jika ada, data.external_source: kedua-duanya dikembalikan dalam setiap webhook untuk kad yang anda keluarkan melalui API dengan ID anda sendiri. Pelanggan yang mengambil kad sendiri tidak mempunyai External ID, jadi padankan mereka melalui data.user.email. Alamat Apple “Hide My Email” ialah alamat geganti, bukan alamat dalam CRM anda.
Pisahkan pengepala X-Webhook-Signature kepada t dan s, kira HMAC-SHA256 dengan rahsia webhook daripada 7Stamp Admin ke atas t ditambah badan permintaan mentah, kodkan dalam hex dan bandingkan dengan s. Ambil t tepat seperti yang dihantar dan badan sebagai bait mentah yang diterima, sebelum sebarang penghuraian JSON. Buang penghantaran yang X-Webhook-Event-Id-nya telah anda proses: percubaan semula ditandatangani sekali lagi dengan t baharu.
Halaman berkaitan
Langkah seterusnya
Buat penerima, tampal HTTPS URL ke dalam profil, jalankan imbasan pakai buang dan sahkan pemadanan External ID sebelum mendayakan automasi hiliran.