Інтеграція розробників
Передайте кожну подію лояльності з 7Stamp у ваші власні системи в режимі реального часу. Немає опитувань і запланованих дзвінків API. Події надходять як запити HTTPS POST протягом кількох секунд після того, як вони відбуваються.
Використовуйте веб-хуки, щоб ваш CRM, ERP або спеціальний бекенд синхронізувався з тим, що відбувається на стороні лояльності: хто приєднався, хто отримав штамп, хто використав ваучер, хто ініціював подарунок на день народження, а хто став неактивним. Потім ваші системи вирішують, що робити з цими даними.
Веб-хуки — це вихідна сторона стеку інтеграції. Вони відображають діяльність клієнтів і винагороду в системах продажів, обслуговування, аналітики та обміну повідомленнями, яким ви вже довіряєте.
Кожна марка, ваучер, день народження та тригер неактивності потрапляє в запис клієнта у вашому CRM. Ви побачите повну хронологію програми лояльності поруч із розпродажами, дзвінками та квитками без входу на 7Stamp.
Коли клієнт окупає ваучер, надішліть подяку SMS зі свого існуючого шлюзу SMS. Коли клієнт досягає мети, опублікуйте повідомлення про святкування в Slack. Коли хтось стає неактивним, передайте справу менеджеру свого облікового запису.
Потік подій у ваш інструмент BI, склад або конвеєр узгодження. Зіставте використання ваучера з квитанціями POS та розрахуйте лояльність ROI у власних показниках.
Ваша кінцева точка повинна прийняти HTTPS POST, перевірити форму запиту, зберегти або поставити подію в чергу, а потім повернути успішну відповідь 2xx. Не здійснюйте повільний дзвінок CRM або обмін повідомленнями до підтвердження, якщо його можна безпечно поставити в чергу.
Кожна пов’язана подія може містити External ID та необов’язково External Source, які ви використовували під час створення або сканування картки. Використовуйте цю пару, щоб оновити власний запис CRM, POS або замовлення, не вгадуючи ім’я чи електронну адресу.
Зберігайте надійний ключ обробки або відбиток пальця події, перш ніж викликати побічні ефекти. Якщо ваш отримувач знову бачить ту саму доставку, він не повинен додавати дублікат нотатки, ваучера чи повідомлення 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 використовуйте 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 або Catch Hook у Zapier, скопіюйте згенерований URL, потім вставте його в налаштування вебхуку профілю 7Stamp та надішліть тестову подію.
Використовуйте data.external_id і, якщо є, data.external_source: вони повертаються в кожному вебхуку для карток, які ви випустили через API з власним ID. Клієнт, який сам отримав картку, не має External ID, тож зіставляйте його за data.user.email. Адреса Apple «Hide My Email» — це адреса пересилання, а не та, що є у вашій CRM.
Розділіть заголовок X-Webhook-Signature на t і s, обчисліть HMAC-SHA256 секретом вебхука з 7Stamp Admin від t, поєднаного із сирим тілом запиту, закодуйте результат у hex і порівняйте його з s. Беріть t точно в тому вигляді, у якому його надіслано, а тіло — як отримані сирі байти, до будь-якого розбору JSON. Відкидайте доставку, X-Webhook-Event-Id якої ви вже обробили: повторну спробу підписують знову з новим t.
Пов’язані сторінки
Наступний крок
Створіть приймач, вставте його HTTPS URL у профіль, запустіть одноразове сканування та перевірте відповідність External ID, перш ніж увімкнути автоматизацію нижчого потоку.