Интеграција програмера

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, потврди облик захтева, настави или стави догађај у ред, а затим врати успешан 2кк одговор. Немојте упућивати спор 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, користите Webhooks → Custom webhook да генеришете пријем URL и налепите га у профил 7stamp. У Zapier, користите Webhooks by Zapier → Catch Hook за исту сврху. Профил 7stamp поседује претплату јер тренутни API не открива крајње тачке аутоматске регистрације веб-хука.

Уговор о безбедности и испоруци

Користите одељак Веб-кукице јавне референце OpenAPI као извор за тренутну шему корисног оптерећења и значење поља. Захтевајте HTTPS, држите пријемник URL ван јавних евиденција и учините обраду идемпотентном. Потврдите процедуру захтева-аутентификација/signature за ваш 7stamp профил током укључивања пре него што примените одређено име заглавља или поновите политику у продукцији.

Често постављана питања

Да ли могу да изаберем само одређене вебхоок догађаје?

Да. Изаберите типове догађаја у подешавањима веб-хука профила 7stamp тако да прималац добија само догађаје који су важни за његов ток рада.

Како да повежем веб-хукове на Make или Zapier?

Креирајте пријемни веб-хук у Make или Catch Hook у Zapier, копирајте генерисани URL, а затим га налепите у подешавања веб-хука профила 7stamp и пошаљите пробни догађај.

Како да повежем догађај са својим контактом CRM?

Користите External ID и, када је присутан, External Source. Ово су идентификатори које је ваша интеграција дала када је картица креирана или скенирана.

Да ли треба да претпоставим заглавље потписа или време за поновни покушај?

Не. Користите тренутни уговор о испоруци OpenAPI⟧/profile и потврдите процедуру аутентификације за свој профил током укључивања пре него што чврсто кодирате заглавље или претпоставку поновног покушаја.

Следећи корак

Спремни да пошаљете прву картицу?

Направите пријемник, налепите његов HTTPS URL у профил, покрените скенирање за једнократну употребу и потврдите подударање External ID пре него што омогућите аутоматизацију низводно.