Sadiqlik tarixçənizə CRM daxil edin
Hər bir möhür, çek, ad günü və hərəkətsizlik tetikleyicisi CRM-da müştəri qeydinə düşür. Siz 7Stamp-ə daxil olmadan satışların, zənglərin və biletlərin yanında tam sadiqlik qrafikini görürsünüz.
Tərtibatçı inteqrasiyası
7Stamp Webhooks
MövcuddurHər bir sadiqlik hadisəsini 7Stamp-dan real vaxt rejimində öz sistemlərinizə çatdırın. Səsvermə və planlaşdırılmış API zənglər yoxdur. Hadisələr baş verəndən sonra saniyələr ərzində HTTPS POST tələbləri kimi gəlir.
CRM, ERP və ya fərdi backendinizi sadiqlik tərəfində baş verənlərlə sinxronlaşdırmaq üçün veb-qançlardan istifadə edin: kim qoşuldu, kim möhür aldı, kim çeki geri aldı, kim ad günü hədiyyəsi verdi və kim qeyri-aktiv oldu. Sonra sistemləriniz bu məlumatlarla nə edəcəyinə qərar verir.
Webhooks ilə nə edə bilərsiniz
Webhooks inteqrasiya yığınının gedən tərəfidir. Onlar müştəri və mükafat fəaliyyətini satış, xidmət, analitika və mesajlaşma üçün artıq etibar etdiyiniz sistemlərə əks etdirir.
Öz mesajlaşma yığınınızı işə salın
Müştəri çeki geri aldıqda, mövcud SMS şlüzünüzdən SMS təşəkkür məktubu göndərin. Müştəri hədəfə çatdıqda, Slack-da qeyd yazın. Kimsə qeyri-aktiv olduqda, işi hesab menecerinizə yönləndirin.
Güc analitikası və uzlaşma
Hadisələri BI alətinizə, anbarınıza və ya uyğunlaşdırma boru kəmərinizə yayımlayın. Vauçer ödənişlərini POS qəbzləri ilə uyğunlaşdırın və öz ölçülərinizlə ROI sadiqliyini hesablayın.
Kart hadisə növləri
SCAN — Kart skan edildi / möhür əməliyyatı qeydə alındı.
REWARD_EARNED — Kartda mükafat qazanıldı.
VOUCHER_ISSUED — Kupça verilib.
VOUCHER_REDEEMED — Vauçer alındı.
LOTTERY_WIN — Lotereya uduşla nəticələndi.
DELIVERY_INSERT — Çatdırılma-insert axını qeydə alınıb.
CARD_JOINED — Müştəri karta qoşuldu.
CARD_CAMPAIGN — Kart kampaniyası hadisəsi baş verdi.
BIRTHDAY_GREETING — Ad günü təbriki tədbiri baş verdi.
ADMIN_VOUCHER_ISSUE — Administrator çek verdi.
CARD_ADDED_TO_WALLET — Müştəri kartı Wallet-a əlavə etdi.
CARD_REMOVED_FROM_WALLET — Müştəri kartı Wallet-dan çıxardı.
Təhlükəsiz webhook qəbuledicisi yaradın
Davamlı rəftardan sonra etiraf edin
Son nöqtəniz HTTPS POST qəbul etməli, sorğu şəklini doğrulamalı, tədbiri davam etdirməli və ya növbəyə qoymalı, sonra uğurlu 2xx cavabı qaytarmalıdır. Təhlükəsiz növbəyə qoymaq olarsa, qəbul etməzdən əvvəl yavaş CRM və ya mesajlaşma zəngi etməyin.
External ID ilə əlaqələndirin
Hər bir əlaqəli hadisə kartı yaratarkən və ya skan edərkən istifadə etdiyiniz External ID və isteğe bağlı External Source-ni daşıya bilər. Öz CRM, POS və ya ad və ya e-poçtdan təxmin etmədən qeydinizi yeniləmək üçün bu cütdən istifadə edin.
Make çatdırılma idempotent
Yan təsirləri işə salmazdan əvvəl davamlı emal açarı və ya hadisə barmaq izini saxlayın. Əgər alıcınız eyni çatdırılmanı yenidən görürsə, o, dublikat CRM qeyd, çek və ya mesaj əlavə etməməlidir. Son nöqtəni URL sirr kimi qəbul edin.
Nümunə hadisə yükü forması
Bunu avtomatlaşdırma addımınıza kopyalayın
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
}
}
}Webhook-u konfiqurasiya edin və sınaqdan keçirin
Backendinizdə HTTPS son nöqtəsi, CRM, inteqrasiya qatı, CRM, ⟦1hook2, ⟦1hook2 yaradın Zapier Catch Hook. Make URL-ni kopyalamadan əvvəl təyinatı idarə etdiyinizə əmin olun.
7Stamp Admin daxilində Stamp Cards → API & Integrations → Webhooks açın.
Endpoint URL-ini əlavə edin. Webhook profilin bütün kart hadisələrini qəbul edir, ona görə də qəbuledicinizdə data.event_type üzrə filtrləyin.
Profil parametrlərini yadda saxlayın, sonra hadisə yaratmaq üçün birdəfəlik test skanını və ya kart əməliyyatını işə salın.
Qəbul edilən faydalı yükü yoxlayın. External ID və External Source-ni gözlənilən qeydə uyğunlaşdırın və alıcının uğurlu cavab qaytardığını təsdiqləyin.
CRM, çek və ya mesajlaşma yan təsirlərini yalnız təkrar oynatma üçün təhlükəsiz idarə etdikdən və nasazlıqlara nəzarət etdikdən sonra aktiv edin.
Kodsuz seçimlər: Make və Zapier
Make-də qəbuledici URL yaratmaq üçün Webhooks → Custom webhook istifadə edin və onu 7Stamp profilinə yapışdırın. Zapier-də eyni məqsəd üçün Webhooks by Zapier → Catch Hook istifadə edin. 7Stamp profili abunəliyə sahibdir, çünki cari API avtomatik webhook qeydiyyatının son nöqtələrini ifşa etmir.
Təhlükəsizlik və çatdırılma müqaviləsi
Cari faydalı yük sxemi üçün mənbə kimi ictimai OpenAPI arayışının Webhooks bölməsindən istifadə edin. Gövdə bir zərfdir: profile_id və profile_name 7Stamp profilini göstərir, event_id hadisəni identifikasiya edir, kart hadisəsinin özü isə data daxilindədir (Make və ya Zapier URL-i üçün açar card_event-dir). Hər çatdırılma bir başlıqda imzalanır, X-Webhook-Signature: t=…,s=…. HMAC-SHA256 dəyərini webhook gizli açarı ilə t üstəgəl xam sorğu gövdəsi üzərində hesablayın, onu hex formatında kodlaşdırın və s ilə müqayisə edin; gizli açar 7Stamp Admin-də webhook-un səhifəsindədir. Təkrar çatdırılmaları atmaq üçün X-Webhook-Event-Id-dən istifadə edin: təkrar cəhd yeni t ilə yenidən imzalanır. Endpoint-i Basic Auth ilə də qoruya bilərsiniz. HTTPS tələb edin və qəbuledicinin URL-ini ictimai loglardan kənarda saxlayın.
Tez-tez verilən suallar
Mən yalnız müəyyən webhook hadisələrini seçə bilərəmmi?
Xeyr. 7Stamp webhook-u profilin bütün kart hadisələrini qəbul edir. Qəbuledicinizdə data.event_type üzrə filtrləyin; Make və Zapier-də hadisə card_event altında gəlir, ona görə də card_event.event_type üzrə filtrləyin.
Webhook-ları Make və ya Zapier-ə necə qoşmaq olar?
Make və ya Zapier-də Catch Hook və ya Zapier-də qəbuledici veb-qanca yaradın, yaradılan URL-ni kopyalayın, sonra onu 7Stamp hadisə parametrlərinə yapışdırın və test göndərin.
Tədbiri CRM kontaktımla necə uyğunlaşdırmalıyam?
data.external_id və mövcud olduqda data.external_source-dan istifadə edin: onlar API vasitəsilə öz ID-nizlə buraxdığınız kartlar üçün hər webhook-da geri qayıdır. Kartı özü götürmüş müştərinin External ID-si yoxdur, ona görə də onu data.user.email ilə uyğunlaşdırın. Apple “Hide My Email” ünvanı yönləndirmə ünvanıdır, CRM-inizdəki ünvan deyil.
Webhook-un 7Stamp-dan gəldiyini necə yoxlaya bilərəm?
X-Webhook-Signature başlığını t və s hissələrinə ayırın, 7Stamp Admin-dən alınan webhook gizli açarı ilə HMAC-SHA256 dəyərini t üstəgəl xam sorğu gövdəsi üzərində hesablayın, onu hex formatında kodlaşdırın və s ilə müqayisə edin. t-ni tam göndərildiyi kimi, gövdəni isə alınmış xam baytlar kimi, istənilən JSON təhlilindən əvvəl götürün. X-Webhook-Event-Id-si artıq emal etdiyiniz çatdırılmanı atın: təkrar cəhd yeni t ilə yenidən imzalanır.
Əlaqədar səhifələr
Növbəti addım
İlk kart tədbirini göndərməyə hazırsınız?
Qəbuledici yaradın, onun HTTPS URL-ni profilə yapışdırın, birdəfəlik skan edin və aşağı axın avtomatlaşdırmasını işə salmazdan əvvəl uyğun gələn External ID-i doğrulayın.