Creați un card după un nou contact CRM
Utilizați contactul CRM ID ca External ID, creați o invitație pentru cardul 7stamp, apoi trimiteți instalarea returnată URL prin e-mailul dvs. obișnuit, SMS sau pasul de mesagerie.
Ghid de automatizare fără cod
Conectați 7stamp la Make — pas cu pas
Ghid de implementareUtilizați Make pentru a conecta 7stamp la un CRM, POS, magazin online, foaie de calcul, instrument de mesagerie sau orice sistem care poate trimite date într-un scenariu. Ruta gata de producție astăzi este aplicația HTTP a Make pentru apelurile 7stamp API și Make Custom webhook pentru evenimentele 7stamp primite.
Nu există încă nicio aplicație publică 7stamp în selectorul de aplicații al lui Make. Nu așteptați unul: adăugați HTTP → Make a request, utilizați metoda exactă URL, antetul Bearer și JSON de mai jos, apoi mapați câmpurile din modulul sursă. Acesta este același 7stamp Integration API pe care l-ar folosi un viitor conector.
Alegeți primul scenariu care se potrivește fluxului dvs. de lucru
Începeți cu un eveniment și un rezultat. Odată ce datele de testare sunt corecte, adăugați filtre, routere, actualizări CRM și mesaje de urmărire în jurul lor.
Adăugați ștampile după o comandă plătită
Declanșează scenariul dintr-o comandă plătită POS sau de comerț electronic. Mapează clientul stabil ID și comandă ID în Scan a Card, apoi folosește o sumă sau un număr explicit de timbre.
Trimiteți o recompensă în continuare
Când un eveniment de card raportează o recompensă sau un voucher, ramificați scenariul: actualizați CRM, notificați echipa și trimiteți un push sau un e-mail pentru cardul de portofel numai atunci când este necesar.
Gestionați un sistem fără o aplicație nativă Make
Folosiți modulul HTTP al lui Make pentru a apela direct 7stamp. Aceasta este alegerea universală pentru un motor de rezervare personalizat POS, ERP sau orice prim serviciu API.
7stamp operațiuni de apel de la Make180⟦1860
Pentru fiecare card de mai jos, adăugați HTTP → Make a request, apoi setați metoda și URL exact așa cum se arată. Folosiți aceeași cheie Bearer pentru fiecare solicitare. Maparea necesară vă spune ce să furnizați de la CRM, POS sau declanșator de comerț electronic.
Make declanșează
Webhooks → Custom webhook Primiți un eveniment cu card
Creați un Custom webhook în Make, copiați-i URL, apoi inserați acel URL în profilul 7stamp de setări webhooks. Aceasta pornește un scenariu când 7stamp trimite un eveniment precum SCAN, REWARD_EARNED sau VOUCHER_ISSUED.
- În Make
- Webhooks → Custom webhook → Adăugați; dați-i un nume clar și copiați URL generat.
- În 7stamp
- Admin → API & Integrations → Webhooks; inserați URL, selectați tipurile de evenimente, salvați, apoi creați un eveniment de testare.
HTTP
POST /cards/invite Creați o acțiune Card Invite
Creează o nouă instalare personală URL și inserați codul de livrare pentru un contact extern.
- Obligatoriu
- external_id — mapați grajdul dvs. CRM/contact ID, nu un nume.
- Apoi utilizați
- Harta install_url din răspuns în e-mailul dvs., SMS sau CRM pasul de actualizare.
HTTP acțiune
POST /cards/invite/bulk Creare în bloc Card Invites
Creează până la 100 de link-uri de invitație într-o singură solicitare. Utilizați-l pentru o migrare sau o campanie controlată, nu un export nelimitat de contacte.
- Elemente
- necesare — o matrice JSON de 1–100 de obiecte individuale de solicitare de invitație.
- Verificați
- Citiți success_count, error_count și fiecare rezultat înainte de a trimite orice link.
HTTP acțiune
GET /cards Find Cards
Găsește înregistrările cardului după External ID, cu șablon opțional și filtre sursă.
- Obligatoriu
- Parametru de interogare external_id.
- Opțional
- external_source și template_id restrâng căutarea atunci când un sistem are mai multe programe.
HTTP acțiune
GET /cards/{user_card_id} Obțineți un detaliu card
Citește starea completă a unui card atunci când un pas anterior a returnat User Card ID intern.
- Obligatoriu
- Înlocuiți {user_card_id} cu ID intern returnat de un răspuns de încredere 7stamp.
- Evitați
- Nu ghiciți și nu stocați un card ID de la un alt profil.
HTTP acțiune
POST /cards/scan Scanarea unui card
Adaugă timbre dintr-o sumă de achiziție sau dintr-un număr explicit. Acceptă User Card ID sau External ID și poate păstra referința comenzii externe.
- Identitate
- Utilizați external_id și opțional external_source; user_card_id câștigă dacă ambele sunt furnizate.
- Cumpărare
- Utilizați suma pentru cardurile bazate pe sumă sau stamps_count pentru un număr explicit; stamps_count are prioritate.
- Trasabilitate
- Harta external_order_id din comanda plătită/receipt, astfel încât evenimentele 7stamp pot fi corelate înapoi.
HTTP acțiune
GET /templates List Templates
Listează șabloanele de card disponibile pentru tasta API. Utilizați-l pentru a testa conexiunea sau pentru a selecta dinamic un șablon.
- Primul test
- Aceasta este prima solicitare cea mai sigură: nu are corp și nu modifică datele clientului.
- Hartă mai târziu
- Utilizați ID-ul unui șablon activ ca template_id numai atunci când profilul are mai multe șabloane active.
HTTP acțiune
GET /templates/{template_id}/design Get Template Design
Returnează setările de design vizual pentru un șablon cunoscut, util atunci când un alt sistem trebuie să afișeze o alegere consecventă a cardului.
HTTP acțiune
POST /vouchers/issue Emite un voucher
Emite un voucher unui proprietar de card identificat prin External ID sau User Card ID.
- Necesar voucher
- .short_description. Vizați cardul cu external_id sau un user_card_id cunoscut.
- Valabilitate
- Utilizați validity_type cu validity_value sau citiți referința OpenAPI pentru o dată de expirare fixă.
HTTP acțiune
POST /messages/send Trimite un mesaj
Trimite conținut proprietarului cardului prin push-carte de portofel și/or e-mail, în conformitate cu canalul configurat și regulile de consimțământ.
- Card push
- card_push_text este limitat la 20 de caractere și necesită un permis de portofel instalat.
- Trimite subiectul plus corpul; de bază HTML este susținută în corp.
Make modulul
Full 7stamp endpoint URL HTTP → Make a request
Acesta este modulul Make care apelează fiecare rută 7stamp de mai sus. Utilizați un URL complet, selectați metoda documentată, adăugați antetul Bearer și folosiți JSON numai atunci când traseul are nevoie de un corp.
- Baza URL
- https://api.7loc.com/cards-api
- Antet
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json pentru cererile POST.
Trei Make scenarii pe care le puteți construi exact așa cum este scris
Numele de mai jos sunt modulele reale Make. Începeți cu primul scenariu, rulați-l împotriva unui contact de unică folosință și abia apoi adăugați routere, filtre sau programarea producției.
1. Contact nou CRM → trimite un link de card 7stamp
Rezultat așteptat: Clientul primește install_url returnat de 7stamp; CRM dvs. poate păstra acel URL în aceeași înregistrare de contact.
- 1 Creați un scenariu și adăugați declanșatorul de contact al CRM Nou/Created. Pentru Kommo, alegeți declanșatorul de creare a contactului și rulați-l o dată pentru a încărca un eșantion de contact.
- 2 Adăugați HTTP → Make a request. Setați metoda la POST și URL la https://api.7loc.com/cards-api/cards/invite.
- 3 Adăugați Authorization: Bearer YOUR_7STAMP_6⟦18_KE⟧Y⟧ Content-Type: application/json. În corpul JSON, mapați contactul CRM ID în external_id și setați external_source la o etichetă fixă, cum ar fi kommo.
- 4 Rulați modulul HTTP o dată. Confirmați că rezultatul are install_url, delivery_insert_code, external_id și template_id.
- 5 Adăugați modulul de e-mail/SMS/CRM după HTTP și mapați install_url din ieșirea HTTP. Salvați URL pe contactul CRM dacă echipa trebuie să-l retrimită mai târziu.
Verificați: POST /cards/invite creează întotdeauna o invitație nouă. Utilizați mai întâi Find Cards dacă regula dvs. de afaceri este să evitați o altă invitație pentru un contact existent.
2. Comanda plătită → adăugați timbre de fidelitate
Rezultat așteptat: Un răspuns de scanare reușit include succesul, scan_id, stamps_added și starea cardului post-scanare pentru următorul pas.
- 1 Începeți de la declanșarea comenzii plătite POS/ecommerce. Make sigur că eșantionul său conține un client stabil ID și comanda/receipt ID.
- 2 Adăugați HTTP → Make a request cu POST https://api.7loc.com/cards-api/cards/scan și același antet Bearer.
- 3 Harta external_id de la client, external_source de la numele sistemului și external_order_id din comandă ID. Adăugați o sumă pentru cardurile bazate pe sumă sau stamps_count pentru un număr explicit de timbre.
- 4 Run once cu o comandă de testare. Verificați indicatorul de succes returnat și stamps_added înainte de a activa programarea scenariului.
- 5 Opțional adăugați un filtru după pasul HTTP: continuați numai când succesul este adevărat, apoi scrieți scan_id sau stamps_added înapoi în înregistrarea comenzii/CRM.
Verificați: Utilizați același external_order_id la reîncercări, astfel încât ordinea să poată fi urmărită în evenimentele webhook ulterioare; nu acordați timbre de două ori după o cursă neclară eșuată.
3. 7stamp eveniment → actualizați CRM
Rezultat așteptat: Make primește imediat evenimentul 7stamp și poate găsi înregistrarea potrivită prin ⟦188 external_id și external_source.
- 1 Creați un scenariu separat Make. Adăugați Webhooks → Custom webhook, selectați Adăugare, denumiți-o 7stamp-card-events și copiați URL generat.
- 2 În 7stamp Admin, deschideți API & Integrations → Webhooks. Adăugați acel URL și selectați un set mic de evenimente, de exemplu SCAN și REWARD_EARNED.
- 3 Creați un test de scanare de unică folosință sau un eveniment de card în 7stamp. Reveniți la Make și utilizați Run once pentru a lăsa Make să determine structura datelor evenimentului.
- 4 Adăugați un pas de căutare CRM folosind external_id. Adăugați un filtru sau un router pe event_type, astfel încât SCAN, REWARD_EARNED și VOUCHER_ISSUED să poată efectua diferite acțiuni.
- 5 Adăugați acțiunea CRM actualizare/note. Harta scanned_at, stamps_after, external_order_id și issued_vouchers numai atunci când acele câmpuri sunt prezente pentru tipul de eveniment selectat.
Verificați: Păstrați webhook-ul URL privat. Testați un eveniment real înainte de a activa mesajele ireversibile, voucherele sau modificările CRM.
Obțineți cheia 7stamp API înainte de a deschide Make
Acestea sunt ecranele exacte 7stamp Admin. Creați cheia o dată, copiați-o în conexiunea securizată Make a HTTP/keychain, apoi scoateți-o imediat din clipboard.
Pregătiți conexiunea înainte de a construi
Creați o cheie API per mediu
În 7stamp Admin, accesați API & Integrations → API Keys → Add API Key. Stocați valoarea în Make HTTP API-key connection/keychain atunci când acea opțiune este disponibilă. Nu mapați niciodată cheia dintr-un câmp de text, nu o plasați într-o notă sau nu o utilizați într-un flux de lucru orientat spre browser. O cheie aparține unui 7stamp loc de muncă/profile.
Utilizați un stabil External ID
Hartați imuabilul ID din ID de la ⟦18, POS sau o platformă comercială — de exemplu, un contact CRM ID sau un client UUID. Adăugați External Source, cum ar fi hubspot, shopify sau poster atunci când același identificator poate apărea în mai multe sisteme.
Decideți ce șablon se aplică
Când profilul 7stamp conectat are un șablon de card activ, șablonul poate fi lăsat gol. Cu mai multe șabloane, mapați sau alegeți template_id în mod deliberat, astfel încât fiecare invitație și scanare să ajungă la programul de loialitate dorit.
Configurare exactă Make HTTP: creați o invitație pentru card
Copiați acest lucru în pasul dvs. de automatizare
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
}Construiți și testați primul scenariu Make
In 7stamp Admin, create a key in API & Integrations → API Keys → Add API Key. Use a separate test profile/key when your account setup allows it.
În Make, creați un scenariu și adăugați declanșatorul sursă. Rulați-l o dată înainte de mapare, astfel încât să puteți vedea un eșantion real de contact sau o comandă plătită.
Faceți clic pe următorul plus, căutați HTTP și alegeți Make o solicitare. Setați metoda, complet URL și anteturile de pe cardul de operație pe această pagină.
Utilizați GET https://api.7loc.com/cards-api/templates ca primă solicitare. Răspunsul său de succes dovedește că cheia funcționează fără modificarea datelor despre clienți.
Pentru rutele POST, selectați application/json și lipiți forma corpului din acest ghid. Harta un grajd External ID; adăugați template_id numai dacă profilul are mai multe șabloane active.
Rulați cu un contact de unică folosință, inspectați ieșirea HTTP și abia apoi mapați câmpurile exacte de răspuns în următorul CRM, e-mail sau modul de mesagerie.
Când ar trebui să utilizați Make HTTP?
Folosiți HTTP pentru 7stamp acum: este ruta documentată, pregătită pentru producție, nu o rezervă redusă. Alegeți-l oricând aveți nevoie de o operațiune 7stamp, de o nouă rută API sau de o conexiune personalizată POS/ERP. Referința OpenAPI este sursa adevărului pentru metodă, calea completă, corpul și schema de răspuns; cheia purtătorului și baza URL rămân aceleași.
Primiți 7stamp evenimente în Make
Pentru un scenariu bazat pe evenimente, adăugați Webhooks → Custom webhook și creați un webhook. Copiați URL, deschideți API & Integrations → Webhooks în profilul 7stamp, lipiți URL, selectați tipurile de evenimente, salvați și trimiteți un eveniment de testare real. Profilul 7stamp deține acel abonament; actualul API nu expune punctele finale automate de abonare webhook/unsubscribe.
Nu este necesar niciun conector public Make
Instrucțiunile de pe această pagină folosesc module Make care sunt disponibile pentru fiecare cont Make. Dacă doriți un viitor modul nativ 7stamp în loc de HTTP, trimiteți-ne fluxul de lucru de care aveți nevoie; până atunci, HTTP și Custom webhook acoperă fiecare operațiune documentată 7stamp.
Întrebări frecvente
Nu pot găsi 7stamp în Make. Mai pot să-l automatizez?
Da. Nu există nicio aplicație publică 7stamp în Make astăzi. Adăugați HTTP > Make o solicitare, utilizați punctul final complet 7stamp URL și trimiteți Authorization: Bearer urmat de cheia dvs. ⟦1857. HTTP poate apela fiecare punct final documentat.
De unde obțin jetonul pentru conexiunea Make?
În 7stamp Admin, deschideți API Integrații, apoi API Keys, apoi Add API Key. Cheia se aplică la locul de muncă/profile care a creat-o, așa că utilizați un profil de testare pentru scenariile de testare ori de câte ori este posibil.
Ce identificator ar trebui să mapez ca External ID?
Utilizați identificatorul stabil din sistemul sursă, de preferință un contact CRM ID sau un client UUID. Nu utilizați un nume afișat. Un număr de telefon sau un e-mail poate funcționa, dar se poate schimba și trebuie tratat în mod consecvent.
Cum introduc evenimentele 7stamp în Make?
Creați un Webhook > Custom webhook în Make, apoi inserați URL generat în setările de webhook ale profilului 7stamp. Utilizați un filtru sau un router Make după livrare pentru a gestiona event_type primit.
Următorul pas
Ești gata să automatizezi prima acțiune de loialitate?
Creați cheia API, testați List Templates și construiți o invitație sau un scenariu de scanare cu un contact de unică folosință. Adăugați routere și mesagerie numai după ce fluxul simplu este fiabil.