Посібник з автоматизації без коду

Підключіть 7stamp до Make — крок за кроком

Посібник із впровадження

Використовуйте Make, щоб підключити 7stamp до CRM, POS, онлайн-магазину, електронної таблиці, інструменту обміну повідомленнями або будь-якої системи, яка може надсилати дані в сценарій. На сьогоднішній день готовий до випуску додаток HTTP від Make для викликів 7stamp API та Custom webhook від Make для вхідних подій 7stamp.

У інструменті вибору програм Make ще немає загальнодоступної програми 7stamp. Не чекайте на нього: додайте HTTP → Make a request, використовуйте точний URL, метод, заголовок Bearer та JSON нижче, а потім зіставте поля з вашого вихідного модуля. Це той самий 7stamp Integration API, який використовуватиме майбутній конектор.

Відкрити Make Відкрийте посилання API

Виберіть перший сценарій, який відповідає вашому робочому процесу

Почніть з однієї події та одного результату. Коли тестові дані правильні, додайте фільтри, маршрутизатори, оновлення CRM та подальші повідомлення навколо них.

Створіть картку після нового контакту CRM

Використовуйте контакт CRM ID як External ID, створіть запрошення для картки 7stamp, а потім надішліть повернуту інсталяцію URL через звичайну електронну пошту, SMS, або через повідомлення.

Додайте штампи після оплаченого замовлення

Запустіть сценарій із оплаченого POS або замовлення електронної комерції. Позначте на карті свого постійного клієнта ID та замовте ID у Scan a Card, а потім вкажіть суму або явний підрахунок марки.

Надішліть сповіщення про винагороду

Коли подія картки повідомляє про винагороду чи ваучер, розгалужте сценарій: оновіть CRM, повідомте команду та надішліть push-повідомлення з карткою гаманця або електронний лист лише за потреби.

Керуйте системою без рідної програми Make

Використовуйте модуль HTTP Make для безпосереднього виклику 7stamp. Це універсальний вибір для спеціальної системи бронювання POS, ERP або будь-якої першої служби API.

7stamp операції для виклику з Make HTTP

Для кожної картки нижче додайте HTTP → Make a request, потім установіть метод і URL, як показано. Використовуйте той самий ключ Bearer для кожного запиту. Необхідне зіставлення вказує вам, що надавати з тригера CRM, POS або електронної комерції.

Тригер Make Webhooks → Custom webhook

Отримайте картку події

Створіть Custom webhook у Make, скопіюйте його URL, а потім вставте цей URL у налаштування вебхука профілю 7stamp. Це запускає сценарій, коли 7stamp надсилає подію, наприклад SCAN, REWARD_EARNED або VOUCHER_ISSUED.

В Make
Webhooks → Custom webhook → Додати; дайте йому чітку назву та скопіюйте згенерований URL.
У 7stamp
Адміністратор → API & Integrations → Webhooks; вставте URL, виберіть типи подій, збережіть і створіть тестову подію.
HTTP POST /cards/invite

Створити дію Card Invite

Створити нову особисту інсталяцію URL та вставити код доставки для одного зовнішнього контакту.

Обов’язково
external_id — позначте свою стайню CRM/contact ID, а не назву.
Потім скористайтеся
Зіставте install_url з відповіді у ваш електронний лист, SMS або CRM крок оновлення.
HTTP дія POST /cards/invite/bulk

Масове створення Card Inviteс

Створює до 100 посилань для запрошення в одному запиті. Використовуйте його для контрольованої міграції чи кампанії, а не для необмеженого експорту контактів.

Необхідні
елементи — JSON масив із 1–100 окремих об’єктів запиту на запрошення.
Позначте
Прочитайте success_count, error_count та кожен результат перед надсиланням будь-яких посилань.
HTTP дія GET /cards

Find Cards

Знаходить записи карток за External ID із додатковим шаблоном і фільтрами джерел.

Обов’язковий
Параметр запиту external_id.
Додатково
external_source та template_id звужують пошук, коли одна система має декілька програм.
Дія HTTP GET /cards/{user_card_id}

Отримайте деталі картки

Зчитує повний стан однієї картки, якщо попередній крок повернув її внутрішній User Card ID.

Обов’язково
Замініть {user_card_id} на внутрішній ID, який повертає довірена відповідь 7stamp.
Уникайте
Не вгадуйте та не зберігайте картку ID з іншого профілю.
HTTP дія POST /cards/scan

Сканувати картку

Додає марки від суми покупки або явного підрахунку. Він приймає User Card ID або External ID і може зберігати зовнішнє посилання на замовлення.

Ідентифікація
Використовуйте external_id та необов’язково external_source; user_card_id виграє, якщо подано обидва.
Придбайте
Використовуйте суму для карток на основі суми або stamps_count для явного числа; stamps_count має пріоритет.
Відстеження
Карта external_order_id із оплаченого замовлення/receipt, щоб події 7stamp могли бути зіставлені назад.
HTTP дія GET /templates

List Templates

Перелічує шаблони карток, доступні для ключа API. Використовуйте його, щоб перевірити з’єднання або динамічно вибрати шаблон.

Перший тест
Це найбезпечніший перший запит: він не має тіла й не змінює дані клієнта.
Створити карту пізніше
Використовуйте ідентифікатор активного шаблону як template_id, лише якщо профіль має більше ніж один активний шаблон.
HTTP дія GET /templates/{template_id}/design

Get Template Design

Повертає параметри візуального дизайну для відомого шаблону, корисно, коли інша система потребує відображення узгодженого вибору картки.

HTTP дія POST /vouchers/issue

Видати ваучер

Видає ваучер власнику картки, ідентифікованому External ID або User Card ID.

Необхідний ваучер
.short_description. Наведіть на картку external_id або відоме user_card_id.
Термін дії
Використовуйте validity_type разом із validity_value або прочитайте посилання OpenAPI, щоб дізнатися про фіксований термін придатності.
HTTP дія POST /messages/send

Надіслати повідомлення

Надсилає вміст власнику картки через push-карту Wallet-card і /or електронну пошту відповідно до налаштованого каналу та правил згоди.

Card Push
card_push_text обмежена 20 символами та потребує встановленого пропуску гаманця.
Електронна пошта
Надіслати тему та текст; базовий HTML підтримується в корпусі.
Make модуль Full 7stamp endpoint URL

HTTP → Make a request

Це модуль Make, який викликає кожен маршрут 7stamp вище. Використовуйте повний URL, виберіть задокументований метод, додайте заголовок Bearer та використовуйте JSON лише тоді, коли для маршруту потрібне тіло.

База URL
https://api.7loc.com/cards-api
Заголовок
Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json для POST запитів.

Три сценарії Make, які ви можете створити точно так, як написано

Наведені нижче назви є справжніми модулями Make. Почніть з першого сценарію, запустіть його з одноразовим контактом і лише потім додайте маршрутизатори, фільтри або планування виробництва.

1. Новий контакт CRM → надішліть посилання на картку 7stamp

Очікуваний результат: Клієнт отримує install_url, повернутий 7stamp; ваш CRM може зберігати цей URL у тому самому записі контактів.

  1. 1 Створіть сценарій і додайте тригер нового контакту CRM/Created. Для Kommo виберіть тригер створення контакту та запустіть його один раз, щоб завантажити зразок контакту.
  2. 2 Додайте HTTP → Make a request. Установіть «Метод» на POST та URL на https://api.7loc.com/cards-api/cards/invite.
  3. 3 Додайте Authorization: Bearer YOUR_7STAMP_API_KEY і Content-Type: application/json. У тілі JSON зіставте контакт CRM ID у external_id та встановіть external_source на фіксовану мітку, наприклад kommo.
  4. 4 Запустіть модуль HTTP один раз. Переконайтеся, що вихідні дані містять install_url, delivery_insert_code, external_id та template_id.
  5. 5 Додайте свій модуль оновлення електронної пошти/SMS/CRM після HTTP та зіставте install_url з результату HTTP. Збережіть URL у контакті CRM, якщо команді доведеться надіслати його пізніше.

Позначте: POST /cards/invite завжди створює нове запрошення. Спочатку використовуйте Find Cards, якщо ваше бізнес-правило полягає в тому, щоб уникнути повторного запрошення для наявного контакту.

2. Оплачене замовлення → додайте штампи лояльності

Очікуваний результат: Відповідь на успішне сканування включає успіх, scan_id, stamps_added та стан картки після сканування для вашого наступного кроку.

  1. 1 Почніть із тригера POS/ecommerce Paid Order. Make впевнений, що його зразок містить стабільного клієнта ID та замовлення /receipt ID.
  2. 2 Додайте HTTP → Make a request із POST https://api.7loc.com/cards-api/cards/scan і тим самим заголовком Bearer.
  3. 3 Карта external_id від клієнта, external_source від назви системи та external_order_id від замовлення ID. Додайте суму для карток на основі суми або stamps_count для явної кількості марок.
  4. 4 Run once з тестовим замовленням. Перевірте повернутий прапор успішного виконання та stamps_added перед увімкненням розкладу сценарію.
  5. 5 Необов’язково додайте фільтр після кроку HTTP: продовжуйте лише тоді, коли успіх є істинним, а потім напишіть scan_id або stamps_added назад до запису замовлення/CRM.

Позначте: Використовуйте той самий external_order_id під час повторних спроб, щоб можна було відстежити порядок у пізніших подіях вебхуку; не присуджуйте марки двічі після незрозумілого невдалого запуску.

3. Подія 7stamp → оновити CRM

Очікуваний результат: Make негайно отримує подію 7stamp і може знайти відповідний запис CRM через external_id та external_source.

  1. 1 Створіть окремий сценарій Make. Додайте Webhooks → Custom webhook, виберіть Додати, назвіть 7stamp-card-events і скопіюйте згенерований URL.
  2. 2 У 7stamp Admin відкрийте API & Integrations → Webhooks. Додайте URL та виберіть невеликий набір подій, наприклад SCAN та REWARD_EARNED.
  3. 3 Створіть одноразове тестове сканування або подію картки в 7stamp. Поверніться до Make та використовуйте Run once, щоб дозволити Make визначити структуру даних події.
  4. 4 Додайте крок пошуку CRM за допомогою external_id. Додайте фільтр або маршрутизатор на event_type, щоб SCAN, REWARD_EARNED і VOUCHER_ISSUED могли виконувати різні дії.
  5. 5 Додайте дію CRM update/note. Карта scanned_at, stamps_after, external_order_id та issued_vouchers лише тоді, коли ці поля присутні для вибраного типу події.

Позначте: Зберігайте вебхук URL приватним. Перевірте реальну подію, перш ніж увімкнути незворотні повідомлення, ваучери або зміни CRM.

Отримайте ключ 7stamp API, перш ніж відкривати Make

Це точні екрани 7stamp Admin. Створіть ключ один раз, скопіюйте його в безпечне з’єднання HTTP/keychain Make, а потім негайно видаліть його з буфера обміну. Екран

7stamp Admin API та інтеграції зі списком API Keys та елементом керування Add API Key
У 7stamp Admin відкрийте API та інтеграції, а потім API Keys та виберіть Add API Key.
Нове діалогове вікно ключа 7stamp API з видимим контролем копіювання
Скопіюйте ключ лише в безпечне Make HTTP з’єднання/keychain. Розглядайте його як пароль і змінюйте його, якщо він розкритий.

Підготуйте підключення перед створенням

Створіть один ключ API для кожного середовища

У 7stamp Admin перейдіть до API & Integrations → API Keys → Add API Key. Зберігайте значення в Make HTTP API-ключовому з'єднанні/keychain, якщо ця опція доступна. Ніколи не зіставляйте ключ із текстового поля, не розміщуйте його в примітці або не використовуйте в робочому процесі браузера. Ключ належить до одного 7stamp робочого місця/profile.

Використовуйте стабільний External ID

Зіставте незмінний ID з вашого CRM, POS або комерції платформа, наприклад CRM контакт ID або клієнт UUID. Додайте External Source, наприклад hubspot, shopify або poster, якщо той самий ідентифікатор може відображатися в кількох системах.

Вирішіть, який шаблон застосовувати

Якщо підключений профіль 7stamp має один активний шаблон картки, шаблон можна залишити порожнім. Завдяки численним шаблонам навмисно намалюйте або виберіть template_id, щоб кожне запрошення та сканування потрапило до запланованої програми лояльності.

Точне налаштування Make HTTP: створіть одну картку запрошення

Скопіюйте це у свій крок автоматизації http 
Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
  Authorization: Bearer YOUR_7STAMP_API_KEY
  Content-Type: application/json
Body type: Raw / JSON

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "template_id": 42
}

Створіть і протестуйте свій перший сценарій Make

01

У 7stamp Admin створіть ключ у API & Integrations → API Keys → Add API Key. Використовуйте окремий тестовий профіль/key, якщо це дозволяють налаштування вашого облікового запису.

02

У Make створіть сценарій і додайте тригер джерела. Запустіть його один раз перед відображенням, щоб ви могли побачити реальний зразок контакту чи оплаченого замовлення.

03

Натисніть наступний плюс, знайдіть HTTP та виберіть Make запит. Установіть метод, повний URL, і заголовки з картки операцій на цій сторінці.

04

Використовуйте GET https://api.7loc.com/cards-api/templates як перший запит. Його успішна відповідь доводить, що ключ працює без зміни даних клієнта.

05

Для маршрутів POST виберіть application/json та вставте форму тіла з цього посібника. Карта стайні External ID; додавати template_id, лише якщо профіль має кілька активних шаблонів.

06

Запустіть із одноразовим контактом, перевірте вихідні дані HTTP і лише тоді зіставте його точні поля відповіді з наступним модулем CRM, електронною поштою чи повідомленнями.

Коли слід використовувати Make HTTP?

Використовуйте HTTP для 7stamp зараз: це задокументований, готовий до виробництва маршрут, а не скорочений запасний варіант. Вибирайте його, коли вам потрібна операція 7stamp, новий маршрут API або спеціальне з’єднання POS/ERP. Посилання OpenAPI є джерелом істини для методу, повного шляху, тіла та схеми відповіді; ключ носія та база URL залишаються незмінними.

Отримувати 7stamp події в Make

Для сценарію, керованого подіями, додайте Webhooks → Custom webhook і створіть вебхук. Скопіюйте його URL, відкрийте API & Integrations → Webhooks у профілі 7stamp, вставте URL, виберіть типи подій, збережіть і надішліть справжню тестову подію. Профіль 7stamp володіє цією підпискою; поточний API не розкриває кінцеві точки автоматичної підписки на вебхук/unsubscribe.

Загальнодоступний конектор Make не потрібен

Інструкції на цій сторінці використовують модулі Make, які доступні для кожного облікового запису Make. Якщо вам потрібен майбутній нативний модуль 7stamp, а не HTTP, надішліть нам необхідний робочий процес; до того часу HTTP та Custom webhooks охоплюють усі задокументовані операції 7stamp.

Запитайте про нативний роз’єм

Часті запитання

Я не можу знайти 7stamp у Make. Чи можу я все-таки автоматизувати це?

Так. Сьогодні в Make немає загальнодоступної програми 7stamp. Додайте запит HTTP > Make, використайте повну кінцеву точку 7stamp URL та надішліть Authorization: Bearer, а потім свій ключ 7stamp API. HTTP може викликати кожну задокументовану кінцеву точку.

Де взяти токен для підключення Make?

У 7stamp Admin відкрийте API Integrations, потім API Keys, потім Add API Key. Ключ діє на робочому місці/profile, яке його створило, тому використовуйте тестовий профіль для тестових сценаріїв, коли це можливо.

Який ідентифікатор мені відобразити як External ID?

Використовуйте стабільний ідентифікатор із вихідної системи, бажано контакт CRM ID або клієнт UUID. Не використовуйте відображуване ім'я. Номер телефону чи адреса електронної пошти можуть працювати, але можуть змінюватися, і з ними слід працювати послідовно.

Як мені перенести події 7stamp у Make?

Створіть Webhooks > Custom webhook у Make, а потім вставте згенерований URL у налаштування webhook профілю 7stamp. Використовуйте фільтр Make або маршрутизатор після доставки, щоб обробити вхідний event_type.

Пов’язані сторінки

Відкрити Make Make HTTP довідка Make Custom webhook довідка 7stamp API посилання Налаштування вебхука Zapier посібник

Наступний крок

Готові автоматизувати першу дію лояльності?

Створіть ключ API, протестуйте List Templates та створіть один сценарій запрошення або сканування з одноразовим контактом. Додайте маршрутизатори та обмін повідомленнями лише після того, як цей простий потік стане надійним.

Відкрити 7stamp Admin Прочитайте посилання API