Penyepaduan pemaju

7stamp Webhooks

Tersedia

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.

Perkara yang boleh anda lakukan dengan webhooks

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.

Cerminkan sejarah kesetiaan ke dalam CRM anda

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.

Cetuskan susunan pemesejan anda sendiri

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.

Analisis kuasa dan penyesuaian

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.

Jenis acara kad

SCAN — Kad menerima tindakan imbasan/stamp.
REWARD_EARNED — Ganjaran telah diperolehi pada kad itu.
VOUCHER_ISSUED — Baucar telah dikeluarkan.
VOUCHER_REDEEMED — Baucar telah ditebus.
LOTTERY_WIN — Loteri menghasilkan kemenangan.
DELIVERY_INSERT — Aliran sisipan penghantaran telah direkodkan.
CARD_JOINED — Seorang pelanggan menyertai kad.
CARD_CAMPAIGN — Acara kempen kad telah berlaku.
BIRTHDAY_GREETING — Acara ucapan hari lahir telah berlaku.
ADMIN_VOUCHER_ISSUE — Seorang pentadbir mengeluarkan baucar.
CARD_ADDED_TO_WALLET — Seorang pelanggan menambahkan kad pada dompet mereka.
CARD_REMOVED_FROM_WALLET — Seorang pelanggan mengeluarkan kad daripada dompet mereka.

Bina penerima webhook yang selamat

Akui selepas pengendalian tahan lama

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.

Hubungkaitkan dengan External ID

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.

Make idempoten penghantaran

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.

Contoh bentuk muatan acara

Salin ini ke dalam langkah automasi anda 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"
}

Konfigurasikan dan uji webhook

01

Buat titik HTTPS pada hujung belakang anda, CRM lapisan penyepaduan, ⟦1716, atau ⟦1716 Catch Hook. Make pastikan anda mengawal destinasi sebelum menyalin URLnya.

02

Dalam 7stamp Admin, buka Stamp Cards → API & Integrations → Webhooks.

03

Tambahkan titik akhir URL dan pilih hanya jenis acara yang sebenarnya diperlukan oleh aliran kerja penerima.

04

Simpan tetapan profil, kemudian cetuskan imbasan ujian pakai buang atau tindakan kad untuk menghasilkan acara.

05

Periksa muatan yang diterima. Padankan External ID dan External Source dengan rekod yang dijangkakan dan sahkan penerima mengembalikan respons yang berjaya.

06

Dayakan CRM, baucar, atau kesan sampingan pemesejan hanya selepas anda mempunyai pengendalian dan pemantauan selamat ulang tayang untuk kegagalan.

Pilihan tanpa kod: Make dan Zapier

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.

Kontrak keselamatan dan penghantaran

Gunakan bahagian Webhooks rujukan OpenAPI awam sebagai sumber untuk skema muatan semasa dan maksud medan. Memerlukan HTTPS, jauhkan penerima URL daripada log awam, dan jadikan pemprosesan idempoten. Sahkan prosedur permintaan-pengesahan/signature untuk profil 7stamp anda semasa onboarding sebelum menguatkuasakan nama pengepala tertentu atau dasar cuba semula dalam pengeluaran.

Soalan lazim

Bolehkah saya memilih acara webhook tertentu sahaja?

Ya. Pilih jenis acara dalam tetapan webhook profil 7stamp supaya penerima hanya mendapat peristiwa yang penting kepada aliran kerjanya.

Bagaimanakah cara saya menyambungkan webhooks ke Make atau Zapier?

Cipta webhook penerima dalam Make atau Catch Hook dalam Zapier, salin URL yang dijana, kemudian tampalkannya ke dalam tetapan 7stamp.

Bagaimanakah saya harus memadankan acara dengan CRM kenalan saya?

Gunakan External ID dan, apabila ada, External Source. Ini ialah pengecam yang integrasi anda dibekalkan semasa kad dibuat atau diimbas.

Patutkah saya mengambil tajuk tandatangan atau cuba semula masa?

Tidak. Gunakan kontrak penghantaran OpenAPI/profile semasa dan sahkan prosedur pengesahan untuk profil anda semasa onboarding sebelum mengekod keras pengepala atau andaian cuba semula.

Langkah seterusnya

Bersedia untuk menghantar acara kad pertama?

Buat penerima, tampal HTTPS URL ke dalam profil, jalankan imbasan pakai buang dan sahkan pemadanan External ID sebelum mendayakan automasi hiliran.