Создайте приглашение от контакта CRM
Запустите новый или квалифицированный контакт, сопоставьте его CRM ID с External ID, создайте приглашение на карточке и передайте возвращенную установку URL по электронной почте или SMS шаг.
Руководство по автоматизации без кода
Подключите 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.
Начните с линейного, тестируемого Zap
Пусть первый Zap будет небольшим. Надежный поток от контакта к карте или от оплаченного заказа к маркам — лучшая отправная точка, чем широкая двусторонняя синхронизация CRM.
Добавьте марки после оформления заказа
Активируйте оплаченный заказ или закрытую квитанцию, сопоставьте личность клиента и закажите 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 действием 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
Отправляет содержимое карты кошелька и /or по электронной почте владельцу карты.
- Ввод карты
- 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 Создайте Zap и выберите событие CRM, которое означает, что контакт имеет право на программу лояльности. Проверьте триггер и убедитесь, что у вас есть неизменяемый контакт ID.
- 2 Добавьте API by Zapier → API Request. Создайте или выберите соединение клавиши 7stamp API, выберите POST и установите для URL значение https://api.7loc.com/cards-api/cards/invite.
- 3 Установите тело на JSON. Сопоставьте CRM ID с external_id, установите фиксированный external_source, например kommo, и добавляйте template_id только в том случае, если активно более одного шаблона 7stamp.
- 4 Проверьте действие. Убедитесь, что ответ содержит install_url и delivery_insert_code для одного и того же external_id.
- 5 Добавьте свое CRM обновление, электронное письмо или действие SMS. Карта install_url из ответа API; не программируйте жестко и не копируйте тест URL.
Проверьте: Создать Card Invite всегда возвращает новое приглашение. Сначала добавьте запрос Find Cards или фильтр Zapier, если ваша политика предусматривает одно приглашение на контакт.
2. Оплаченный заказ → наградные марки
Ожидаемый результат: Заказ создает отслеживаемое сканирование 7stamp, и Zap может записать stamps_added или scan_id в исходную систему.
- 1 Используйте оплаченный заказ/Closed Триггер получения и проверьте его. Прежде чем продолжить, убедитесь, что клиент ID и уникальный заказ ID присутствуют.
- 2 Добавьте API by Zapier → API Request с POST https://api.7loc.com/cards-api/cards/scan и выберите то же соединение 7stamp.
- 3 Отправьте JSON с external_id, external_source, external_order_id и либо суммой для шаблонов на основе суммы, либо stamps_count для явной награды за марку.
- 4 Тест с одноразовым заказом. Проверьте успех, scan_id и stamps_added в ответе.
- 5 Добавьте фильтр, который продолжится только после успешного ответа, затем обновите заказ/CRM с подтвержденным результатом.
Проверьте: Если Zap воспроизводится повторно, проверьте исходный порядок перед отправкой следующего сканирования. Сохраняйте стабильность external_order_id, чтобы событие можно было согласовать позже.
3. 7stamp событие → создать CRM заметку или задачу
Ожидаемый результат: Zapier получает проанализированное событие 7stamp, находит клиента к external_id и создает соответствующее последующее действие.
- 1 Создайте новый Zap с Webhooks by Zapier в качестве триггера. Выберите Catch Hook, продолжите и скопируйте уникальный URL, показанный на этапе проверки.
- 2 В 7stamp Admin откройте API & Integrations → Webhooks, добавьте Catch Hook URL, выберите только необходимые типы событий и сохраните.
- 3 Вызывает реальное тестовое сканирование или событие карты. Вернувшись в Zapier, нажмите Test trigger и подтвердите, что event_type, external_id и external_source появятся в качестве образцов полей.
- 4 Добавьте действие CRM «Найти контакт», используя external_id. Добавьте правило «Фильтр» или «Пути» для event_type, например отделите SCAN от REWARD_EARNED.
- 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 или в примечании.
Правила подключения, предотвращающие несоответствие данных
Сохраните ключ 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
Создайте ключ 7stamp API в администраторе: API & Integrations → API Keys → Add API Key. Используйте отдельный тестовый ключ/profile, если он доступен.
В Zapier создайте Zap и протестируйте исходный триггер. Используйте реальный образец, чтобы контакт ID, клиент ID, заказ ID и сумма были доступны для сопоставления.
Добавьте API by Zapier → API Request. Создайте соединение 7stamp для статического заголовка Bearer Authorization вместо помещения секрета в поле действия Webhooks by Zapier.
Сначала позвоните на номер GET https://api.7loc.com/cards-api/templates. Это подтверждает, что ключ работает, и показывает, какие активные идентификаторы шаблонов доступны без изменения данных клиента.
Выберите POST /cards/invite или POST /cards/scan, установите JSON в качестве типа тела и сопоставьте стабильные External ID плюс соответствующие поля шаблона /order из триггера.
Запустите действие с одноразовым контактом, проверьте его точные поля ответа, затем сопоставьте эти поля со следующим шагом 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 и конечные точки.
Следующий шаг
Создайте первый Zap с помощью тестового контакта
Создайте ключ API, проверьте GET от /templates до API по Zapier, затем создайте одно действие «контакт-карта» или «заказ-марка». Добавьте Catch Hook, как только исходящий поток получит подтвержденный результат проверки.