Отразите историю лояльности в своем 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, проверьте форму запроса, сохраните или поставьте событие в очередь, а затем верните успешный ответ 2xx. Не делайте медленный вызов 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
}
}
}Настройка и тестирование веб-перехватчика
Создайте конечную точку HTTPS в вашем бэкэнде, CRM уровень интеграции, Make веб-перехватчик или Zapier Catch Hook. Make убедитесь, что вы контролируете пункт назначения, прежде чем копировать его 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 не предоставляет конечные точки автоматической регистрации веб-перехватчиков.
Контракт безопасности и доставки.
Используйте раздел Webhooks публичного справочника OpenAPI как источник актуальной схемы полезной нагрузки. Тело запроса — это конверт: profile_id и profile_name указывают профиль 7Stamp, event_id идентифицирует событие, а само событие карты находится в data (для URL из Make или Zapier ключ — card_event). Каждая доставка подписывается в одном заголовке — X-Webhook-Signature: t=…,s=…. Вычислите HMAC-SHA256 с вашим секретом вебхука от t вместе с необработанным телом запроса, закодируйте результат в hex и сравните его с 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 вместе с необработанным телом запроса, закодируйте результат в hex и сравните его с s. Берите t ровно в том виде, в каком он отправлен, а тело — как полученные необработанные байты, до любого разбора JSON. Отбрасывайте доставку, X-Webhook-Event-Id которой вы уже обработали: повторная попытка подписывается заново с новым t.
Связанные страницы
Следующий шаг
Готовы отправить первую открытку?
Создайте получателя, вставьте его HTTPS URL в профиль, запустите одноразовое сканирование и подтвердите соответствие External ID перед включением последующей автоматизации.