Bezkoda automatizācijas rokasgrāmata

Savienojiet 7stamp ar Make — soli pa solim

Ieviešanas rokasgrāmata

Izmantojiet Make, lai savienotu numuru 7stamp ar CRM, POS, tiešsaistes veikalu, izklājlapu, ziņojumapmaiņas rīku vai jebkuru sistēmu, kas var nosūtīt datus scenārijā. Ražošanai gatavs maršruts šodien ir Make lietotne HTTP zvaniem 7stamp API un Make Custom webhook ienākošajiem notikumiem 7stamp.

Lietotāja Make lietotņu atlasītājā vēl nav nevienas publiskas lietotnes 7stamp. Negaidiet vienu: pievienojiet HTTP → Make a request, izmantojiet precīzu URL, metodi, Bearer galveni un JSON tālāk, pēc tam kartējiet laukus no sava avota moduļa. Tas ir tas pats 7stamp Integration API, ko izmantos nākotnes savienotājs.

Izvēlieties pirmo scenāriju, kas atbilst jūsu darbplūsmai

Sāciet ar vienu notikumu un vienu rezultātu. Kad testa dati ir pareizi, pievienojiet filtrus, maršrutētājus, CRM atjauninājumus un papildu ziņojumus.

Izveidojiet karti pēc jaunas kontaktpersonas CRM

Izmantojiet CRM kontaktpersonu ID kā External ID, izveidojiet 7stamp kartītes uzaicinājumu, pēc tam nosūtiet atgriezto instalāciju URL, izmantojot savu parasto e-pastu, SMS vai ziņojumapmaiņas darbību.

Pievienojiet zīmogus pēc apmaksāta pasūtījuma

Aktivizējiet scenāriju no apmaksāta POS vai e-komercijas pasūtījuma. Kartē tā stabilo klientu ID un pasūtiet ID kartē Scan a Card, pēc tam izmantojiet summu vai skaidru zīmogu skaitu.

Nosūtiet pēc atlīdzības ziņojumu

Kad kartes notikums ziņo par atlīdzību vai kuponu, sadaliet scenāriju: atjauniniet CRM, informējiet komandu un nosūtiet maka kartes informatīvo ziņojumu vai e-pastu tikai tad, ja tas ir nepieciešams.

Apstrādājiet sistēmu bez vietējās lietotnes Make

Izmantojiet Make moduli HTTP, lai tieši piezvanītu uz 7stamp. Šī ir universāla izvēle pielāgotam POS, ERP, rezervēšanas programmai vai jebkuram API pirmajam pakalpojumam.

7stamp darbības, lai zvanītu no Make HTTP

Katrai tālāk norādītajai kartītei pievienojiet HTTP → Make a request, pēc tam iestatiet metodi un URL tieši tā, kā parādīts. Katram pieprasījumam izmantojiet vienu un to pašu taustiņu Bearer. Nepieciešamā kartēšana norāda, ko piegādāt no CRM, POS vai e-komercijas aktivizētāja.

Make aktivizētājs Webhooks → Custom webhook

Saņemiet kartes notikumu

Izveidojiet Custom webhook Make, kopējiet tā URL un pēc tam ielīmējiet šo URL tīmekļa profila ⟦262666 iestatījumos. Tiek sākts scenārijs, kad 7stamp nosūta notikumu, piemēram, SCAN, REWARD_EARNED vai VOUCHER_ISSUED.

In Make
Webhooks → Custom webhook → Pievienot; piešķiriet tai skaidru nosaukumu un kopējiet tā ģenerēto URL.
Sadaļā 7stamp
Administrators → API & Integrations → Webhooks; ielīmējiet URL, atlasiet notikumu veidus, saglabājiet un pēc tam izveidojiet testa notikumu.
HTTP POST /cards/invite

Izveidojiet darbību Card Invite

Izveido jaunu personīgo instalāciju URL un piegādes-ievietojiet kodu vienai ārējai kontaktpersonai.

Obligāts
external_id — kartējiet savu stalli CRM/contact ID, nevis nosaukumu.
Pēc tam izmantojiet
karti install_url no atbildes e-pastā, SMS vai CRM atjaunināšanas darbību.
HTTP darbība POST /cards/invite/bulk

Lielapjoma izveide Card Invites

Izveido līdz 100 uzaicinājuma saitēm vienā pieprasījumā. Izmantojiet to kontrolētai migrācijai vai kampaņai, nevis neierobežotai kontaktpersonu eksportēšanai.

Nepieciešamie
vienumi — masīvs JSON ar 1–100 individuālu uzaicinājuma pieprasījumu objektu.
Pārbaudiet
Izlasiet success_count, error_count un katru rezultātu pirms saišu nosūtīšanas.
HTTP darbība GET /cards

Find Cards

Atrod karšu ierakstus pēc External ID ar izvēles veidni un avota filtriem.

Obligāts
Vaicājuma parametrs external_id.
Izvēles
external_source un template_id sašaurina uzmeklēšanu, ja vienā sistēmā ir vairākas programmas.
HTTP darbība GET /cards/{user_card_id}

Iegūstiet kartes informāciju

Nolasa pilnu vienas kartes stāvokli, kad iepriekšējā darbība ir atgriezusi tās iekšējo User Card ID.

Obligāts
Aizstāt {user_card_id} ar iekšējo ID, ko atgriezusi uzticama atbilde 7stamp.
Izvairieties no
Neuzminējiet un neuzglabājiet karti ID no cita profila.
HTTP darbība POST /cards/scan

Skenēt karti

Pievieno zīmogus no pirkuma summas vai precīza skaita. Tas pieņem User Card ID vai External ID un var saglabāt ārējā pasūtījuma atsauci.

Identitāte
Izmantojiet external_id un neobligātu external_source; user_card_id uzvar, ja tiek piegādāti abi.
Pirkums
Izmantojiet summu kartēm, kas balstītas uz summu, vai stamps_count precīzam numuram; stamps_count ir prioritāte.
Izsekojamība
Karte external_order_id no apmaksātā pasūtījuma/receipt, lai 7stamp notikumus varētu saskaņot.
HTTP darbība GET /templates

List Templates

Uzskaita taustiņam API pieejamās karšu veidnes. Izmantojiet to, lai pārbaudītu savienojumu vai dinamiski atlasītu veidni.

Pirmā pārbaude
Šis ir visdrošākais pirmais pieprasījums: tam nav korpusa un tas nemaina klienta datus.
Kartēt vēlāk
Izmantojiet aktīvās veidnes ID kā template_id tikai tad, ja profilā ir vairākas aktīvas veidnes.
HTTP darbība GET /templates/{template_id}/design

Get Template Design

Atgriež zināmas veidnes vizuālā noformējuma iestatījumus, kas ir noderīgi, ja citai sistēmai ir jāparāda konsekventa kartes izvēle.

HTTP darbība POST /vouchers/issue

Izdot kuponu

Izsniedz kuponu kartes īpašniekam, kuru identificē ar External ID vai ⟦26325.

Nepieciešams
kupons.short_description. Atlasiet karti ar external_id vai zināmu user_card_id.
Derīgums
Izmantojiet validity_type ar validity_value vai izlasiet OpenAPI atsauci, lai uzzinātu noteiktu derīguma termiņu.
HTTP darbība POST /messages/send

Sūtīt ziņojumu

Nosūta saturu kartes īpašniekam, izmantojot maka kartes push un /or e-pastu, ievērojot konfigurēto kanālu un piekrišanas noteikumus.

Kartes nosūtīšanas
card_push_text garums ir ierobežots līdz 20 rakstzīmēm, un ir nepieciešama instalēta maka karte.
E-pasts
Sūtīt tēmu un pamattekstu; pamata HTML tiek atbalstīts ķermenī.
Make modulis Full 7stamp endpoint URL

HTTP → Make a request

Šis ir Make modulis, kas izsauc katru 7stamp maršrutu. Izmantojiet pilnu URL, atlasiet dokumentēto metodi, pievienojiet galveni Bearer un izmantojiet JSON tikai tad, ja maršrutam ir nepieciešams ķermenis.

Pamatne URL
https://api.7loc.com/cards-api
Galvene
Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json pieprasījumiem POST.

Trīs Make scenāriji, kurus varat izveidot tieši tā, kā rakstīts

Tālāk minētie nosaukumi ir īstie Make moduļi. Sāciet ar pirmo scenāriju, palaidiet to pret vienreiz lietojamu kontaktu un tikai pēc tam pievienojiet maršrutētājus, filtrus vai ražošanas grafiku.

1. Jauna CRM kontaktpersona → nosūtīt 7stamp kartes saiti

Paredzamais rezultāts: Klients saņem install_url, ko atsūta 7stamp; jūsu CRM var saglabāt šo numuru URL tajā pašā kontaktpersonu ierakstā.

  1. 1 Izveidojiet scenāriju un pievienojiet CRM's New/Created Kontaktpersonas aktivizētāju. Kommo izvēlieties kontaktpersonas izveides aktivizētāju un palaidiet to vienreiz, lai ielādētu kontaktpersonas paraugu.
  2. 2 Pievienot HTTP → Make a request. Iestatiet metodi uz POST un URL uz https://api.7loc.com/cards-api/cards/invite.
  3. 3 Pievienot Authorization: Bearer YOUR_7STAMP_⟧⟧ un Content-Type: application/json. JSON pamattekstā kartējiet CRM kontaktpersonu ID ar external_id un iestatiet external_source kā fiksētu iezīmi, piemēram, kommo.
  4. 4 Vienreiz palaidiet moduli HTTP. Apstipriniet, ka izvadē ir install_url, delivery_insert_code, external_id un template_id.
  5. 5 Pievienojiet savu e-pasta/SMS/CRM atjaunināšanas moduli aiz HTTP un kartējiet install_url no HTTP izvades. Saglabājiet URL kontaktpersonai CRM, ja komandai tas vēlāk būs jānosūta atkārtoti.

Pārbaudiet: POST /cards/invite vienmēr izveido jaunu uzaicinājumu. Vispirms izmantojiet Find Cards, ja jūsu uzņēmuma noteikums ir izvairīties no cita uzaicinājuma esošai kontaktpersonai.

2. Apmaksāts pasūtījums → pievienojiet lojalitātes zīmogus

Paredzamais rezultāts: Veiksmīga skenēšanas atbilde ietver sekmīgu scan_id, stamps_added un kartes stāvokli pēc skenēšanas jūsu nākamajai darbībai.

  1. 1 Sāciet no POS/ecommerce Apmaksāta pasūtījuma aktivizētāja. Make vai tā paraugā ir stabils klients ID un pasūtījums /receipt ID.
  2. 2 Pievienojiet HTTP → Make a request ar POST https://api.7loc.com/cards-api/cards/scan un to pašu galveni Bearer.
  3. 3 karte external_id no klienta, external_source no sistēmas nosaukuma un external_order_id no pasūtījuma ID. Pievienojiet summu kartēm, kuru pamatā ir summa, vai stamps_count, lai iegūtu skaidru zīmogu skaitu.
  4. 4 Run once ar pārbaudes pasūtījumu. Pirms scenārija grafika iespējošanas pārbaudiet atgriezto veiksmes karogu un stamps_added.
  5. 5 Pēc HTTP darbības pēc izvēles pievienojiet filtru: turpiniet tikai tad, kad panākumi ir patiesi, pēc tam ierakstiet pasūtījuma/CRM ierakstā — scan_id vai stamps_added.

Pārbaudiet: Izmantojiet to pašu external_order_id atkārtotajiem mēģinājumiem, lai secību varētu izsekot vēlākos tīmekļa aizķeres notikumos; nepiešķiriet pastmarkas divreiz pēc neskaidra neveiksmīga noskrējiena.

3. 7stamp notikums → atjauniniet CRM

Paredzamais rezultāts: Make nekavējoties saņem notikumu 7stamp, izmantojot ⟦, un var atrast atbilstošo ierakstu ⟦2645 external_id un external_source.

  1. 1 Izveidojiet atsevišķu Make scenāriju. Pievienojiet Webhooks → Custom webhook, atlasiet Pievienot, nosauciet to kā 7stamp-card-events un kopējiet ģenerēto URL.
  2. 2 Laukā 7stamp Admin atveriet API & Integrations → Webhooks. Pievienojiet šo URL un atlasiet nelielu notikumu kopu, piemēram, SCAN un REWARD_EARNED.
  3. 3 Izveidojiet vienreizējās lietošanas pārbaudes skenēšanas vai kartes notikumu 7stamp. Atgriezieties pie Make un izmantojiet Run once, lai ļautu Make noteikt notikumu datu struktūru.
  4. 4 Pievienojiet CRM meklēšanas darbību, izmantojot external_id. Pievienojiet filtru vai maršrutētāju vietnei event_type, lai SCAN, REWARD_EARNED un VOUCHER_ISSUED varētu veikt dažādas darbības.
  5. 5 Pievienojiet darbību CRM atjauninājums/note. Kartē scanned_at, stamps_after, external_order_id un issued_vouchers tikai tad, ja šie lauki ir pieejami atlasītajam notikuma veidam.

Pārbaudiet: Saglabājiet tīmekļa aizķeri URL privātu. Pirms neatgriezenisku ziņojumu, kuponu vai CRM izmaiņu ieslēgšanas pārbaudiet reālu notikumu.

Iegūstiet taustiņu 7stamp API, pirms atverat Make

Šie ir tieši 7stamp Admin ekrāni. Vienreiz izveidojiet atslēgu, iekopējiet to Make drošajā HTTP savienojumā/keychain un pēc tam nekavējoties noņemiet to no starpliktuves.

7stamp Admin API un integrāciju ekrāns ar API Keys sarakstu un Add API Key vadīklu
In 7stamp Admin, pēc tam atver integrācijas, 7stamp Admin, API Keys un atlasiet Add API Key.
Jauns atslēgas dialoglodziņš 7stamp API ar redzamu kopēšanas vadīklu
Kopēt atslēgu tikai drošā Make HTTP savienojumā/keychain. Uztveriet to kā paroli un pagrieziet to, ja tā ir atklāta.

Sagatavojiet savienojumu pirms izveides

Izveidojiet vienu API atslēgu katrai videi

Laukā 7stamp Admin dodieties uz API & Integrations → API Keys → Add API Key. Saglabājiet vērtību Make HTTP API-taustiņu savienojumā/keychain, kad šī opcija ir pieejama. Nekad neatzīmējiet atslēgu no teksta lauka, neievietojiet to piezīmē un neizmantojiet to pārlūkprogrammas darbplūsmā. Atslēga pieder vienai 7stamp darba vietai/profile.

Izmantojiet stabilu External ID

Kartē nemainīgo, ID no sava 64⟦26363. POS vai tirdzniecības platforma, piemēram, CRM kontaktpersona ID vai klients UUID. Pievienojiet External Source, piemēram, hubspot, shopify vai plakātu, ja viens un tas pats identifikators varētu parādīties vairākās sistēmās.

Izlemiet, kura veidne tiek piemērota

Ja pievienotajam 7stamp profilam ir viena aktīva kartes veidne, veidni var atstāt tukšu. Izmantojot vairākas veidnes, kartējiet vai izvēlieties template_id apzināti, lai katrs uzaicinājums un skenēšana sasniegtu paredzēto lojalitātes programmu.

Precīza Make HTTP iestatīšana: izveidojiet vienu kartītes uzaicinājumu

Kopējiet to savā automatizācijas darbībā 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
}

Izveidojiet un pārbaudiet savu pirmo Make scenāriju

01

7stamp Admin 1. vietā izveidojiet 26 atslēgu. Izmantojiet atsevišķu testa profilu /key, kad to atļauj jūsu konta iestatīšana.

02

Dokumentā Make izveidojiet scenāriju un pievienojiet avota aktivizētāju. Palaidiet to vienreiz pirms kartēšanas, lai jūs varētu redzēt reālu kontaktpersonas paraugu vai apmaksātu pasūtījumu.

03

Noklikšķiniet uz nākamā pluszīmes, meklējiet HTTP un izvēlieties Make pieprasījumu. Iestatiet metodi, pilnu URL un galvenes no šīs lapas darbības kartes.

04

Kā pirmo pieprasījumu izmantojiet GET https://api.7loc.com/cards-api/templates. Tā veiksmīgā atbilde pierāda, ka atslēga darbojas, nemainot nekādus klienta datus.

05

Maršrutiem POST atlasiet application/json un ielīmējiet ķermeņa formu no šī ceļveža. Kartē stallis External ID; pievienojiet template_id tikai tad, ja profilam ir vairākas aktīvas veidnes.

06

Palaidiet ar vienreizējo kontaktu, pārbaudiet HTTP izvadi un tikai pēc tam kartējiet tā precīzos atbildes laukus nākamajā CRM, e-pastā vai ziņojumapmaiņas modulī.

Kad vajadzētu lietot Make HTTP?

Izmantojiet HTTP ar 7stamp tagad: tas ir dokumentēts, ražošanai gatavs maršruts, nevis samazināta atkāpšanās iespēja. Izvēlieties to ikreiz, kad nepieciešama 7stamp darbība, jauns API maršruts vai pielāgots POS/ERP savienojums. Atsauce OpenAPI ir patiesības avots metodei, pilnam ceļam, pamattekstam un atbildes shēmai; nesēja atslēga un pamatne URL paliek nemainīga.

Saņemiet 7stamp notikumus sadaļā Make

Uz notikumu balstītam scenārijam pievienojiet Webhooks → Custom webhook un izveidojiet tīmekļa aizķeri. Kopējiet tā URL, atveriet API & Integrations → Webhooks profilā 7stamp, ielīmējiet URL, atlasiet notikumu veidus, saglabājiet un nosūtiet īstu testa notikumu. Šis abonements pieder profilam 7stamp; pašreizējais API neatklāj automātiskās tīmekļa aizķeres abonēšanas/unsubscribe galapunktus.

Publisks Make savienotājs nav nepieciešams

Šajā lapā sniegtie norādījumi izmanto Make moduļus, kas ir pieejami katram Make kontam. Ja nākotnē vēlaties 7stamp moduli, nevis HTTP, nosūtiet mums nepieciešamo darbplūsmu; līdz tam HTTP un Custom webhook attiecas uz katru dokumentēto 7stamp darbību.

Jautājiet par vietējo savienotāju

Bieži uzdotie jautājumi

Es nevaru atrast 7stamp sadaļā Make. Vai es joprojām varu to automatizēt?

Jā. Šodien Make nav publiskas lietotnes 7stamp. Pievienojiet pieprasījumu HTTP > Make, izmantojiet pilno 7stamp galapunktu URL un nosūtiet Authorization: Bearer, kam seko jūsu atslēga 7stamp API. HTTP var izsaukt katru dokumentēto galapunktu.

Kur es varu iegūt marķieri savienojumam Make?

Sadaļā 7stamp Admin atveriet API Integrācijas, pēc tam API Keys un pēc tam Add API Key. Atslēga attiecas uz darba vietu/profile, kas to izveidoja, tāpēc, kad vien iespējams, izmantojiet testa profilu testa scenārijiem.

Kuru identifikatoru man vajadzētu kartēt kā External ID?

Izmantojiet stabilo identifikatoru no avota sistēmas, vēlams CRM kontaktpersonu ID vai klientu UUID. Neizmantojiet parādāmo vārdu. Tālruņa numurs vai e-pasta adrese var darboties, taču var mainīties, un tie ir jārīkojas konsekventi.

Kā 7stamp notikumus iekļaut Make?

Izveidojiet Web aizķeri > Custom webhook Make, pēc tam ielīmējiet tā ģenerēto URL profila 7stamp tīmekļa aizķeres iestatījumos. Pēc piegādes izmantojiet filtru vai maršrutētāju Make, lai apstrādātu ienākošo event_type.

Nākamais solis

Vai esat gatavs automatizēt pirmo lojalitātes darbību?

Izveidojiet atslēgu API, pārbaudiet List Templates un izveidojiet vienu uzaicinājuma vai skenēšanas scenāriju ar vienreiz lietojamu kontaktpersonu. Pievienojiet maršrutētājus un ziņojumapmaiņu tikai pēc tam, kad vienkāršā plūsma būs uzticama.