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.