Интеграция за разработчици

7stamp Webhooks

Налично

Изпратете всяко събитие за лоялност от 7stamp към вашите собствени системи в реално време. Без гласуване и планирани повиквания API. Събитията пристигат като HTTPS POST заявки в рамките на секунди след като се случат.

Използвайте уеб кукички, за да поддържате своя CRM, ERP или персонализиран бекенд в синхрон с това, което се случва от страна на лоялността: кой се е присъединил, кой е получил печат, кой е осребрил ваучер, кой е задействал подарък за рожден ден и кой е станал неактивен. След това вашите системи решават какво да правят с тези данни.

Какво можете да правите с webhooks

Webhooks са изходящата страна на интеграционния стек. Те отразяват активността на клиента и възнаграждението в системите, на които вече имате доверие за продажби, обслужване, анализи и съобщения.

Отразете историята на лоялността във вашия 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 — Клиент извади картата от портфейла си.

Изградете безопасен приемник на webhook

Потвърдете след трайна обработка

Вашата крайна точка трябва да приеме HTTPS POST, потвърдете формата на заявката, запазете или поставете събитието на опашка, след което върнете успешен отговор 2xx. Не правете бавно CRM или повикване за съобщения преди потвърждението, ако то може безопасно да бъде поставено на опашка.

Корелирайте с External ID

Всяко свързано събитие може да носи External ID и незадължително External Source, които сте използвали при създаването или сканирането на картата. Използвайте тази двойка, за да актуализирате свой собствен CRM, POS или запис на поръчка, без да гадаете по име или имейл.

Make доставка idempotent

Съхранявайте траен ключ за обработка или пръстов отпечатък на събитие, преди да задействате странични ефекти. Ако вашият получател отново види същата доставка, той не трябва да добавя дубликат 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

Създаване на HTTPS крайна точка във вашия бекенд, CRM интеграционен слой, Make уебкукичка или Zapier Catch Hook. Make уверете се, че контролирате дестинацията, преди да копирате нейния 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 не излага автоматичните крайни точки за регистриране на webhook.

Договор за сигурност и доставка

Използвайте секцията Webhooks на публичната справка OpenAPI като източник за текущата схема на полезен товар и значението на полето. Изисквайте HTTPS, дръжте приемника URL извън публичните регистрационни файлове и направете обработката идемпотентна. Потвърдете процедурата за заявка за удостоверяване/signature за вашия профил 7stamp по време на интегрирането, преди да наложите конкретно име на заглавка или политика за повторен опит в производството.

Често задавани въпроси

Мога ли да избера само определени уебкукички?

Да. Изберете типовете събития в настройките на webhook на профила 7stamp, така че приемникът да получава само събитията, които имат значение за неговия работен процес.

Как да свържа уебкукички към Make или Zapier?

Създайте получаващата уебкукичка в Make или Catch Hook в Zapier, копирайте генерирания URL, след това го поставете в настройките на уебкукичката на профила 7stamp и изпратете тестово събитие.

Как да свържа събитие с моя контакт CRM?

Използвайте External ID и, когато има, External Source. Това са идентификаторите, предоставени от вашата интеграция, когато картата е създадена или сканирана.

Трябва ли да приема заглавка на подпис или време за повторен опит?

Не. Използвайте текущия договор за доставка OpenAPI/profile и потвърдете процедурата за удостоверяване на вашия профил по време на интегрирането, преди да кодирате твърдо заглавка или да опитате отново.

Следваща стъпка

Готови ли сте да изпратите първото събитие с карта?

Създайте приемник, поставете неговия HTTPS URL в профила, стартирайте сканиране за еднократна употреба и потвърдете съвпадението External ID, преди да активирате автоматизацията надолу по веригата.