Создайте карточку после нового контакта CRM
Используйте контакт CRM ID как External ID, создайте приглашение на карточку 7stamp, а затем отправьте возвращенную установку URL обычным способом. электронная почта, SMS или шаг обмена сообщениями.
Руководство по автоматизации без кода
Подключение 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, который будет использоваться в будущем.
Выберите первый сценарий, соответствующий вашему рабочему процессу
Начните с одного события и одного результата. Как только тестовые данные станут правильными, добавьте вокруг них фильтры, маршрутизаторы, обновления CRM и последующие сообщения.
Добавить марки после оплаченного заказа.
Запустить сценарий из оплаченного POS или электронного заказа. Нанесите на карту своего постоянного клиента ID и закажите ID в программе «Сканирование карты», затем укажите сумму или явное количество марок.
Отправьте сообщение о вознаграждении
Когда событие карты сообщает о вознаграждении или ваучере, разветвите сценарий: обновите 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 Invites
Создает до 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-уведомления с карты-кошелька и /or электронной почты в соответствии с настроенным каналом и правилами согласия.
- Отправка карты
- 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 Создайте сценарий и добавьте новый триггер контакта CRM. Для Kommo выберите триггер создания контакта и запустите его один раз, чтобы загрузить образец контакта.
- 2 Добавьте HTTP → Make a request. Установите для метода POST и URL значение https://api.7loc.com/cards-api/cards/invite.
- 3 Добавьте Authorization: Bearer YOUR_7STAMP_API_KEY и Content-Type: application/json. В теле JSON сопоставьте контакт CRM ID с external_id и установите для external_source фиксированную метку, например, kommo.
- 4 Запустите модуль HTTP один раз. Убедитесь, что на выходе есть install_url, delivery_insert_code, external_id и template_id.
- 5 Добавьте модуль обновления своей электронной почты/SMS/CRM после HTTP и карту install_url из вывода HTTP. Сохраните URL в контакте CRM, если команде придется отправить его повторно позже.
Проверьте: POST /cards/invite всегда создает новое приглашение. Сначала используйте Find Cards, если ваше бизнес-правило заключается в том, чтобы избегать повторных приглашений для существующего контакта.
2. Оплаченный заказ → добавьте штампы лояльности
Ожидаемый результат: Успешный ответ сканирования включает в себя успешное сканирование, scan_id, stamps_added и состояние карты после сканирования для вашего следующего шага.
- 1 Начните с триггера «Оплаченный заказ» POS/ecommerce. Make уверен, что в его выборке есть постоянный клиент ID и заказ /receipt ID.
- 2 Добавьте HTTP → Make a request с POST https://api.7loc.com/cards-api/cards/scan и тем же заголовком Bearer.
- 3 Карта external_id от клиента, external_source из названия системы и external_order_id из заказа ID. Добавьте сумму для карт с указанием суммы или stamps_count для явного количества марок.
- 4 Run once с тестовым заказом. Проверьте возвращенный флаг успеха и stamps_added перед включением расписания сценария.
- 5 При желании добавьте фильтр после шага HTTP: продолжайте только в случае истинного успеха, затем напишите scan_id или stamps_added обратно в запись заказа/CRM.
Проверьте: Используйте тот же external_order_id при повторных попытках, чтобы порядок можно было отслеживать в последующих событиях веб-перехватчика; не вручайте марки дважды после неясной неудачной попытки.
3. 7stamp событие → обновить CRM
Ожидаемый результат: Make немедленно получает событие 7stamp и может найти соответствующую запись CRM через external_id и external_source.
- 1 Создайте отдельный сценарий Make. Добавьте Webhooks → Custom webhook, выберите «Добавить», назовите его 7stamp-card-events и скопируйте сгенерированный URL.
- 2 В 7stamp Admin откройте API & Integrations → Webhooks. Добавьте это URL и выберите небольшой набор событий, например SCAN и REWARD_EARNED.
- 3 Создайте одноразовое тестовое сканирование или событие карты в 7stamp. Вернитесь к Make и используйте Run once, чтобы Make определил структуру данных события.
- 4 Добавьте шаг поиска CRM, используя external_id. Добавьте фильтр или маршрутизатор на event_type, чтобы SCAN, REWARD_EARNED и VOUCHER_ISSUED могли выполнять разные действия.
- 5 Добавьте действие CRM update/note. Сопоставьте scanned_at, stamps_after, external_order_id и issued_vouchers только в том случае, если эти поля присутствуют для выбранного типа события.
Проверьте: Держите вебхук URL в тайне. Протестируйте реальное событие, прежде чем включать необратимые сообщения, ваучеры или изменения CRM.
Получите ключ 7stamp API перед открытием Make
Это точные экраны 7stamp Admin. Создайте ключ один раз, скопируйте его в безопасное соединение 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
В 7stamp Admin создайте ключ в API & Integrations → API Keys → Add API Key. Используйте отдельный тестовый профиль/key, если это позволяет настройка вашей учетной записи.
В Make создайте сценарий и добавьте исходный триггер. Запустите его один раз перед сопоставлением, чтобы увидеть реальный образец контакта или оплаченного заказа.
Нажмите следующий плюс, найдите HTTP и выберите Make запрос. Установите полный метод URL и заголовки из карточки операции на этой странице.
Используйте GET https://api.7loc.com/cards-api/templates в качестве первого запроса. Успешный ответ доказывает, что ключ работает без изменения каких-либо данных о клиентах.
Для маршрутов POST выберите application/json и вставьте форму тела из этого руководства. Нанесите на карту конюшню External ID; добавьте template_id только в том случае, если в профиле есть несколько активных шаблонов.
Запустите одноразовый контакт, проверьте вывод HTTP и только затем сопоставьте его точные поля ответа со следующим CRM, модулем электронной почты или обмена сообщениями.
Когда следует использовать Make HTTP?
Используйте HTTP вместо 7stamp сейчас: это задокументированный, готовый к использованию маршрут, а не сокращенный запасной вариант. Выбирайте его всякий раз, когда вам нужна операция 7stamp, новый маршрут API или пользовательское соединение POS/ERP. Ссылка OpenAPI является источником истины для метода, полного пути, тела и схемы ответа; ключ на предъявителя и база URL остаются прежними.
Получайте события 7stamp в Make
Для сценария, управляемого событиями, добавьте Webhooks → Custom webhook и создайте веб-перехватчик. Скопируйте его URL, откройте API & Integrations → Webhooks в профиле 7stamp, вставьте URL, выберите типы событий, сохраните и отправьте настоящее тестовое событие. Эта подписка принадлежит профилю 7stamp; текущий 7392⟧ не предоставляет конечные точки автоматической подписки на веб-перехватчик 7395⟧.
Публичный соединитель Make не требуется.
В инструкциях на этой странице используются модули Make, доступные для каждой учетной записи Make. Если вам нужен будущий собственный модуль 7stamp вместо HTTP, отправьте нам необходимый вам рабочий процесс; до тех пор HTTP и Custom webhook охватывают каждую задокументированную операцию 7stamp.
Часто задаваемые вопросы
Не могу найти 7stamp в Make. Могу ли я еще это автоматизировать?
Да. На сегодняшний день в Make нет общедоступного приложения 7stamp. Добавьте запрос HTTP > Make, используйте полную конечную точку 7stamp URL и отправьте Authorization: Bearer, а затем свой ключ 7stamp API. HTTP может вызывать каждую задокументированную конечную точку.
Где я могу получить токен для соединения Make?
В 7stamp Admin откройте API Интеграции, затем API Keys, затем Add API Key. Ключ привязан к рабочему месту 7112⟧, на котором он был создан, поэтому по возможности используйте тестовый профиль для тестовых сценариев.
Какой идентификатор мне следует сопоставить как External ID?
Используйте стабильный идентификатор из исходной системы, предпочтительно контакт CRM ID или клиент UUID. Не используйте отображаемое имя. Номер телефона или адрес электронной почты могут работать, но могут меняться, и с ними следует обращаться последовательно.
Как перенести события 7stamp в Make?
Создайте веб-перехватчик > Custom webhook в Make, затем вставьте сгенерированный URL в настройки веб-перехватчика профиля 7stamp. После доставки используйте фильтр Make или маршрутизатор для обработки входящего сообщения event_type.
Следующий шаг
Готовы автоматизировать первое действие программы лояльности?
Создайте ключ API, протестируйте List Templates и создайте один сценарий приглашения или сканирования с одноразовым контактом. Добавляйте маршрутизаторы и обмен сообщениями только после того, как этот простой поток станет надежным.