Creați o invitație de la o persoană de contact CRM
Declanșați un contact nou sau calificat, mapați-i CRM ID la External ID, instalați un card de retur invitat, instalați-l URL la un e-mail sau la un pas SMS.
Ghid de automatizare fără cod
Conectați 7stamp la Zapier — pas cu pas
Ghid de implementareUtilizați Zapier atunci când fluxul dvs. de lucru este o secvență clară: apare un contact sau o comandă, 7stamp efectuează o acțiune, apoi un alt instrument de afaceri este actualizat. Ruta sigură de astăzi este API până la Zapier pentru apelurile de ieșire 7stamp API și Webhooks by Zapier → Catch Hook pentru evenimentele de intrare 7stamp.
Nu există nicio aplicație publică 7stamp pe piața lui Zapier. Folosiți API by Zapier → API Request acolo unde este disponibil: stochează o cheie statică API în conexiunea aplicației în loc să o expună într-un pas Zap. Folosiți Webhooks by Zapier numai pentru evenimentele de intrare Catch Hook; nu puneți o cheie 7stamp Bearer într-un câmp de acțiune Webhooks vizibil.
Începeți cu un Zap liniar, testabil
Păstrați primul Zap mic. Un flux de încredere contact-to-card sau de comandă plătită-la-ștampile este un punct de plecare mai bun decât o sincronizare amplă bidirecțională CRM.
Adăugați ștampile după finalizare
Declanșați din comanda plătită sau chitanța închisă, mapați identitatea clientului și comanda ID, apoi utilizați Scan Card cu suma comenzii sau numărul explicit de ștampile.
Emiteți un voucher de recuperare unic
Utilizați o regulă CRM, un eveniment de asistență sau un export de segment pentru a identifica un client, pentru a emite un voucher pe cardul său și pentru a trimite un mesaj de urmărire de pe canalul corect.
Scrieți evenimentele cardului înapoi pe CRM
Folosiți Webhooks by Zapier > Catch Hook pentru a primi evenimentele cardului 7stamp. Potriviți External ID returnat cu înregistrarea CRM și adăugați nota, eticheta sau sarcina corespunzătoare.
7stamp operațiuni de apelat de la API până la Zapier
Adăugați API by Zapier → API Request după declanșare. Creați o conexiune cu cheia 7stamp API, apoi selectați metoda exactă și URL complet de mai jos. Fiecare operațiune returnează câmpuri pe care le puteți mapa în următorul pas Zap.
API prin acțiunea Zapier
POST /cards/invite Creați Card Invite
Creează o nouă instalare a unui card de portofel URL și un cod de livrare pentru un contact extern.
- Necesar
- external_id de la declanșatorul CRM/contact.
- Următorul pas
- Hartați install_url în e-mail, SMS sau un câmp CRM.
API prin acțiunea Zapier
POST /cards/invite/bulk Creați în bloc Card Invites
Creează până la 100 de link-uri de invitație dintr-un lot controlat JSON.
- Required
- matrice de elemente obligatorii cu 1–100 de obiecte de invitație.
- Verificați
- Citiți success_count, error_count și fiecare rezultat înainte de livrare.
API prin Zapier acțiune
POST /cards/scan Scan Card
Adaugă ștampile cu User Card ID, cu User Card ID, cu User Card ID, cu 28, număr de ștampile sau 28 ID și date opționale de chitanță.
- Identitate
- external_id plus opțional external_source; user_card_id câștigă dacă ambii sunt prezenți.
- Regula de timbru
- stamps_count are prioritate față de sumă.
API prin acțiunea Zapier
POST /vouchers/issue Issue Voucher
Emite un voucher direct unui proprietar de card.
- Necesar voucher
- .short_description și o țintă external_id sau cunoscută user_card_id.
- Rezultat
- Hartă unique_code, stare sau expires_at la o notă sau mesaj CRM.
API prin Zapier acțiune
POST /messages/send Send Message
Trimite conținut push-carte de portofel și e-mail proprietarului unui card/or.
- Card push
- card_push_text este limitat la 20 de caractere.
- subiect plus corp; rezultatul raportează dacă livrarea a fost pusă în coadă.
API prin Zapier acțiune
GET /cards Find Cards
Găsește înregistrările cardului prin External ID sursă și șabloane opționale, cu filtre.
- Necesar
- external_id ca parametru de interogare.
- Utilizați mai întâi
- Folosiți înainte de a crea o invitație atunci când regula dvs. evită invitațiile duplicate.
API prin Zapier acțiune
GET /cards/{user_card_id} Obține detalii card
Reads the state of a card by its 7stamp internal ID.
- Obligatoriu
- Înlocuiți {user_card_id} cu un ID returnat de 7stamp.
- Ieșire utilă
- stamps_count, starea portofelului și active_vouchers_count.
API prin acțiunea Zapier
GET /templates List Templates
Listează șabloanele disponibile pentru profilul conectat și verifică conexiunea ⟦1832.
- Primul test
- Apelați-l înainte de orice acțiune de scriere: nu modifică datele clientului.
- Utilizați mai târziu
- Un ID activ devine template_id atunci când există mai multe șabloane.
API prin Zapier acțiune
GET /templates/{template_id}/design Get Template Design
Retrieves a template's design settings for a known template ID.
Zapier declanșatorul
Webhooks by Zapier → Catch Hook Primirea evenimentelor cardului
Catch Hook dă Zapier un Zapier unic URL18⟧3. Lipiți-l în setările webhook-ului 7stamp Admin și testați-l cu un eveniment de card real.
- În Zapier
- Utilizați Catch Hook pentru datele despre evenimentele analizate; utilizați Catch Raw Hook numai atunci când aveți nevoie și de anteturi de solicitare brute/body.
- Potrivire
- Găsiți contactul CRM folosind external_id și opțional de la evenimentul ⟦18.
Trei Zapier fluxuri de lucru pe care le puteți crea pas cu pas
Fiecare scenariu folosește un modul Zapier real, disponibil în prezent. Construiți mai întâi un traseu mic și testați-l cu un contact de unică folosință înainte de a porni Zap-ul.
1. Contact calificat CRM → emite un card
Rezultat așteptat: Următorul pas Zap primește install_url și îl poate trimite clientului sau îl poate scrie înapoi în înregistrarea CRM.
- 1 Creați un Zap și selectați evenimentul CRM, ceea ce înseamnă că un contact este eligibil pentru loialitate. Testați declanșatorul și confirmați că aveți contactul imuabil ID.
- 2 Adăugați API by Zapier → API Request. Creați sau selectați conexiunea cu cheia 7stamp API, alegeți POST și setați URL la https://api.7loc.com/cards-api/cards/invite.
- 3 Setați corpul la JSON. Mapați CRM ID în external_id, setați un external_source fix, cum ar fi kommo, și adăugați template_id numai atunci când sunt activi mai mult de un șablon 7stamp.
- 4 Testați acțiunea. Confirmați că răspunsul conține install_url și delivery_insert_code pentru același external_id.
- 5 Adăugați acțiunea dvs. CRM Actualizare, e-mail sau SMS. Harta install_url din răspunsul API; nu codificați sau copiați un test URL.
Verificați: Creați Card Invite returnează întotdeauna o nouă invitație. Adăugați mai întâi o solicitare Find Cards sau un Zapier Filtrați dacă politica dvs. este o invitație pentru fiecare contact.
2. Comanda plătită → timbre de premiu
Rezultat așteptat: Comanda creează o scanare 7stamp urmăribilă, iar Zap poate înregistra stamps_added sau scan_id în sistemul sursă.
- 1 Utilizați o comandă plătită/Closed Declanșator de primire și testați-o. Confirmați că clientul ID și comanda unică ID sunt ambele prezente înainte de a continua.
- 2 Adăugați API by Zapier → API Request cu POST https://api.7loc.com/cards-api/cards/scan și selectați aceeași conexiune 7stamp.
- 3 Trimiteți JSON cu external_id, external_source, external_order_id și fie o sumă pentru șabloane bazate pe sumă, fie stamps_count pentru un acord explicit de timbru.
- 4 Testați cu o comandă de unică folosință. Inspectați succesul, scan_id și stamps_added în răspuns.
- 5 Adăugați un filtru care continuă numai după un răspuns de succes, apoi actualizați comanda/CRM cu rezultatul confirmat.
Verificați: Dacă Zap este reluat, verificați comanda originală înainte de a trimite o altă scanare. Păstrați external_order_id stabil, astfel încât evenimentul să poată fi reconciliat mai târziu.
3. 7stamp eveniment → creați o notă sau sarcină CRM
Rezultat așteptat: Zapier receives a parsed 7stamp event, finds the customer by external_id, and creates the appropriate follow-up.
- 1 Creați un nou Zap cu Webhooks by Zapier ca declanșator. Selectați Catch Hook, continuați și copiați URL unic afișat în pasul Test.
- 2 În 7stamp Admin, deschideți API & Integrations → Webhooks, adăugați Catch Hook URL, selectați numai tipurile de evenimente necesare și salvați.
- 3 Provoacă o scanare de test reală sau un eveniment de card. Înapoi în Zapier, faceți clic pe Test trigger și confirmați event_type, external_id și external_source ajung ca câmpuri eșantion.
- 4 Adăugați o acțiune CRM Găsiți Contact folosind external_id. Adăugați o regulă Filtru sau Căi pentru event_type, de exemplu, separați SCAN de REWARD_EARNED.
- 5 Creați o notă CRM/task și mapați numai câmpurile care există pentru acel eveniment, cum ar fi scanned_at, stamps_after, external_order_id sau external_order_id18.
Verificați: A Catch Hook URL este un secret. Dacă Zap este transferat unui alt proprietar, actualizați URL în 7stamp Admin înainte de a vă baza pe el.
Creați cheia 7stamp API înainte de a construi Zap
Aceștia sunt pașii laterali 7stamp. Faceți acest lucru o dată, apoi utilizați cheia numai în interiorul conexiunii API până la Zapier — nu într-un câmp de acțiune Webhooks by Zapier sau o notă.
Reguli de conectare care previn nepotrivirile datelor
Păstrați cheia API într-o conexiune API cu Zapier
In 7stamp Admin, choose API & Integrations → API Keys → Add API Key. In API by Zapier, create an API-key connection with a static Authorization header containing Bearer followed by that key. API by Zapier keeps the credential in the connection instead of a visible Zap step; restrict access to the connection and rotate the key if it is exposed.
Harta External ID și External Source în mod constant
External ID este propriul dvs. identificator stabil de client; External Source etichete de unde provine, de exemplu hubspot, bitrix24, shopify sau poster. Utilizați aceeași pereche pentru a crea, găsi, scana, voucher și fluxuri webhook.
Aflați ce identificator de card câștigă
Acțiunile de direcționare prin card acceptă User Card ID sau External ID. Când ambele sunt prezente, User Card ID are prioritate. Utilizați ID intern numai după ce a fost returnat printr-un pas de încredere 7stamp; altfel preferați sistemul sursă External ID.
Exact API prin Zapier cerere: acordați o ștampilă
Copiați acest lucru în pasul dvs. de automatizare
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"
}Construiți-vă primul Zap
Creați o cheie 7stamp API în Admin.: 1846⟦ Folosiți o cheie de test separată/profile atunci când este disponibilă.
În Zapier, creați un Zap și testați declanșatorul sursei. Utilizați o mostră reală, astfel încât contactul ID, clientul ID, comanda ID și suma să fie disponibile pentru cartografiere.
Adăugați API by Zapier → API Request. Creați o conexiune 7stamp pentru antetul Bearer Authorization static, în loc să puneți secretul într-un câmp de acțiune Webhooks by Zapier.
Sunați mai întâi la GET https://api.7loc.com/cards-api/templates. Acest lucru confirmă funcționarea cheii și arată ce ID-uri de șablon active sunt disponibile fără a modifica datele clienților.
Selectați POST /cards/invite sau POST /cards/scan, setați JSON ca tip de corp și mapați stabilul POST External ID șablonul relevant POST⟧ declanșatorul.
Rulați acțiunea cu un contact de unică folosință, inspectați-i câmpurile exacte de răspuns, apoi mapați acele câmpuri în următorul pas CRM, e-mail sau mesagerie înainte de a publica Zap.
Utilizați cererea universală numai pentru rutele documentate
Folosiți API până la Zapier pentru o solicitare 7stamp cu o Bearer ⟧ ține Bearer ⟦ ține o aplicație ⟦18501 cheie statică: conexiune. Utilizați Webhooks by Zapier pentru livrarea unui eveniment Catch Hook, nu ca locație preferată pentru un secret 7stamp. Păstrați baza URL la https://api.7loc.com/cards-api, folosiți referința publică OpenAPI pentru scheme exacte și nu trimiteți niciodată acreditări sau date despre clienți unui URL neverificat.
Primiți 7stamp evenimente prin Catch Hook
Creați Webhooks by Zapier → Catch Hook, copiați URL unic afișat în configurația de testare, inserați-l în profilul web hooks7stamp setări, selectați tipurile de evenimente și apoi trimiteți o scanare de test reală sau un eveniment de card. Utilizați încărcătura utilă a evenimentului External ID și External Source pentru a localiza persoana de contact potrivită CRM. Alegeți Catch Raw Hook numai atunci când aveți nevoie în mod specific de corpul neanalizat și anteturile de solicitare.
Folosiți ruta sigură Zapier acum
API până la Zapier și Catch Hook sunt suficiente pentru fiecare Catch Hook de operare publică. Dacă aveți nevoie de o viitoare aplicație nativă 7stamp Zapier, trimite-ne acțiunea exactă/trigger pe care echipa ta o folosește cel mai mult.
Întrebări frecvente
Unde pot găsi aplicația 7stamp în Zapier?
Nu există nicio aplicație publică de piață 7stamp astăzi. Folosiți API by Zapier → API Request pentru apelurile 7stamp API și Webhooks by Zapier → Catch Hook pentru evenimentele 7stamp primite.
Unde creez jetonul Zapier?
Creați o cheie 7stamp API în Admin sub API & Integrations → API Keys → Add API Key. Stocați-l ca antet static Bearer Authorization în conexiunea API cu Zapier, nu într-un câmp de acțiune vizibil Webhooks by Zapier.
Cum poate Zapier să primească un eveniment de ștampilă sau voucher?
Creați un Catch Hook în Webhooks by Zapier, inserați URL generat în setările de webhook ale profilului 7stamp, selectați evenimentele și trimiteți un eveniment de testare înainte de a activa actualizările CRM.
Ar trebui să aleg Zapier sau Make?
Alegeți Zapier pentru un flux de lucru cu acțiune de declanșare în mare parte liniară. Alegeți Make atunci când aveți nevoie de routere, transformări complexe sau scenarii lungi cu mai multe ramuri. Ambele folosesc aceeași cheie 7stamp API și puncte finale.
Următorul pas
Construiește primul Zap cu un contact de testare
Creați cheia API, testați GET /templates până la API până la Zapier, apoi creați o acțiune de contact la card sau de comandă la ștampile. Adăugați Catch Hook odată ce fluxul de ieșire are un rezultat de testare dovedit.