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

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

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

Використовуйте Zapier, коли ваш робочий процес є чіткою послідовністю: контакт або замовлення з’являється, 7stamp виконує дію, потім оновлюється інший бізнес-інструмент. Захищений маршрут сьогодні API на Zapier для вихідних 7stamp API дзвінків і Webhooks by Zapier → Catch Hook для вхідних подій 7stamp.

На ринку Zapier немає загальнодоступної програми 7stamp. Використовуйте API by Zapier → API Request, де доступно: він зберігає статичний ключ API у підключенні програми замість того, щоб показувати його на кроці Zap. Використовуйте Webhooks by Zapier лише для вхідних подій Catch Hook; не вставляйте ключ 7stamp Bearer у видиме поле дії Webhooks.

Open Zapier Open API reference

Почніть із лінійного Zap, який можна перевірити

Тримайте перший Зап маленьким. Надійний потік від контакту до картки або платного замовлення до марки є кращою відправною точкою, ніж широка двостороння синхронізація CRM.

Створіть запрошення від контакту CRM

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

Додати штампи після оформлення замовлення

Активуйте з оплаченого замовлення або закритої квитанції, зіставте особу клієнта та замовлення ID, а потім використовуйте Scan Card із сумою замовлення або явною кількістю марок.

Видайте одноразовий ваучер на відновлення

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

Запишіть події картки назад у свою CRM

Використовуйте Webhooks by Zapier > Catch Hook, щоб отримати події картки 7stamp. Зіставте повернений External ID із записом CRM і додайте відповідну примітку, тег або завдання.

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

Додайте API by Zapier → API Request після ваш тригер. Створіть одне підключення за допомогою ключа 7stamp API, а потім виберіть точний метод і повний URL нижче. Кожна операція повертає поля, які можна відобразити на наступному кроці Zap.

API до дії Zapier POST /cards/invite

Створити Card Invite

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

Необхідно
external_id від тригера CRM/contact.
Наступний крок
Зіставте install_url в електронну пошту, SMS або поле CRM.
API by Zapier дія POST /cards/invite/bulk

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

Створює до 100 посилань для запрошення з контрольованої партії JSON.

Необхідний масив
елементів із 1–100 об’єктами запрошень.
Перевірте
Прочитайте success_count, error_count та кожен результат перед доставкою.
API за дію Zapier POST /cards/scan

Scan Card

Додає марки до User Card ID або External ID із сумою, кількістю марок, порядком ID та додаткові дані квитанції.

Ідентифікація
external_id плюс необов’язковий external_source; user_card_id виграє, якщо присутні обидва.
Правило штемпеля
stamps_count має пріоритет над сумою.
API від дії Zapier POST /vouchers/issue

Issue Voucher

Видає ваучер безпосередньо власнику картки.

Необхідний ваучер
.short_description та цільовий номер external_id або відомий user_card_id.
Результат
Відобразити unique_code, статус або expires_at на нотатку чи повідомлення CRM.
API від дії Zapier POST /messages/send

Send Message

Надсилає вміст картки гаманця push і /or електронною поштою власнику картки.

Card Push
card_push_text обмежено 20 символами.
Електронна пошта
тема плюс тіло; результат повідомляє, чи була доставка в черзі.
API від Zapier дія GET /cards

Find Cards

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

Необхідно
external_id як параметр запиту.
Використовувати спочатку
Використовувати перед створенням запрошення, якщо ваше правило уникає дублікатів запрошень.
API за допомогою дії Zapier GET /cards/{user_card_id}

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

Зчитує стан картки за допомогою її внутрішньої 7stamp ID.

Обов’язково
Замініть {user_card_id} на ID, що повертається 7stamp.
Корисні результати
stamps_count, стан гаманця та active_vouchers_count.
API від дії Zapier GET /templates

List Templates

Перелічує шаблони, доступні для підключеного профілю, і перевіряє підключення API.

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

Get Template Design

Отримує налаштування дизайну шаблону для відомого шаблону ID. Тригер

Zapier Webhooks by Zapier → Catch Hook

отримання карток подій

Catch Hook дає Zapier унікальний HTTPS URL. Вставте його в налаштування вебхука 7stamp Admin та перевірте за допомогою події реальної картки.

У Zapier
Використовуйте Catch Hook для аналізованих даних подій; використовуйте Catch Raw Hook лише тоді, коли вам також потрібні необроблені заголовки запиту/body.
Збіг
Знайдіть контакт CRM за допомогою external_id та необов’язково external_source із події.

Три робочих процеси Zapier, які можна створити крок за кроком

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

1. Кваліфікований контакт CRM → видати картку

Очікуваний результат: Наступний крок Zap отримує install_url і може надіслати його клієнту або записати назад у запис CRM.

  1. 1 Створіть Zap і виберіть подію CRM, яка означає, що контакт має право на лояльність. Перевірте тригер і підтвердьте, що у вас є незмінний контакт ID.
  2. 2 Додати API by Zapier → API Request. Створіть або виберіть підключення 7stamp API, виберіть POST та встановіть для URL значення https://api.7loc.com/cards-api/cards/invite.
  3. 3 Встановіть для тіла значення JSON. Зіставте CRM ID на external_id, встановіть фіксований external_source, наприклад kommo, і додайте template_id лише тоді, коли активні декілька шаблонів 7stamp.
  4. 4 Перевірте дію. Переконайтеся, що відповідь містить install_url та delivery_insert_code для того самого external_id.
  5. 5 Додайте своє оновлення CRM, електронну пошту або дію SMS. Карта install_url з відповіді API; не кодуйте і не копіюйте тест URL.

Позначте: Create Card Invite завжди повертає нове запрошення. Спочатку додайте запит Find Cards або фільтр Zapier, якщо ваша політика передбачає одне запрошення на контакт.

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

Очікуваний результат: Замовлення створює відстежуваний скан 7stamp, і Zap може записати stamps_added або scan_id у вихідну систему.

  1. 1 Використовуйте платне замовлення/Closed тригер отримання та перевірте його. Перш ніж продовжити, переконайтеся, що клієнт ID та унікальне замовлення ID присутні.
  2. 2 Додайте API by Zapier → API Request з POST https://api.7loc.com/cards-api/cards/scan та виберіть те саме підключення 7stamp.
  3. 3 Надішліть JSON з external_id, external_source, external_order_id та або сумою для шаблонів на основі суми, або stamps_count для явного нагородження печаткою.
  4. 4 Тест з одноразовим замовленням. Перевірте успіх, scan_id та stamps_added у відповіді.
  5. 5 Додайте фільтр, який продовжує роботу лише після успішної відповіді, а потім оновіть замовлення/CRM підтвердженим результатом.

Позначте: Якщо Zap відтворюється повторно, перевірте вихідний порядок перед тим, як надсилати інше сканування. Тримайте external_order_id стабільним, щоб подію можна було узгодити пізніше.

3. Подія 7stamp → створити нотатку або завдання CRM

Очікуваний результат: Zapier отримує проаналізовану подію 7stamp, знаходить клієнта до external_id та створює відповідну подальшу дію.

  1. 1 Створіть новий Zap із Webhooks by Zapier як тригер. Виберіть Catch Hook, продовжте та скопіюйте унікальний URL, показаний на кроці тестування.
  2. 2 У 7stamp Admin відкрийте API & Integrations → Webhooks, додайте Catch Hook URL, виберіть лише потрібні типи подій і збережіть.
  3. 3 Викликати справжнє тестове сканування або подію картки. Повернувшись у Zapier, натисніть Test trigger і підтвердьте, що event_type, external_id та external_source надходять як зразки полів.
  4. 4 Додайте дію CRM Знайти контакт за допомогою external_id. Додайте правило «Фільтр» або «Шляхи» для event_type, наприклад, відокремте SCAN від REWARD_EARNED.
  5. 5 Створіть примітку CRM/task та зіставте лише ті поля, які існують для цієї події, наприклад scanned_at, stamps_after, external_order_id або issued_vouchers.

Позначте: Catch Hook URL є секретом. Якщо Zap передано іншому власнику, оновіть URL у 7stamp Admin, перш ніж покладатися на нього.

Створіть ключ 7stamp API, перш ніж створювати Zap.

Це бічні кроки 7stamp. Зробіть це один раз, а потім використовуйте ключ лише всередині з’єднання API на Zapier, а не в полі дії Webhooks by Zapier чи в примітці. Екран

7stamp Admin API та інтеграції з дією Add API Key
Відкрийте API та інтеграції, виберіть API Keys, а потім створіть окремий ключ для Zap, якщо це дозволяють налаштування вашого облікового запису.
Щойно згенерований ключ 7stamp API, готовий до копіювання
Скопіюйте ключ у захищене з’єднання API через Zapier, а не в крок простого тексту Webhooks або спільний документ.

Правила з’єднання, які запобігають невідповідності даних

Зберігайте ключ API у з’єднанні API на Zapier

У 7stamp Admin виберіть API & Integrations → API Keys → Add API Key. У API на Zapier створіть з’єднання ключа API зі статичним заголовком Authorization, що містить Bearer, за яким іде цей ключ. API від Zapier зберігає облікові дані у з’єднанні замість видимого кроку Zap; обмежте доступ до підключення та поверніть ключ, якщо він відкритий.

Карта External ID та External Source послідовно

External ID – це ваш власний стабільний ідентифікатор клієнта; External Source мітки, звідки вони надійшли, наприклад hubspot, bitrix24, shopify або poster. Використовуйте ту саму пару для потоків створення, пошуку, сканування, ваучера та веб-хуку.

Дізнайтеся, який ідентифікатор картки виграє

Дії націлювання картки приймають User Card ID або External ID. Якщо присутні обидва, User Card ID має пріоритет. Використовуйте внутрішній ID лише після того, як його повернув довірений крок 7stamp; в іншому випадку віддайте перевагу вихідній системі External ID.

Точний запит API від Zapier: нагородіть одну марку

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

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "stamps_count": 1,
  "external_order_id": "order_2048"
}

Створіть свій перший Zap

01

Створіть ключ 7stamp API в Admin: API & Integrations → API Keys → Add API Key. Використовуйте окремий тестовий ключ /profile, якщо він є.

02

У Zapier створіть Zap і перевірте тригер джерела. Використовуйте реальний зразок, щоб контакт ID, клієнт ID, замовлення ID та сума були доступними для зіставлення.

03

Додати API by Zapier → API Request. Створіть з’єднання 7stamp для статичного заголовка Bearer Authorization, а не вводьте секрет у поле дії Webhooks by Zapier.

04

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

05

Виберіть POST /cards/invite або POST /cards/scan, встановіть JSON як тип тіла та зіставте стабільний External ID та відповідні поля шаблону /order із тригера.

06

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

Використовуйте універсальний запит лише для задокументованих маршрутів

Використовуйте API від Zapier для запиту 7stamp з ключем Bearer API: він зберігає статичні ключі заголовків у підключенні програми. Використовуйте Webhooks by Zapier для доставки подій Catch Hook, а не як бажане місце для секрету 7stamp. Зберігайте базу URL на https://api.7loc.com/cards-api,, використовуйте загальнодоступне посилання OpenAPI для точних схем і ніколи не надсилайте облікові дані чи дані клієнтів неперевіреному URL.

Отримувати події 7stamp через Catch Hook

Створити Webhooks by Zapier → Catch Hook, скопіювати унікальний URL, показаний у налаштуваннях тестування, вставити його в налаштування вебхука профілю 7stamp, вибрати типи подій і потім надішліть справжнє тестове сканування або подію картки. Використовуйте корисне навантаження події External ID та External Source, щоб знайти правильний контакт CRM. Вибирайте Catch Raw Hook лише тоді, коли вам особливо потрібні нерозібране тіло та заголовки запиту.

Використовуйте безпечний маршрут Zapier зараз

API до Zapier та Catch Hook достатньо для кожної загальнодоступної операції 7stamp API та події картки. Якщо вам потрібна майбутня рідна програма 7stamp Zapier, надішліть нам точну дію/trigger, яку ваша команда використовує найчастіше.

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

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

Де я можу знайти програму 7stamp у Zapier?

Сьогодні немає загальнодоступної програми 7stamp Marketplace. Використовуйте API by Zapier → API Request для викликів 7stamp API та Webhooks by Zapier → Catch Hook для вхідних подій 7stamp.

Де створити маркер Zapier?

Створіть ключ 7stamp API в Адміністраторі під API & Integrations → API Keys → Add API Key. Зберігайте його як статичний заголовок Bearer Authorization у підключенні API до Zapier, а не у видимому полі дії Webhooks by Zapier.

Як Zapier отримати марку або ваучер на подію?

Створіть Catch Hook у Webhooks by Zapier, вставте згенерований URL у налаштування вебхуку профілю 7stamp, виберіть події та надішліть тестову подію перед увімкненням оновлень CRM.

Мені вибрати Zapier чи Make?

Виберіть Zapier для переважно лінійного робочого процесу тригерних дій. Виберіть Make, коли вам потрібні маршрутизатори, складні перетворення або довгі сценарії з кількома розгалуженнями. Обидва використовують той самий ключ 7stamp API і кінцеві точки.

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

Відкрити Zapier API автором Zapier довідка Zapier Catch Hook довідка 7stamp API довідка Налаштування Webhook Make посібник

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

Створіть перший Zap із тестовим контактом

Створіть ключ API, перевірте GET /templates до API до Zapier, потім створіть одну дію контакту до картки або замовлення до марки. Додайте Catch Hook, коли вихідний потік матиме перевірений результат тестування.

Відкрийте 7stamp Admin Прочитайте довідкові API