Guia d'automatització sense codi

Connecteu 7stamp a Zapier — pas a pas

Guia d'implementació

Utilitzeu

There is no public 7stamp app in Zapier's marketplace. Use API by Zapier → API Request where available: it stores a static API key in the app connection instead of exposing it in a Zap step. Use Webhooks by Zapier only for incoming Catch Hook events; do not put a 7stamp Bearer key into a visible Webhooks action field.

Comença amb un Zap lineal i comprovable

Mantingueu el primer Zap petit. Un flux fiable de contacte a targeta o de comanda de pagament a segells és un millor punt de partida que una sincronització bidireccional àmplia CRM.

Creeu una invitació d'un contacte CRM

Activeu un contacte nou o qualificat, assigneu-ne CRM ID a External ID, creeu un correu electrònic de retorn de la invitació i ⟦ d'instal·lació ⟦ o pas SMS.

Afegiu segells després de la compra

Activar a partir de la comanda pagada o el rebut tancat, assigneu la identitat del client i la comanda ID i, a continuació, utilitzeu Scan Card amb l'import de la comanda o el nombre explícit de segells.

Emetre un val de recuperació únic

Utilitzeu una regla CRM, un esdeveniment d'assistència o una exportació de segments per identificar un client, emetre un val a la seva targeta i enviar un missatge de seguiment des del canal correcte.

Torneu a escriure els esdeveniments de la targeta al vostre CRM

Utilitzeu Webhooks by Zapier > Catch Hook per rebre els esdeveniments de la targeta 7stamp. Relaciona el External ID retornat amb el registre CRM i afegiu la nota, l'etiqueta o la tasca corresponent.

7stamp operacions per trucar des del API per Zapier

Afegeix API by Zapier → API Request després del disparador. Creeu una connexió de clau 7stamp API i, a continuació, seleccioneu el mètode exacte i URL complet a continuació. Cada operació retorna camps que podeu assignar al següent pas de Zap.

API per acció Zapier POST /cards/invite

Crea Card Invite

Crea una nova instal·lació de la targeta de cartera URL i un codi de lliurament per a un contacte extern.

Obligatori
external_id des del disparador CRM/contact.
Següent pas
Assigna install_url al correu electrònic, SMS o un camp CRM.
API per acció Zapier POST /cards/invite/bulk

Creació massiva Card Invites

Crea fins a 100 enllaços d'invitació a partir d'un lot controlat JSON.

Matriu d'elements
obligatori amb 1–100 objectes d'invitació.
Comproveu
Llegiu success_count, error_count i tots els resultats abans del lliurament.
API per Zapier acció POST /cards/scan

Scan Card

Afegeix segells per User Card ID o User Card ID amb User Card ID, amb quantitat, segell, ⟦58, 60, comanda ID i dades de rebut opcionals.

Identitat
external_id més opcional external_source; user_card_id guanya si tots dos estan presents.
La regla del segell
stamps_count té prioritat sobre l'import.
API mitjançant l'acció Zapier POST /vouchers/issue

Issue Voucher

Emet un val directament al propietari d'una targeta.

Val
obligatori.short_description i un objectiu external_id o conegut user_card_id.
Resultat
Mapa unique_code, estat o expires_at a una nota o missatge CRM.
API mitjançant l'acció Zapier POST /messages/send

Send Message

Envia el contingut d'una targeta de cartera i un correu electrònic al propietari de la targeta /or.

La carta push
card_push_text està limitada a 20 caràcters.
Correu electrònic
assumpte més cos; el resultat informa si el lliurament estava en cua.
API per Zapier acció GET /cards

Find Cards

Cerca els registres de la targeta per External ID, amb font i plantilla opcionals.

Necessari
external_id com a paràmetre de consulta.
Feu servir primer
Feu servir abans de crear una invitació quan la vostra regla eviti les invitacions duplicades.
API per Zapier acció GET /cards/{user_card_id}

Obtenir el detall de la targeta

Llegeix l'estat d'una targeta per la seva 7stamp interna ID.

Obligatori
Substituïu {user_card_id} per un ID retornat per 7stamp.
Sortida útil
stamps_count, estat de la cartera i active_vouchers_count.
API per Zapier acció GET /templates

List Templates

Llista les plantilles disponibles per al perfil connectat i verifica la connexió ⟦5897.

Primera prova
Truqueu-la abans de qualsevol acció d'escriptura: no canvia cap dada del client.
Fes servir més tard
Un identificador actiu es converteix en template_id quan existeixen diverses plantilles.
API per Zapier acció GET /templates/{template_id}/design

Get Template Design

Recupera la configuració de disseny d'una plantilla per a una plantilla coneguda ⟦5902 ⟦5902

Zapier activador Webhooks by Zapier → Catch Hook

Rebre esdeveniments de la targeta

Catch Hook dóna a Zapier un HTTPS ⟦5908URL Enganxeu-lo a la configuració del webhook de 7stamp Admin i proveu-lo amb un esdeveniment de targeta real.

A Zapier
Utilitzeu Catch Hook per a les dades d'esdeveniments analitzats; utilitzeu Catch Raw Hook només quan també necessiteu capçaleres de sol·licitud en brut/body.
Coincidència
Trobeu el contacte CRM mitjançant external_id i opcional ⟦5915 de l'esdeveniment.

Tres Zapier fluxos de treball que podeu crear pas a pas

Cada escenari utilitza un mòdul Zapier real i disponible actualment. Construeix primer una petita ruta i prova-la amb un contacte d'un sol ús abans d'encendre el Zap.

1. Contacte qualificat CRM → emetre una targeta

Resultat esperat: El següent pas Zap rep install_url i pot enviar-lo al client o escriure-lo de nou al registre CRM.

  1. 1 Creeu un Zap i seleccioneu l'esdeveniment CRM que significa que un contacte és apte per a la fidelitat. Proveu el disparador i confirmeu que teniu l'immutable ID del contacte.
  2. 2 Afegeix API by Zapier → API Request. Creeu o seleccioneu la connexió de la clau 7stamp API, trieu POST i configureu URL a https://api.7loc.com/cards-api/cards/invite.
  3. 3 Estableix el cos a JSON. Assigna el CRM ID a external_id, defineix un external_source fix com ara kommo i afegiu template_id només quan hi hagi més d'una plantilla 7stamp activa.
  4. 4 Prova l'acció. Confirmeu que la resposta contingui install_url i delivery_insert_code per al mateix external_id.
  5. 5 Afegiu la vostra actualització, correu electrònic o SMS CRM. Mapa install_url de la resposta API; no codifiqueu ni copieu una prova URL.

Comproveu: Crea Card Invite sempre retorna una invitació nova. Afegiu primer una sol·licitud Find Cards o un filtre Zapier si la vostra política és una invitació per contacte.

2. Comanda pagada → segells de premi

Resultat esperat: La comanda crea un escaneig traçable 7stamp i el Zap pot registrar stamps_added o scan_id al sistema d'origen.

  1. 1 Utilitzeu una comanda de pagament/Closed Activador de rebut i proveu-lo. Confirmeu que el client ID i la comanda única ID estan presents abans de continuar.
  2. 2 Afegiu API by Zapier → API Request amb POST https://api.7loc.com/cards-api/cards/scan i seleccioneu la mateixa connexió 7stamp.
  3. 3 Envieu JSON amb external_id, external_source, external_order_id i l'import per a les plantilles basades en quantitats o stamps_count per a un segell explícit.
  4. 4 Prova amb una comanda d'un sol ús. Inspeccioneu l'èxit, scan_id i stamps_added a la resposta.
  5. 5 Afegiu un filtre que només continuï després d'una resposta correcta i, a continuació, actualitzeu la comanda/CRM amb el resultat confirmat.

Comproveu: Si es torna a reproduir el Zap, comproveu l'ordre original abans d'enviar un altre escaneig. Manteniu external_order_id estable perquè l'esdeveniment es pugui conciliar més tard.

3. 7stamp esdeveniment → crea una nota o tasca CRM

Resultat esperat: Zapier rep un esdeveniment 7stamp analitzat, troba el client ⟦6000 i fa un seguiment ⟦6000 adequat.

  1. 1 Crea un nou Zap amb Webhooks by Zapier com a activador. Seleccioneu Catch Hook, continueu i copieu l'únic URL que es mostra al pas de prova.
  2. 2 A 7stamp Admin, obriu API & Integrations → Webhooks, afegiu el Catch Hook URL, seleccioneu només els tipus d'esdeveniment necessaris i deseu.
  3. 3 Provoca una exploració de prova real o un esdeveniment de targeta. De tornada a Zapier, feu clic a Test trigger i confirmeu que event_type, external_id i external_source arriben com a camps de mostra.
  4. 4 Afegiu un CRM Trobar l'acció de contacte amb external_id. Afegiu una regla de filtre o camins per a event_type, per exemple, separeu SCAN de REWARD_EARNED.
  5. 5 Creeu una nota CRM/task i mapeu només els camps que existeixen per a aquest esdeveniment, com ara scanned_at, stamps_after, external_order_id o issued_vouchers.

Comproveu: A Catch Hook URL és un secret. Si el Zap es transfereix a un altre propietari, actualitzeu el URL a 7stamp Admin abans de confiar-hi.

Creeu la clau 7stamp API abans de construir el Zap

Aquests són els passos laterals 7stamp. Feu-ho una vegada i, a continuació, feu servir la clau només dins de la connexió API per Zapier, no en un camp d'acció Webhooks by Zapier o una nota.

7stamp Admin API i pantalla d'integracions amb l'acció Add API Key
Obre API i integracions, trieu API Keys i, a continuació, permet crear el vostre compte separat per configurar-lo.
Clau 7stamp API recent generada a punt per ser copiada
Copieu la clau a la connexió segura API per Zapier, no en un pas de Webhooks de text sense format o un document compartit.

Regles de connexió que eviten les discrepàncies de dades

Mantingueu la clau API en una connexió API per Zapier

A 7stamp Admin, trieu ⟦5919 A API per Zapier, creeu una connexió de clau API amb una capçalera Authorization estàtica que contingui Bearer seguida d'aquesta clau. API per Zapier manté la credencial a la connexió en lloc d'un pas Zap visible; restringeix l'accés a la connexió i gira la clau si està exposada.

El mapa External ID i External Source de manera coherent

External ID és el vostre propi identificador de client estable; External Source etiquetes d'on prové, per exemple, hubspot, bitrix24, shopify o pòster. Utilitzeu el mateix parell per crear, trobar, escanejar, vals i fluxos de webhook.

Saber quin identificador de targeta guanya

Les accions d'orientació per targeta accepten User Card ID o External ID. Quan tots dos estan presents, User Card ID té prioritat. Utilitzeu el ID intern només després que hagi estat retornat per un pas 7stamp de confiança; en cas contrari preferiu el sistema font External ID.

Sol·licitud exacta API per Zapier: concediu un segell

Copieu-ho al vostre pas d'automatització 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"
}

Creeu el vostre primer Zap

01

Creeu una clau 7stamp API a Administrador: ⟦6034. Utilitzeu una clau de prova independent/profile quan estigui disponible.

02

A Zapier, creeu un Zap i proveu l'activador de la font. Utilitzeu una mostra real perquè el contacte ID, el client ID, la comanda ID i la quantitat estiguin disponibles per al mapeig.

03

Afegeix API by Zapier → API Request. Creeu una connexió 7stamp per a la capçalera estàtica Bearer Authorization en lloc de posar el secret en un camp d'acció Webhooks by Zapier.

04

Truqueu primer al GET https://api.7loc.com/cards-api/templates. Això confirma que la clau funciona i mostra quins ID de plantilla actives estan disponibles sense modificar les dades del client.

05

Seleccioneu POST /cards/invite o POST /cards/scan, establiu JSON com a tipus de cos i mapeu l'activador estable External ID més el camp 60 de la plantilla54⟦ rellevant.

06

Executeu l'acció amb un contacte d'un sol ús, inspeccioneu els seus camps de resposta exactes i, a continuació, assigneu aquests camps al següent pas CRM, correu electrònic o missatge abans de publicar el Zap.

Utilitzeu la sol·licitud universal només per a rutes documentades

Utilitzeu API per Zapier per a una sol·licitud 7stamp amb una Bearer Bearer Bearer API clau estàtica de connexió: manté una clau de connexió estàtica. Utilitzeu Webhooks by Zapier per al lliurament d'esdeveniments Catch Hook, no com a ubicació preferida per a un secret 7stamp. Mantingueu la base URL a https://api.7loc.com/cards-api, utilitzeu la referència pública OpenAPI per obtenir esquemes exactes i mai no envieu credencials ni dades de client a un URL no verificat.

Rebeu 7stamp esdeveniments mitjançant Catch Hook

Creeu Webhooks by Zapier → Catch Hook, copieu l'únic URL que es mostra a la configuració de prova, enganxeu-lo al perfil ⟦6060606, enganxeu-lo al perfil ⟦6060606. tipus i, a continuació, envieu una exploració de prova real o un esdeveniment de targeta. Utilitzeu la càrrega útil de l'esdeveniment External ID i External Source per localitzar el contacte CRM correcte. Trieu Catch Raw Hook només quan necessiteu específicament el cos no analitzat i les capçaleres de sol·licitud.

Utilitzeu ara la ruta segura Zapier

API per Zapier i Catch Hook són suficients per a qualsevol operació i esdeveniment públic 7stamp API. Si necessiteu una futura aplicació nativa 7stamp Zapier, envieu-nos l'acció exacta/trigger que més utilitza el vostre equip.

Pregunta sobre un connector natiu

Preguntes freqüents

On puc trobar l'aplicació 7stamp a Zapier?

Avui no hi ha cap aplicació pública del mercat 7stamp. Utilitzeu API by Zapier → API Request per a trucades 7stamp API i Webhooks by Zapier → Catch Hook per a esdeveniments 7stamp entrants.

On puc crear el testimoni Zapier?

Creeu una clau 7stamp API a Administrador a API & Integrations → API Keys → Add API Key. Emmagatzemeu-lo com a capçalera estàtica Bearer Authorization a la connexió API per Zapier, no en un camp d'acció Webhooks by Zapier visible.

Com pot Zapier rebre un esdeveniment de segell o val?

Creeu un Catch Hook a Webhooks by Zapier, enganxeu el URL generat a la configuració del webhook del perfil 7stamp, seleccioneu els esdeveniments i envieu un esdeveniment de prova abans d'activar les actualitzacions de CRM.

He de triar Zapier o Make?

Trieu Zapier per obtenir un flux de treball d'acció d'activació principalment lineal. Trieu Make quan necessiteu encaminadors, transformacions complexes o escenaris llargs de diverses branques. Tots dos utilitzen la mateixa clau 7stamp API i els mateixos punts finals.

Següent pas

Construeix el primer Zap amb un contacte de prova

Creeu la clau API, proveu GET /templates a API per Zapier i, a continuació, creeu una acció de contacte a targeta o de comanda a segells. Afegiu el Catch Hook un cop el flux de sortida tingui un resultat de prova provat.