Ръководство за автоматизация без код

Свържете 7stamp към Zapier — стъпка по стъпка

Ръководство за внедряване

Използвайте Zapier, когато вашият работен процес е ясна последователност: контакт или се появява поръчка, 7stamp извършва действие, след което се актуализира друг бизнес инструмент. Сигурният маршрут днес е API на Zapier за изходящи 7stamp API повиквания и Webhooks by Zapier → Catch Hook за входящи 7stamp събития.

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

Започнете с линеен, тестван Zap

Дръжте първия 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 чрез 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_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. Поставете го в настройките на webhook на 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 & Integrations с действието Add API Key
Отворете API & Integrations, изберете 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, показано в настройката на теста, поставете го в настройките на webhook на профила 7stamp, изберете типовете събития и след това изпратете истинско тестово сканиране или събитие на карта. Използвайте полезния товар на събитието External ID и External Source, за да намерите правилния контакт CRM. Изберете Catch Raw Hook само когато конкретно се нуждаете от неанализирано тяло и заглавки на заявка.

Използвайте защитения маршрут Zapier сега

API от Zapier и Catch Hook са достатъчни за всяка публична операция 7stamp API и събитие с карта. Ако имате нужда от бъдещо родно приложение 7stamp Zapier, изпратете ни точното действие/trigger, което вашият екип използва най-много.

Попитайте за роден конектор

Често задавани въпроси

Къде мога да намеря приложението 7stamp в Zapier?

Днес няма обществено приложение за пазар 7stamp. Използвайте API by Zapier → API Request за 7stamp API повиквания и Webhooks by Zapier → Catch Hook за входящи 7stamp събития.

Къде да създам токена Zapier?

Създайте ключ 7stamp API в Admin под API & Integrations → API Keys → Add API Key. Съхранявайте го като статичен хедър Bearer Authorization във връзката API от Zapier, а не във видимо поле за действие Webhooks by Zapier.

Как може Zapier да получи печат или ваучер за събитие?

Създайте Catch Hook в Webhooks by Zapier, поставете генерирания URL в настройките на webhook профила на 7stamp, изберете събитията и изпратете тестово събитие, преди да активирате актуализациите на CRM.

Да избера ли Zapier или Make?

Изберете Zapier за предимно линеен работен процес за задействане. Изберете Make, когато имате нужда от рутери, сложни трансформации или дълги многоклонови сценарии. И двете използват един и същ ключ 7stamp API и крайни точки.

Следваща стъпка

Създайте първия Zap с тестов контакт

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