Ishlab chiquvchilar integratsiyasi

7Stamp Veb kancalar

Mavjud

Har bir sodiqlik tadbirini 7Stamp dan real vaqtda shaxsiy tizimlaringizga o'tkazing. So‘rov yo‘q va rejalashtirilgan API qo‘ng‘iroqlar ham yo‘q. Voqealar HTTPS POST soʻrovi sifatida sodir boʻlganidan keyin bir necha soniya ichida yetib boradi.

CRM, ERP yoki shaxsiy serveringizni sodiqlik tomonida sodir bo‘layotgan voqealar bilan sinxronlashtirish uchun vebhuklardan foydalaning: kim qo‘shildi, kim muhr oldi, kim vaucher oldi, kim tug‘ilgan kun sovg‘asini oldi va kim faol bo‘lmadi. Keyin tizimlaringiz ushbu ma'lumotlar bilan nima qilishni hal qiladi.

Webhooks bilan nima qilishingiz mumkin

Veb-huklar integratsiya stekining chiquvchi tomonidir. Ular mijozlarning faolligini aks ettiradi va savdo, xizmat ko'rsatish, tahlil va xabar almashish uchun allaqachon ishonadigan tizimlarda mukofotlanadi.

CRM ga sodiqlik tarixini aks ettiring

Every stamp, voucher, birthday, and inactivity trigger lands on the customer record in your CRM. You see the full loyalty timeline next to sales, calls, and tickets without logging into 7Stamp.

Oʻz xabar almashish toʻplamini ishga tushiring

Mijoz vaucherdan foydalanganda, mavjud SMS shlyuzingizdan rahmat SMS yuboring. When a customer hits the goal, post a celebration in Slack. Agar kimdir nofaol bo'lsa, ishni hisob menejeringizga yuboring.

Power analytics and reconciliation

Stream events into your BI tool, warehouse, or reconciliation pipeline. Match voucher redemptions against POS receipts and calculate loyalty ROI in your own metrics.

Card event types

SCAN — A card received a scan/stamp action.
REWARD_EARNED — A reward was earned on the card.
VOUCHER_ISSUED — A voucher was issued.
VOUCHER_REDEEMED — A voucher was redeemed.
LOTTERY_WIN — A lottery resulted in a win.
DELIVERY_INSERT — A delivery-insert flow was recorded.
CARD_JOINED — A customer joined a card.
CARD_CAMPAIGN — A card campaign event occurred.
BIRTHDAY_GREETING — Tug'ilgan kun bilan tabriklash tadbiri bo'lib o'tdi.
ADMIN_VOUCHER_ISSUE — Administrator vaucher berdi.
CARD_ADDED_TO_WALLET — Mijoz kartani hamyoniga qo‘shdi.
CARD_REMOVED_FROM_WALLET — Mijoz kartani hamyonidan olib tashladi.

Build a safe webhook receiver

Acknowledge after durable handling

Your endpoint should accept HTTPS POST, soʻrov shaklini tasdiqlang, tadbirni davom ettiring yoki navbatga qoʻying, soʻngra muvaffaqiyatli 2xx javobini qaytaring. Tasdiqlashdan oldin sekin CRM yoki xabar almashish qo'ng'irog'ini xavfsiz navbatga qo'yish mumkin bo'lsa, qilmang.

Correlate with External ID

Every related event can carry the External ID and optional External Source that you used when creating or scanning the card. O'zingizning CRM, POS yoki ism yoki elektron pochta orqali taxmin qilmasdan buyurtma yozuvingizni yangilash uchun ushbu juftlikdan foydalaning.

Make yetkazib berish idempotent

Nojo‘ya ta’sirlar paydo bo‘lishidan oldin mustahkam ishlov berish kaliti yoki hodisa barmoq izini saqlang. Qabul qiluvchingiz yana bir xil yetkazib berishni ko'rsa, u dublikat CRM eslatma, vaucher yoki xabarni qo'shmasligi kerak. URL oxirgi nuqtasini sir sifatida ko'ring.

Hodisa yuklash shakliga misol.

Buni avtomatlashtirish qadamingizga nusxalang 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
    }
  }
}

Veb-hukni sozlang va sinab koʻring

01

Backend, CRM, CRM, CRM, ⟦33267 integratsiya qatlamida HTTPS soʻnggi nuqtani yarating. Zapier Catch Hook. Make manzilni URL nusxalashdan oldin uni boshqarganingizga ishonch hosil qiling.

02

7Stamp Admin ichida Stamp Cards → API & Integrations → Webhooks oching.

03

Endpoint URL manzilini qoʻshing. Veb-huk profilning har bir karta hodisasini qabul qiladi, shuning uchun qabul qiluvchi tizimingizda data.event_type boʻyicha filtrlang.

04

Profil sozlamalarini saqlang, soʻngra hodisani yaratish uchun bir martalik sinov skanerini yoki karta harakatini ishga tushiring.

05

Qabul qilingan foydali yukni tekshiring. External ID va External Source raqamlarini kutilgan yozuvga moslang va qabul qiluvchi muvaffaqiyatli javob qaytarishini tasdiqlang.

06

CRM, vaucher yoki xabar almashishning nojoʻya taʼsirlarini faqat qayta oʻynash xavfsiz ishlatib, nosozliklarni kuzatganingizdan keyin yoqing.

No-code options: Make and Zapier

In Make, use Webhooks → Custom webhook to generate a receiving URL and paste it into the 7Stamp profili. Zapier da xuddi shu maqsadda Webhooks by Zapier → Catch Hook dan foydalaning. 7Stamp profili obunaga egalik qiladi, chunki joriy API veb-hukni avtomatik ro‘yxatga olish so‘nggi nuqtalarini ko‘rsatmaydi.

Xavfsizlik va yetkazib berish shartnomasi

Joriy foydali yuk (payload) sxemasi uchun manba sifatida ommaviy OpenAPI maʼlumotnomasining Webhooks boʻlimidan foydalaning. Soʻrov tanasi konvert koʻrinishida: profile_id va profile_name 7Stamp profilini bildiradi, event_id hodisani identifikatsiya qiladi, karta hodisasining oʻzi esa data ichida boʻladi (Make yoki Zapier URL manzili uchun kalit card_event boʻladi). Har bir yetkazish bitta sarlavhada imzolanadi, X-Webhook-Signature: t=…,s=…. HMAC-SHA256 qiymatini veb-huk maxfiy kaliti bilan t va undan keyingi xom soʻrov tanasi ustida hisoblang, uni hex koʻrinishida kodlang va s bilan solishtiring; maxfiy kalit 7Stamp Admin panelidagi veb-huk sahifasida joylashgan. Takroriy yetkazishlarni tashlab yuborish uchun X-Webhook-Event-Id dan foydalaning: qayta urinish yangi t bilan qaytadan imzolanadi. Endpointni Basic Auth bilan ham himoyalashingiz mumkin. HTTPS talab qiling va qabul qiluvchi URL manzilini ommaviy loglarga tushirmang.

Tez-tez beriladigan savollar

Faqat ma'lum webhook voqealarini tanlay olamanmi?

Yoʻq. 7Stamp veb-huki profilning har bir karta hodisasini qabul qiladi. Qabul qiluvchi tizimingizda data.event_type boʻyicha filtrlang; Make va Zapier ichida hodisa card_event ostida keladi, shuning uchun card_event.event_type boʻyicha filtrlang.

Qanday qilib vebhuklarni Make yoki Zapier ga ulash mumkin?

Create the receiving webhook in Make or a Catch Hook in Zapier, copy the generated URL, then paste it into the 7Stamp profile's webhook settings and send a test event.

Qanday qilib voqeani CRM kontaktimga moslashtirishim kerak?

data.external_id va mavjud boʻlsa, data.external_source dan foydalaning: ular API orqali oʻz ID raqamingiz bilan chiqargan kartalaringiz uchun har bir veb-hukda qaytib keladi. Kartani oʻzi olgan mijozda External ID boʻlmaydi, shuning uchun uni data.user.email boʻyicha moslang. Apple “Hide My Email” manzili vositachi (relay) manzil boʻlib, CRM tizimingizdagi manzil emas.

Veb-huk 7Stamp tomonidan yuborilganini qanday tekshirish mumkin?

X-Webhook-Signature sarlavhasini t va s ga ajrating, HMAC-SHA256 qiymatini 7Stamp Admin panelidagi veb-huk maxfiy kaliti bilan t va undan keyingi xom soʻrov tanasi ustida hisoblang, uni hex koʻrinishida kodlang va s bilan solishtiring. t qiymatini aynan yuborilgan holida, tanani esa har qanday JSON tahlilidan oldin qabul qilingan xom baytlar sifatida oling. X-Webhook-Event-Id si allaqachon qayta ishlangan yetkazishni tashlab yuboring: qayta urinish yangi t bilan qaytadan imzolanadi.

Keyingi qadam

Birinchi karta tadbirini yuborishga tayyormisiz?

Create a receiver, paste its HTTPS URL into the profile, run a disposable scan, and validate the matching External ID before enabling downstream automation.