Създайте карта след нов контакт CRM
Използвайте контакта CRM ID като External ID, създайте покана за карта 7stamp, след което изпратете върнатата инсталация URL чрез обичайния си имейл, SMS или стъпка за съобщения.
Ръководство за автоматизация без код
Свържете 7stamp към Make — стъпка по стъпка
Ръководство за внедряванеИзползвайте Make, за да свържете 7stamp с CRM, POS, онлайн магазин, електронна таблица, инструмент за съобщения или всяка система, която може да изпраща данни в сценарий. Готовият за производство маршрут днес е приложението HTTP на Make за обаждания 7stamp API и Custom webhook на Make за входящи събития 7stamp.
Все още няма публично приложение 7stamp в инструмента за избор на приложения на Make. Не чакайте едно: добавете HTTP → Make a request, използвайте точния URL, метод, Bearer заглавка и JSON по-долу, след което картографирайте полетата от вашия изходен модул. Това е същото 7stamp Integration API, което би използвал бъдещият конектор.
Изберете първия сценарий, който отговаря на вашия работен процес
Започнете с едно събитие и един резултат. След като тестовите данни са правилни, добавете филтри, рутери, CRM актуализации и последващи съобщения около тях.
Добавяне на печати след платена поръчка
Задействайте сценария от платена POS или поръчка от електронната търговия. Картирайте неговия стабилен клиент ID и поръчайте ID в Scan a Card, след което използвайте сума или изричен брой на печатите.
Изпратете последващо съобщение за награда
Когато събитие с карта докладва награда или ваучер, разклонете сценария: актуализирайте CRM, уведомете екипа и изпратете натискане на карта за портфейл или имейл само когато е необходимо.
Управлявайте система без собствено приложение 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. Използвайте го, за да тествате връзката или да изберете динамично шаблон.
- Първи тест
- Това е най-безопасната първа заявка: тя няма тяло и не променя данните на клиента.
- Карта по-късно
- Използвайте ID на активен шаблон като 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 Изпратете съобщение
Изпраща съдържание до собственика на картата чрез натискане на портфейл-карта и /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 Създайте сценарий и добавете вашия CRM's New/Created тригер за контакт. За 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 при повторни опити, така че редът да може да бъде проследен в по-късни събития на webhook; не давайте печати два пъти след неясен неуспешен пробег.
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. Създайте ключа веднъж, копирайте го в защитената HTTP връзка/keychain на Make, след което незабавно го премахнете от клипборда.
Подгответе връзката преди изграждане
Създайте по един ключ API за среда
В 7stamp Admin отидете на API & Integrations → API Keys → Add API Key. Съхранявайте стойността в HTTP API-ключова връзка/keychain на Make, когато тази опция е налична. Никога не картографирайте ключа от текстово поле, не го поставяйте в бележка или не го използвайте в работен процес в браузър. Ключът принадлежи на едно 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 притежава този абонамент; текущата API не излага крайни точки за автоматичен абонамент за webhook/unsubscribe.
Не се изисква публичен Make конектор
Инструкциите на тази страница използват Make модули, които са достъпни за всеки Make акаунт. Ако искате бъдещ нативен модул 7stamp вместо HTTP, изпратете ни работния процес, от който се нуждаете; дотогава HTTP и Custom webhooks покриват всяка документирана операция 7stamp.
Често задавани въпроси
Не мога да намеря 7stamp в Make. Мога ли все пак да го автоматизирам?
Да. Днес няма публично приложение 7stamp в Make. Добавете 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.
Следваща стъпка
Готови ли сте да автоматизирате първото действие за лоялност?
Създайте ключа API, тествайте List Templates и създайте един сценарий за покана или сканиране с контакт за еднократна употреба. Добавете рутери и съобщения само след като този прост поток е надежден.