Әзірлеушілерді біріктіру

7stamp Веб-хуктар

Қол жетімді

Әрбір адалдық оқиғасын 7stamp бастап нақты уақытта өз жүйелеріңізге жылжытыңыз. Сауалнама жоқ және жоспарланған API қоңыраулар жоқ. Оқиғалар HTTPS POST сұраулары ретінде орын алғаннан кейін бірнеше секунд ішінде келеді.

CRM, ERP немесе пайдаланушы серверін адалдық жағында болып жатқан әрекеттермен синхрондау үшін веб-хуктарды пайдаланыңыз: кім қосылды, кім мөр алды, ваучерді кім алды, кім туған күн сыйлығын бастады және кім белсенді болды. Содан кейін сіздің жүйелеріңіз бұл деректермен не істеу керектігін шешеді.

Веб ілмектермен не істеуге болады

Веб ілмектері шығыс стекінің біріктіру жағы болып табылады. Олар сіз сату, қызмет көрсету, аналитика және хабар алмасу үшін сенетін жүйелерде тұтынушылар мен марапаттау қызметін көрсетеді.

Адалдық тарихын CRM нөміріне айналдырыңыз

Әрбір мөр, ваучер, туған күн және әрекетсіздік триггері CRM ішіндегі тұтынушы жазбасына түседі. Сіз 7stamp жүйесіне кірмей-ақ, сатылымдар, қоңыраулар және билеттер жанындағы толық адалдық хронологиясын көресіз.

Өзіңіздің хабар алмасу стегіңізді іске қосыңыз

Тұтынушы ваучерді өтегенде, бар SMS шлюзінен алғыс SMS жіберіңіз. Тұтынушы мақсатқа жеткенде, Slack нөміріне мереке жариялаңыз. Біреу әрекетсіз болған кезде, істі есептік жазба менеджеріне жіберіңіз.

Қуатты талдау және салыстыру

Оқиғаларды BI құралына, қоймасына немесе салыстыру құбырына жіберіңіз. Ваучерлік өтеуді POS түбіртектерімен сәйкестендіріңіз және ROI адалдығын жеке көрсеткіштеріңізде есептеңіз.

Карта оқиғасының түрлері

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 POST қабылдауы, сұрау пішінін растауы, оқиғаны сақтау немесе кезекке қою, содан кейін сәтті 2xx жауабын қайтаруы керек. Қауіпсіз кезекке қою мүмкін болса, растау алдында баяу CRM немесе хабар алмасу қоңырауын жасамаңыз.

External ID арқылы байланыстыру

Әрбір қатысты оқиға картаны жасау немесе сканерлеу кезінде пайдаланған External ID және қосымша External Source болуы мүмкін. Өзіңіздің CRM, POS немесе атауды немесе электрондық поштаны таппай-ақ тапсырыс жазбаңызды жаңарту үшін осы жұпты пайдаланыңыз.

Make жеткізу идемпотенті

Жанама әсерлерді тудырмас бұрын ұзақ өңдеу кілтін немесе оқиға саусақ ізін сақтаңыз. Егер ресивер бірдей жеткізілімді қайта көрсе, ол қайталанатын CRM жазбаны, ваучерді немесе хабарды қоспауы керек. URL соңғы нүктесін құпия ретінде қарастырыңыз.

Оқиғаның пайдалы жүктеме пішіні мысалы

Мұны автоматтандыру қадамыңызға көшіріңіз 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"
}

Веб-хукты конфигурациялаңыз және сынаңыз

01

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.

02

7stamp Admin ішінде Stamp Cards → API & Integrations → Webhooks ашыңыз.

03

Соңғы нүкте URL қосыңыз және қабылдау жұмыс үрдісіне нақты қажет оқиға түрлерін ғана таңдаңыз.

04

Профиль параметрлерін сақтаңыз, содан кейін оқиғаны жасау үшін бір реттік сынақ сканерлеуін немесе карта әрекетін іске қосыңыз.

05

Алынған пайдалы жүктемені тексеріңіз. External ID және External Source сандарын күтілетін жазбаға сәйкестендіріңіз және қабылдаушының сәтті жауап қайтаратынын растаңыз.

06

CRM, ваучер немесе хабар алмасу жанама әсерлерін қайта ойнату қауіпсіз өңдеуден және сәтсіздіктерді бақылаудан кейін ғана қосыңыз.

Кодсыз опциялар: Make және Zapier

Make ішінде қабылдау URL жасау үшін Webhooks → Custom webhook пайдаланыңыз және оны 7stamp профиліне қойыңыз. Zapier ішінде сол мақсат үшін Webhooks by Zapier → Catch Hook пайдаланыңыз. 7stamp профилі жазылымға ие, себебі ағымдағы API автоматты веб-ілгек тіркеу соңғы нүктелерін көрсетпейді.

Қауіпсіздік және жеткізу келісімшарты

Ағымдағы пайдалы жүктеме схемасы мен өріс мағынасының көзі ретінде жалпыға ортақ OpenAPI сілтемесінің Webhooks бөлімін пайдаланыңыз. HTTPS талап етіңіз, ресиверді URL жалпыға ортақ журналдардан сақтаңыз және өңдеуді идемпотентті етіңіз. Өндірісте нақты тақырып атауын немесе қайталау саясатын қолданудан бұрын қосу кезінде 7stamp профиліңіз үшін сұрау-аутентификация/signature процедурасын растаңыз.

Жиі қойылатын сұрақтар

Кейбір вебхук оқиғаларын ғана таңдай аламын ба?

Иә. 7stamp профилінің веб-ілгек параметрлерінде оқиға түрлерін таңдаңыз, сонда ресивер тек жұмыс үрдісіне маңызды оқиғаларды алады.

Вебхуктарды Make немесе Zapier-ге қалай қосуға болады?

Make ішінде қабылдау веб-хук немесе Zapier ішінде Catch Hook жасаңыз, жасалған URL файлын көшіріңіз, содан кейін оны 7stamp профилінің веб-хук параметрлеріне қойыңыз және сынақ оқиғасын жіберіңіз.

Оқиғаны CRM контактімен қалай сәйкестендіруім керек?

External ID және бар болса, External Source пайдаланыңыз. Бұл карта жасалған немесе сканерленген кезде біріктірілген идентификаторлар.

Қолтаңба тақырыбын қабылдауым керек пе немесе уақытты қайталау керек пе?

Жоқ. Ағымдағы OpenAPI/profile жеткізу келісімшартын пайдаланыңыз және тақырыпты қатты кодтаудан немесе болжамды қайталаудан бұрын қосу кезінде профиліңіздің аутентификация процедурасын растаңыз.

Келесі қадам

Алғашқы карта оқиғасын жіберуге дайынсыз ба?

Ресивер жасаңыз, оның HTTPS URL нөмірін профильге қойыңыз, бір реттік сканерлеуді орындаңыз және төменгі ағынды автоматтандыруды қоспас бұрын сәйкес келетін External ID растаңыз.