Водич за аутоматизацију без кода

Повежите 7stamp са Make — корак по корак

Водич за имплементацију

Користите Make да повежете 7stamp са CRM, POS, онлајн продавницом, табелом, алатком за размену порука или било којим системом који може да шаље податке у сценарио. Рута која је данас спремна за производњу је апликација Make HTTP за 7stamp API позиве и Make Custom webhook за долазне 7stamp догађаје.

Још увек нема јавне апликације 7stamp у бирачу апликација Make. Не чекајте једно: додајте HTTP → Make a request, користите тачно URL, метод, Bearer заглавље и JSON испод, а затим мапирајте поља из вашег изворног модула. Ово је исти 7stamp Integration API који би користио будући конектор.

Отворено Make Отворите API референцу

Изаберите први сценарио који одговара вашем току посла

Почните са једним догађајем и једним исходом. Када су тестни подаци тачни, додајте филтере, рутере, CRM ажурирања и пратеће поруке око њих.

Направите картицу након новог контакта CRM

Користите CRM контакт ID као External ID, креирајте позивницу за картицу 7stamp, а затим пошаљите враћену инсталацију URL путем уобичајене е-поште, SMS, корак за слање порука.

Додајте марке након плаћене поруџбине

Покрените сценарио из плаћене POS или поруџбине путем е-трговине. Мапирајте свог стабилног купца ID и наручите ID у Скенирај картицу, а затим користите износ или експлицитни број марака.

Пошаљите наставак за награду

Када догађај картице пријави награду или ваучер, разгранајте сценарио: ажурирајте CRM, обавестите тим и пошаљите пусх картицу или имејл само када је то потребно.

Управљајте системом без матичне апликације Make

Користите модул Make HTTP да бисте директно позвали 7stamp. Ово је универзални избор за прилагођену POS, ERP, механизам за резервације или било коју API-прву услугу.

7stamp операције за позив са Make HTTP

За сваку картицу испод, додајте HTTP → Make a request, а затим поставите метод и URL тачно како је приказано. Користите исти кључ Bearer за сваки захтев. Захтевано мапирање вам говори шта да испоручите са окидача CRM, POS или е-трговине.

Make окидач Webhooks → Custom webhook

Примите догађај картице

Направите Custom webhook у Make, копирајте његов URL, а затим налепите то URL у ⟦⟧29134 веб подешавања. Ово покреће сценарио када 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 Inviteс

Креира до 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

Пошаљи поруку

Шаље садржај власнику картице путем пусх картице новчаника и/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_КЕИ; Content-Type: application/json за POST захтеве.

Три Make сценарија која можете да направите тачно онако како је написано

Називи испод су прави Make модули. Почните са првим сценаријом, покрените га на контакту за једнократну употребу, а тек онда додајте рутере, филтере или заказивање производње.

1. Нови CRM контакт → пошаљите везу 7stamp картице

Очекивани резултат: Купац добија install_url враћен до 7stamp; ваш CRM може задржати тај URL у истом контакту.

  1. 1 Креирајте сценарио и додајте свој CRM Нови/Created окидач за контакт. За Kommo, изаберите окидач за креирање контакта и покрените га једном да бисте учитали узорак контакта.
  2. 2 Додај HTTP → Make a request. Поставите метод на POST и URL на https://api.7loc.com/cards-api/cards/invite.
  3. 3 Додајте Authorization: Bearer YOUR_7STAMP_7⟦2КЕ Content-Type: application/json. У телу JSON мапирајте контакт CRM ID у external_id и подесите external_source на фиксну ознаку као што је коммо.
  4. 4 Покрените модул HTTP једном. Потврдите да излаз има install_url, delivery_insert_code, external_id и template_id.
  5. 5 Додајте своју е-пошту/SMS/CRM модул за ажурирање после HTTP и мапу install_url из излаза HTTP. Сачувајте URL на CRM контакту ако тим мора да га поново пошаље касније.

Проверите: POST /cards/invite увек креира нову позивницу. Прво користите Find Cards ако је ваше пословно правило да избегавате још једну позивницу за постојећи контакт.

2. Плаћена поруџбина → додајте марке лојалности

Очекивани резултат: Успешан одговор скенирања укључује успех, scan_id, stamps_added и стање картице након скенирања за ваш следећи корак.

  1. 1 Почните од окидача POS/ecommerce Плаћеног налога. Make сигуран да његов узорак садржи стабилног купца ID и поруџбину/receipt ID.
  2. 2 Додајте HTTP → Make a request са POST https://api.7loc.com/cards-api/cards/scan и истим заглављем Bearer.
  3. 3 Мапа external_id од купца, external_source од назива система и external_order_id од поруџбине ID. Додајте износ за картице засноване на количини или stamps_count за изричит број марака.
  4. 4 Run once са тестном наруџбом. Проверите враћену заставицу успеха и stamps_added пре него што омогућите распоред сценарија.
  5. 5 Опционо додајте филтер после корака HTTP: наставите само када је успех истинит, а затим упишите scan_id или stamps_added назад у запис налога/CRM.

Проверите: Користите исти external_order_id при поновним покушајима како би се поредак могао пратити у каснијим догађајима веб-хука; не додељује маркице два пута након нејасне неуспешне вожње.

3. 7stamp догађај → ажурирај CRM

Очекивани резултат: Make receives the 7stamp event immediately and can find the matching CRM record via external_id and external_source.

  1. 1 Направите посебан сценарио Make. Додајте Webhooks → Custom webhook, изаберите Додај, назовите га 7stamp-цард-евентс и копирајте генерисано URL.
  2. 2 У 7stamp Admin, отвори API & Integrations → Webhooks. Додајте то URL и изаберите мали скуп догађаја, на пример SCAN и REWARD_EARNED.
  3. 3 Креирајте тест скенирања за једнократну употребу или догађај картице у 7stamp. Вратите се на Make и користите Run once да дозволите Make да одреди структуру података догађаја.
  4. 4 Додајте корак претраге CRM користећи external_id. Додајте филтер или рутер на event_type како би SCAN, REWARD_EARNED и VOUCHER_ISSUED могли да предузму различите радње.
  5. 5 Додајте акцију CRM ажурирање/note. Мапа scanned_at, stamps_after, external_order_id и issued_vouchers само када су та поља присутна за изабрани тип догађаја.

Проверите: Нека веб-хук URL остане приватан. Тестирајте стварни догађај пре него што укључите неповратне поруке, ваучере или промене CRM.

Узмите кључ 7stamp API пре отварања Make

Ово су тачни 7stamp Admin екрани. Креирајте кључ једном, копирајте га у сигурну везу Make HTTP/keychain, а затим га одмах уклоните из међуспремника.

7stamp Admin API & Интегратионс екран са листом API Keys и контролом Add API Key
In 7stamp Admin, open API & Integrations, then API Keys, and select Add API Key.
Нови дијалог 7stamp API кључа са видљивом контролом копирања
Копирајте кључ само у безбедну Make HTTP везу/keychain. Третирајте га као лозинку и ротирајте га ако је изложен.

Припремите везу пре изградње

Направите један кључ API по окружењу

У 7stamp Admin идите на API & Integrations → API Keys → Add API Key. Сачувајте вредност у Make'с HTTP API-кључ везу/keychain када је та опција доступна. Никада немојте мапирати кључ из текстуалног поља, стављати га у белешку или га користити у току рада који је окренут прегледачу. Кључ припада једном 7stamp радном месту/profile.

Користите шталу External ID

Мапирајте непроменљиво ID од 32⟧29, POS, или комерцијална платформа—на пример CRM контакт ID или купац UUID. Додајте External Source као што је хубспот, схопифи или постер када се исти идентификатор може појавити у више система.

Одлучите који шаблон се примењује

Када повезани профил 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 сценарио

01

У 7stamp Admin⟧, креирајте кључ 29 у. Користите посебан профил за тестирање/key када вам подешавања налога то дозвољавају.

02

У Make, креирајте сценарио и додајте изворни окидач. Покрените га једном пре мапирања да бисте могли да видите прави узорак контакта или плаћену поруџбину.

03

Кликните на следећи плус, потражите HTTP и изаберите Make захтев. Подесите метод, пуну URL, и заглавља са оперативне картице на овој страници.

04

Користите GET https://api.7loc.com/cards-api/templates као први захтев. Његов успешан одговор доказује да кључ функционише без промене података о клијентима.

05

За руте POST изаберите application/json и налепите облик тела из овог водича. Мапирајте шталу External ID; додајте template_id само ако профил има више активних шаблона.

06

Покрените са контактом за једнократну употребу, прегледајте излаз 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 не излаже крајње тачке аутоматског претплате на веб-хук/unsubscribe.

Није потребан јавни Make конектор

Упутства на овој страници користе Make модуле који су доступни сваком Make налогу. Ако желите будући изворни 7stamp модул, а не HTTP, пошаљите нам ток посла који вам је потребан; до тада, HTTP и Custom webhook покривају сваку документовану операцију 7stamp.

Питајте о изворном конектору

Често постављана питања

Не могу да пронађем 7stamp у Make. Могу ли га и даље аутоматизовати?

Да. Данас нема јавне апликације 7stamp у Make. Додајте HTTP > Make захтев, користите комплетну крајњу тачку 7stamp URL и пошаљите Authorization: Bearer након чега следи ваш кључ ⟦⟧80. HTTP може позвати сваку документовану крајњу тачку.

Где могу да набавим токен за везу Make?

У 7stamp Admin отворите API Интеграције, затим API Keys, па Add API Key. Кључ је у опсегу радног места/profile које га је креирало, па користите тестни профил за сценарије тестирања кад год је то могуће.

Који идентификатор да мапирам као External ID?

Користите стабилни идентификатор из изворног система, пожељно CRM контакт ID или купца UUID. Не користите име за приказ. Број телефона или имејл могу да раде, али могу да се промене и њима треба доследно поступати.

Како да пребацим 7stamp догађаје у Make?

Направите веб-кукице > Custom webhook у Make, а затим налепите генерисано URL у подешавања веб-хука профила 7stamp. Користите Make филтер или рутер након испоруке за руковање долазним event_type.

Повезане странице

Отворено Make Make HTTP помоћ Make Custom webhook помоћ 7stamp API референца Вебхоок подешавање Zapier водич

Следећи корак

Спремни да аутоматизујете прву акцију лојалности?

Креирајте кључ API, тестирајте List Templates и направите један сценарио позивања или скенирања са контактом за једнократну употребу. Додајте рутере и размену порука тек када тај једноставан ток буде поуздан.

Отворено 7stamp Admin Прочитајте референцу API