Інтеграція розробників
Передайте кожну подію лояльності з 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 {
"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"
}Створити кінцеву точку HTTPS у вашій серверній частині, CRM рівень інтеграції, Make вебхук або Zapier Catch Hook. Make переконайтеся, що ви контролюєте місце призначення, перш ніж копіювати його URL.
У 7stamp Admin відкрийте Stamp Cards → API & Integrations → Webhooks.
Додайте кінцеву точку URL та виберіть лише ті типи подій, які насправді потрібні робочому процесу отримання.
Збережіть налаштування профілю, а потім запустіть одноразове тестове сканування або дію з карткою, щоб створити подію.
Огляньте отриманий корисний вантаж. Зіставте External ID та External Source з очікуваним записом і підтвердьте, що одержувач повертає успішну відповідь.
Увімкніть CRM, ваучер або побічні ефекти від обміну повідомленнями лише після того, як у вас буде забезпечено безпечне відтворення та моніторинг збоїв.
У Make використовуйте Webhooks → Custom webhook, щоб створити приймальний URL та вставити його в профіль 7stamp. У Zapier використовуйте Webhooks by Zapier → Catch Hook з тією ж метою. Профіль 7stamp є власником підписки, оскільки поточний API не розкриває автоматичні кінцеві точки реєстрації вебхуків.
Використовуйте розділ Webhooks загальнодоступного посилання OpenAPI як джерело для поточної схеми корисного навантаження та значення поля. Вимагати HTTPS, тримати приймача URL поза публічними журналами та зробити обробку ідемпотентною. Підтвердьте процедуру запиту автентифікації /signature для свого профілю 7stamp під час реєстрації, перш ніж застосувати певне ім’я заголовка або повторити політику у виробництві.
Так. Виберіть типи подій у налаштуваннях вебхуку профілю 7stamp, щоб одержувач отримував лише ті події, які важливі для його робочого процесу.
Створіть приймаючий вебхук у Make або Catch Hook у Zapier, скопіюйте згенерований URL, потім вставте його в налаштування вебхуку профілю 7stamp та надішліть тестову подію.
Використовуйте External ID та, якщо є, External Source. Це ідентифікатори, надані вашою інтеграцією під час створення чи сканування картки.
Ні. Використовуйте поточний контракт на поставку OpenAPI/profile і підтвердьте процедуру автентифікації для свого профілю під час реєстрації, перш ніж жорстко кодувати заголовок або повторити припущення.
Пов’язані сторінки
Наступний крок
Створіть приймач, вставте його HTTPS URL у профіль, запустіть одноразове сканування та перевірте відповідність External ID, перш ніж увімкнути автоматизацію нижчого потоку.