Пресликајте историју лојалности у свој CRM
Сваки печат, ваучер, рођендан и окидач неактивности слете у евиденцију клијента у вашем CRM. Видећете пуну временску линију лојалности поред продаје, позива и карата без пријављивања на 7Stamp.
Интеграција програмера
7Stamp Вебхоокс
ДоступанПребаците сваки догађај лојалности са 7Stamp на своје системе у реалном времену. Нема гласања и нема заказаних API позива. Догађаји стижу према захтевима HTTPS POST у року од неколико секунди након што се десе.
Користите веб-хукове да бисте синхронизовали свој CRM, ERP или прилагођени бацкенд са оним што се дешава на страни лојалности: ко се придружио, ко је добио печат, ко је искористио ваучер, ко је покренуо рођендански поклон и ко је постао неактиван. Тада ваши системи одлучују шта да раде са тим подацима.
Шта можете да урадите са веб-хуковима
Веб-хукови су излазна страна интеграционог стека. Они одражавају активност купаца и награђивања у системе којима већ верујете за продају, услуге, аналитику и размену порука.
Покрените сопствени стек за размену порука
Када купац искористи ваучер, пошаљите захвалницу 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, потврди облик захтева, настави или стави догађај у ред, а затим врати успешан 2кк одговор. Немојте упућивати спор 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
}
}
}Конфигуришите и тестирајте веб-хук
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 и Zapier
У Make, користите Webhooks → Custom webhook да генеришете пријем URL и налепите га у профил 7Stamp. У Zapier, користите Webhooks by Zapier → Catch Hook за исту сврху. Профил 7Stamp поседује претплату јер тренутни API не открива крајње тачке аутоматске регистрације веб-хука.
Уговор о безбедности и испоруци
Као извор за актуелну шему садржаја (payload) користите одељак Webhooks јавне OpenAPI референце. Тело захтева је коверат: profile_id и profile_name означавају профил 7Stamp, event_id идентификује догађај, а сам догађај картице налази се у data (за URL из Make или Zapier кључ је card_event). Свака испорука је потписана у једном заглављу, X-Webhook-Signature: t=…,s=…. Израчунајте HMAC-SHA256 тајним кључем веб-хука над t иза којег следи необрађено тело захтева, резултат кодирајте хексадецимално и упоредите га са вредношћу 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?
Креирајте пријемни веб-хук у 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 иза којег следи необрађено тело захтева, резултат кодирајте хексадецимално и упоредите га са вредношћу s. Узмите t тачно онако како је послат, а тело као необрађене примљене бајтове, пре било каквог JSON парсирања. Одбаците испоруку чији сте X-Webhook-Event-Id већ обрадили: поновни покушај се поново потписује новим t.
Повезане странице
Следећи корак
Спремни да пошаљете прву картицу?
Направите пријемник, налепите његов HTTPS URL у профил, покрените скенирање за једнократну употребу и потврдите подударање External ID пре него што омогућите аутоматизацију низводно.