Әзірлеушілерді біріктіру
Әрбір адалдық оқиғасын 7Stamp бастап нақты уақытта өз жүйелеріңізге жылжытыңыз. Сауалнама жоқ және жоспарланған API қоңыраулар жоқ. Оқиғалар HTTPS POST сұраулары ретінде орын алғаннан кейін бірнеше секунд ішінде келеді.
CRM, ERP немесе пайдаланушы серверін адалдық жағында болып жатқан әрекеттермен синхрондау үшін веб-хуктарды пайдаланыңыз: кім қосылды, кім мөр алды, ваучерді кім алды, кім туған күн сыйлығын бастады және кім белсенді болды. Содан кейін сіздің жүйелеріңіз бұл деректермен не істеу керектігін шешеді.
Веб ілмектері шығыс стекінің біріктіру жағы болып табылады. Олар сіз сату, қызмет көрсету, аналитика және хабар алмасу үшін сенетін жүйелерде тұтынушылар мен марапаттау қызметін көрсетеді.
Әрбір мөр, ваучер, туған күн және әрекетсіздік триггері CRM ішіндегі тұтынушы жазбасына түседі. Сіз 7Stamp жүйесіне кірмей-ақ, сатылымдар, қоңыраулар және билеттер жанындағы толық адалдық хронологиясын көресіз.
Тұтынушы ваучерді өтегенде, бар SMS шлюзінен алғыс SMS жіберіңіз. Тұтынушы мақсатқа жеткенде, Slack нөміріне мереке жариялаңыз. Біреу әрекетсіз болған кезде, істі есептік жазба менеджеріне жіберіңіз.
Оқиғаларды BI құралына, қоймасына немесе салыстыру құбырына жіберіңіз. Ваучерлік өтеуді POS түбіртектерімен сәйкестендіріңіз және ROI адалдығын жеке көрсеткіштеріңізде есептеңіз.
Соңғы нүкте HTTPS POST қабылдауы, сұрау пішінін растауы, оқиғаны сақтау немесе кезекке қою, содан кейін сәтті 2xx жауабын қайтаруы керек. Қауіпсіз кезекке қою мүмкін болса, растау алдында баяу CRM немесе хабар алмасу қоңырауын жасамаңыз.
Әрбір қатысты оқиға картаны жасау немесе сканерлеу кезінде пайдаланған External ID және қосымша External Source болуы мүмкін. Өзіңіздің CRM, POS немесе атауды немесе электрондық поштаны таппай-ақ тапсырыс жазбаңызды жаңарту үшін осы жұпты пайдаланыңыз.
Жанама әсерлерді тудырмас бұрын ұзақ өңдеу кілтін немесе оқиға саусақ ізін сақтаңыз. Егер ресивер бірдей жеткізілімді қайта көрсе, ол қайталанатын 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
}
}
}Create an HTTPS endpoint in your backend, CRM integration layer, Make webhook, or Zapier Catch Hook. Make sure you control the destination before copying its URL.
7Stamp Admin ішінде Stamp Cards → API & Integrations → Webhooks ашыңыз.
Эндпоинт URL мекенжайын қосыңыз. Вебхук профильдің барлық карта оқиғаларын қабылдайды, сондықтан қабылдағышыңызда data.event_type бойынша сүзіңіз.
Профиль параметрлерін сақтаңыз, содан кейін оқиғаны жасау үшін бір реттік сынақ сканерлеуін немесе карта әрекетін іске қосыңыз.
Алынған пайдалы жүктемені тексеріңіз. External ID және External Source сандарын күтілетін жазбаға сәйкестендіріңіз және қабылдаушының сәтті жауап қайтаратынын растаңыз.
CRM, ваучер немесе хабар алмасу жанама әсерлерін қайта ойнату қауіпсіз өңдеуден және сәтсіздіктерді бақылаудан кейін ғана қосыңыз.
Make ішінде қабылдау URL жасау үшін Webhooks → Custom webhook пайдаланыңыз және оны 7Stamp профиліне қойыңыз. Zapier ішінде сол мақсат үшін Webhooks by Zapier → Catch Hook пайдаланыңыз. 7Stamp профилі жазылымға ие, себебі ағымдағы API автоматты веб-ілгек тіркеу соңғы нүктелерін көрсетпейді.
Ағымдағы пайдалы жүктеме схемасы үшін дереккөз ретінде жалпыға ортақ OpenAPI анықтамалығының Webhooks бөлімін пайдаланыңыз. Дене — конверт: profile_id және profile_name 7Stamp профилін атайды, event_id оқиғаны анықтайды, ал карта оқиғасының өзі data ішінде болады (Make немесе Zapier URL мекенжайы үшін кілт — card_event). Әр жеткізілімге бір тақырыпта қол қойылады, X-Webhook-Signature: t=…,s=…. Вебхук құпияңызбен t мәні мен өңделмеген сұрау денесін қосып, HMAC-SHA256 есептеңіз, оны hex түрінде кодтап, s мәнімен салыстырыңыз; құпия 7Stamp Admin ішіндегі вебхук бетінде орналасқан. Қайталанған жеткізілімдерді алып тастау үшін X-Webhook-Event-Id пайдаланыңыз: қайталау жаңа t мәнімен қайта қол қойылады. Эндпоинтті Basic Auth арқылы да қорғауға болады. HTTPS талап етіңіз және қабылдағыштың URL мекенжайын жалпыға ашық журналдарға шығармаңыз.
Жоқ. 7Stamp вебхугы профильдің барлық карта оқиғаларын қабылдайды. Қабылдағышыңызда data.event_type бойынша сүзіңіз; Make және Zapier ішінде оқиға card_event астында келеді, сондықтан card_event.event_type бойынша сүзіңіз.
Make ішінде қабылдау веб-хук немесе Zapier ішінде Catch Hook жасаңыз, жасалған URL файлын көшіріңіз, содан кейін оны 7Stamp профилінің веб-хук параметрлеріне қойыңыз және сынақ оқиғасын жіберіңіз.
data.external_id және бар болса, data.external_source пайдаланыңыз: олар API арқылы өз идентификаторыңызбен шығарған карталар үшін әр вебхукта қайтарылады. Картаны өзі алған клиентте External ID болмайды, сондықтан оны data.user.email бойынша сәйкестендіріңіз. Apple «Hide My Email» мекенжайы — сіздің CRM жүйеңіздегі мекенжай емес, қайта бағыттаушы мекенжай.
X-Webhook-Signature тақырыбын t және s бөліктеріне бөліңіз, 7Stamp Admin ішіндегі вебхук құпиясымен t мәні мен өңделмеген сұрау денесін қосып, HMAC-SHA256 есептеңіз, оны hex түрінде кодтап, s мәнімен салыстырыңыз. t мәнін дәл жіберілгендей, ал денені кез келген JSON талдауынан бұрын алынған өңделмеген байттар ретінде алыңыз. X-Webhook-Event-Id мәнін бұрын өңдеген жеткізілімді алып тастаңыз: қайталау жаңа t мәнімен қайта қол қойылады.
Келесі қадам
Ресивер жасаңыз, оның HTTPS URL нөмірін профильге қойыңыз, бір реттік сканерлеуді орындаңыз және төменгі ағынды автоматтандыруды қоспас бұрын сәйкес келетін External ID растаңыз.