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

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

Создайте конечную точку 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 не предоставляет конечные точки автоматической регистрации веб-перехватчиков.

Контракт безопасности и доставки.

Используйте раздел Webhooks общедоступной ссылки 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 перед включением последующей автоматизации.