ასახეთ ლოიალობის ისტორია თქვენს CRM-ში
ყოველი შტამპი, ვაუჩერი, დაბადების დღე და უმოქმედობის გამომწვევი ხდება მომხმარებლის ჩანაწერში თქვენს CRM-ში. თქვენ ხედავთ ლოიალობის სრულ ვადებს გაყიდვების, ზარების და ბილეთების გვერდით 7Stamp-ში შესვლის გარეშე.
დეველოპერის ინტეგრაცია
7Stamp Webhooks
ხელმისაწვდომიაგადაიტანეთ ლოიალობის ყველა ღონისძიება 7Stamp-დან თქვენს საკუთარ სისტემებზე რეალურ დროში. არანაირი კენჭისყრა და დაგეგმილი API ზარები. მოვლენები ჩამოდის როგორც HTTPS POST ითხოვს განხორციელებიდან წამებში.
გამოიყენეთ ვებჰუკები, რათა შეინარჩუნოთ თქვენი CRM, ERP ან მორგებული ბექენდი სინქრონულად იმასთან, რაც ხდება ლოიალობის მხარეს: ვინ შეუერთდა, ვინ მიიღო ბეჭედი, ვინ გამოისყიდა ვაუჩერი, ვინ გაიღო დაბადების დღის საჩუქარი და ვინ გახდა არააქტიური. შემდეგ თქვენი სისტემები გადაწყვეტენ რა გააკეთონ ამ მონაცემებთან.
რისი გაკეთება შეგიძლიათ ვებჰუკებით
Webhooks არის ინტეგრაციის სტეკის გამავალი მხარე. ისინი ასახავს კლიენტებს და აჯილდოვებს იმ სისტემებს, რომლებსაც უკვე ენდობით გაყიდვების, მომსახურების, ანალიტიკისა და შეტყობინებების შესახებ.
გააქტიურეთ თქვენი საკუთარი შეტყობინებების დასტა
როდესაც მომხმარებელი გამოისყიდის ვაუჩერს, გაგზავნეთ მადლობის SMS თქვენი არსებული SMS კარიბჭედან. როდესაც მომხმარებელი მიზანს მიაღწევს, გამოაქვეყნეთ ზეიმი Slack-ში. როდესაც ვინმე უმოქმედო გახდება, საქმე თქვენი ანგარიშის მენეჯერისკენ გაატარეთ.
ენერგეტიკული ანალიტიკა და შეჯერება
მოვლენების სტრიმინგი თქვენს BI ხელსაწყოში, საწყობში ან შერიგების მილსადენში. შეადარეთ ვაუჩერის გამოსყიდვები POS ქვითრებთან და გამოთვალეთ ლოიალობის ROI თქვენი საკუთარი მეტრიკის მიხედვით.
ბარათის მოვლენის ტიპები
SCAN — ბარათმა მიიღო scan/stamp მოქმედება.
REWARD_EARNED — ჯილდო იყო მიღებული ბარათზე.
VOUCHER_ISSUED — გაიცა ვაუჩერი.
VOUCHER_REDEEMED — გამოისყიდეს ვაუჩერი.
LOTTERY_WIN — გათამაშებამ მოიგო მოგება.
DELIVERY_INSERT — დაფიქსირდა მიწოდების ჩასმის ნაკადი.
CARD_JOINED — კლიენტი შეუერთდა ბარათს.
CARD_CAMPAIGN — მოხდა ბარათის კამპანიის ღონისძიება.
BIRTHDAY_GREETING - მოხდა დაბადების დღის მისალოცი ღონისძიება.
ADMIN_VOUCHER_ISSUE — ადმინისტრატორმა გასცა ვაუჩერი.
CARD_ADDED_TO_WALLET — მომხმარებელმა დაამატა ბარათი თავის საფულეში.
CARD_REMOVED_FROM_WALLET — მომხმარებელმა ამოიღო ბარათი საფულედან.
შექმენით უსაფრთხო ვებჰუკის მიმღები
აღიარება გრძელვადიანი დამუშავების შემდეგ
თქვენმა საბოლოო წერტილმა უნდა მიიღოს HTTPS HTTPS TMXCONST4MTque მოთხოვნა, დააბრუნოს თითო მოვლენა, დააბრუნოს თითო ფორმა, დააბრუნოს ფორმა. წარმატებული 2xx პასუხი. ნუ განახორციელებთ ნელი CRM ან შეტყობინების გაგზავნის ზარს დადასტურებამდე, თუ ის შეიძლება უსაფრთხოდ დადგეს რიგში.
კორელაცია External ID
-თან ყველა დაკავშირებულ მოვლენას შეუძლია ატაროს External ID და სურვილისამებრ External Source, რომლებიც იყენებდით ბარათის შექმნის ან სკანირებისას. გამოიყენეთ ეს წყვილი, რათა განაახლოთ თქვენი საკუთარი CRM, POS, ან შეუკვეთოთ ჩანაწერი სახელის ან ელფოსტის გამოცნობის გარეშე.
Make მიწოდების უძლური
შეინახეთ გამძლე დამუშავების გასაღები ან მოვლენის თითის ანაბეჭდი გვერდითი ეფექტების გამოწვევამდე. თუ თქვენი მიმღები კვლავ დაინახავს იმავე მიწოდებას, მან არ უნდა დაამატოს დუბლიკატი CRM შენიშვნა, ვაუჩერი ან შეტყობინება. განიხილეთ საბოლოო წერტილი URL, როგორც საიდუმლო.
ღონისძიების დატვირთვის ფორმის მაგალითი
დააკოპირეთ ეს თქვენს ავტომატიზაციის ეტაპზე
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
}
}
}ვებჰუკის კონფიგურაცია და ტესტირება
შექმენით HTTPS ბოლო წერტილი თქვენს ბექენდში, CRM ინტეგრაციის ფენაში, Make webhook ან ZapierX. Make დარწმუნდით, რომ აკონტროლებთ დანიშნულების ადგილს მის URL-ის კოპირებამდე.
7Stamp Admin-ში გახსენით Stamp Cards → API & Integrations → Webhooks.
დაამატეთ ენდპოინტის URL. ვებჰუკი პროფილის ბარათის ყველა მოვლენას იღებს, ამიტომ გაფილტრეთ data.event_type-ის მიხედვით თქვენს მიმღებში.
შეინახეთ პროფილის პარამეტრები, შემდეგ ჩართეთ ერთჯერადი ტესტის სკანირება ან ბარათის მოქმედება მოვლენის შესაქმნელად.
შეამოწმეთ მიღებული დატვირთვა. შეადარეთ External ID და External Source მოსალოდნელ ჩანაწერს და დაადასტურეთ, რომ მიმღები აბრუნებს წარმატებულ პასუხს.
ჩართეთ CRM, ვაუჩერის ან შეტყობინებების გვერდითი ეფექტები მხოლოდ მას შემდეგ, რაც გექნებათ ხელახლა უსაფრთხო მართვა და მონიტორინგი წარუმატებლობისთვის.
კოდის გარეშე ვარიანტები: Make და Zapier
Make-ში გამოიყენეთ Webhooks → Custom webhook მიმღები URL დასაგენერებლად და ჩასვით 7Stamp პროფილში. Zapier-ში გამოიყენეთ Webhooks by Zapier → Catch Hook იმავე მიზნით. 7Stamp პროფილი ფლობს გამოწერას, რადგან ამჟამინდელი API არ ავლენს ვებჰუკის რეგისტრაციის საბოლოო წერტილებს.
უსაფრთხოებისა და მიწოდების ხელშეკრულება
მიმდინარე payload-ის სქემის წყაროდ გამოიყენეთ საჯარო OpenAPI ცნობარის Webhooks განყოფილება. ტანი არის კონვერტი: profile_id და profile_name მიუთითებენ 7Stamp-ის პროფილზე, event_id მოვლენის იდენტიფიკატორია, ხოლო თავად ბარათის მოვლენა არის data-ში (Make-ის ან Zapier-ის URL-ისთვის გასაღებია card_event). ყოველი მიწოდება ხელმოწერილია ერთ სათაურში, X-Webhook-Signature: t=…,s=…. გამოთვალეთ HMAC-SHA256 თქვენი ვებჰუკის საიდუმლო გასაღებით t-სა და მასზე მიერთებულ მოთხოვნის დაუმუშავებელ ტანზე, დააკოდირეთ hex-ად და შეადარეთ s-ს; საიდუმლო გასაღები არის ვებჰუკის გვერდზე 7Stamp Admin-ში. გამოიყენეთ X-Webhook-Event-Id განმეორებითი მიწოდებების უკუსაგდებად: ხელახალი მცდელობა ხელახლა ხელმოწერილია ახალი t-ით. ენდპოინტის დაცვა Basic Auth-ითაც შეგიძლიათ. მოითხოვეთ HTTPS და არ დაუშვათ მიმღების URL-ის მოხვედრა საჯარო ლოგებში.
ხშირად დასმული კითხვები
შემიძლია ავირჩიო მხოლოდ გარკვეული webhook მოვლენები?
არა. 7Stamp-ის ვებჰუკი პროფილის ბარათის ყველა მოვლენას იღებს. გაფილტრეთ data.event_type-ის მიხედვით თქვენს მიმღებში; Make-სა და Zapier-ში მოვლენა card_event-ის ქვეშ მოდის, ამიტომ გაფილტრეთ card_event.event_type-ის მიხედვით.
როგორ დავაკავშირო ვებჰუკები Make ან Zapier?
შექმენით მიმღები ვებ-ჰუკი Make-ში ან Catch Hook Zapier-ში, დააკოპირეთ გენერირებული URL, შემდეგ ჩასვით 7Stamp პროფილის ვებჰუკის პარამეტრებში და გაგზავნეთ სატესტო ღონისძიება.
როგორ დავამთხვიო მოვლენა ჩემს CRM კონტაქტს?
გამოიყენეთ data.external_id და, თუ არსებობს, data.external_source: ისინი ბრუნდება ყველა ვებჰუკში იმ ბარათებისთვის, რომლებიც API-ით გაეცით საკუთარი ID-ით. მომხმარებელს, რომელმაც ბარათი თავად აიღო, External ID არ აქვს, ამიტომ დააკავშირეთ ის data.user.email-ით. Apple-ის „Hide My Email“ მისამართი გადამისამართების მისამართია და არა ის, რომელიც თქვენს CRM-შია.
როგორ შევამოწმო, რომ ვებჰუკი 7Stamp-იდან მოვიდა?
X-Webhook-Signature სათაური დაყავით t-ად და s-ად, გამოთვალეთ HMAC-SHA256 ვებჰუკის საიდუმლო გასაღებით 7Stamp Admin-იდან t-სა და მასზე მიერთებულ მოთხოვნის დაუმუშავებელ ტანზე, დააკოდირეთ hex-ად და შეადარეთ s-ს. აიღეთ t ზუსტად ისე, როგორც გაიგზავნა, ხოლო ტანი — როგორც მიღებული დაუმუშავებელი ბაიტები, ნებისმიერ JSON პარსინგამდე. უკუაგდეთ მიწოდება, რომლის X-Webhook-Event-Id უკვე დაამუშავეთ: ხელახალი მცდელობა ხელახლა ხელმოწერილია ახალი t-ით.
დაკავშირებული გვერდები
შემდეგი ნაბიჯი
მზად ხართ გაგზავნოთ პირველი ბარათის ღონისძიება?
შექმენით მიმღები, ჩასვით მისი HTTPS URL პროფილში, ჩაატარეთ ერთჯერადი სკანირება და დაადასტურეთ შესაბამისი External ID ავტომატიზაციის ჩართვამდე.