Utwórz zaproszenie od kontaktu CRM
Uruchom nowy lub kwalifikowany kontakt, zmapuj jego CRM ID na External ID, utwórz zaproszenie na kartę i przekaż zwróconą instalację URL na e-mail lub Krok SMS.
Przewodnik po automatyzacji bez kodu
Połącz 7stamp z Zapier — krok po kroku
Przewodnik po wdrażaniuUżyj Zapier, gdy przepływ pracy jest przejrzystą sekwencją: pojawia się kontakt lub zamówienie, 7stamp wykonuje akcję, po czym aktualizowane jest kolejne narzędzie biznesowe. Bezpieczna trasa na dzień dzisiejszy to API do Zapier dla połączeń wychodzących 7stamp API i Webhooks by Zapier → Catch Hook dla przychodzących wydarzeń 7stamp.
Na rynku Zapier nie ma publicznej aplikacji 7stamp. Użyj API by Zapier → API Request, jeśli jest dostępny: przechowuje statyczny klucz API w połączeniu z aplikacją zamiast ujawniać go w kroku Zap. Używaj Webhooks by Zapier tylko dla nadchodzących wydarzeń Catch Hook; nie umieszczaj klucza 7stamp Bearer w widocznym polu akcji webhooka.
Zacznij od liniowego, testowalnego Zapa
Niech pierwszy Zap będzie mały. Niezawodny przepływ od kontaktu do karty lub od płatnego zamówienia do znaczków jest lepszym punktem wyjścia niż szeroka dwukierunkowa synchronizacja CRM.
Dodaj znaczki po kasie
Wywołaj opłacone zamówienie lub zamknięty paragon, zmapuj tożsamość klienta i zamów ID, następnie użyj Scan Card z kwotą zamówienia lub jawną liczbą znaczków.
Wydaj jednorazowy kupon naprawczy
Użyj reguły CRM, zdarzenia wsparcia lub eksportu segmentów, aby zidentyfikować klienta, wystawić kupon na jego kartę i wysłać wiadomość uzupełniającą z odpowiedniego kanału.
Zapisuj zdarzenia z karty z powrotem do CRM
Użyj Webhooks by Zapier > Catch Hook, aby otrzymywać zdarzenia z karty 7stamp. Dopasuj zwrócony External ID do rekordu CRM i dodaj odpowiednią notatkę, znacznik lub zadanie.
7stamp operacje, aby zadzwonić z API przez Zapier
Dodaj API by Zapier → API Request po swoim spust. Utwórz jedno połączenie z kluczem 7stamp API, następnie wybierz dokładną metodę i pełne URL poniżej. Każda operacja zwraca pola, które można zmapować w następnym kroku Zap.
API przez akcję Zapier
POST /cards/invite Utwórz Card Invite
Tworzy nową instalację karty portfela URL i kod wstawienia dostawy dla jednego kontaktu zewnętrznego.
- Wymagane
- external_id z wyzwalacza CRM/contact.
- Następny krok
- Zamapuj install_url na e-mail, SMS lub pole CRM.
API przez akcję Zapier
POST /cards/invite/bulk Utwórz zbiorczo Card Invites
Tworzy do 100 linków z zaproszeniem z kontrolowanej partii JSON.
- Wymagana tablica elementów
- zawierająca 1–100 obiektów zaproszonych.
- Sprawdź
- Przeczytaj success_count, error_count i każdy wynik przed dostawą.
API przez akcję Zapier
POST /cards/scan Scan Card
Dodaje znaczki o User Card ID lub External ID, z kwotą, liczbą znaczków, kolejnością ID i opcjonalne dane paragonu.
- Tożsamość
- external_id plus opcjonalnie external_source; user_card_id wygrywa, jeśli oba są obecne.
- Reguła stempla
- stamps_count ma pierwszeństwo przed kwotą.
API przez akcję Zapier
POST /vouchers/issue Issue Voucher
Wydaje voucher bezpośrednio właścicielowi karty.
- Wymagany kupon
- .short_description i cel external_id lub znany user_card_id.
- Wynik
- Mapa unique_code, status lub expires_at do CRM notatki lub wiadomości.
API przez akcję Zapier
POST /messages/send Send Message
Wysyła push-kartę do portfela i /or zawartość e-maila do właściciela karty.
- Naciśnięcie karty
- card_push_text jest ograniczone do 20 znaków.
- temat i treść; wynik informuje, czy dostawa była w kolejce.
API przez Zapier akcja
GET /cards Find Cards
Wyszukuje rekordy kart według External ID, z opcjonalnymi filtrami źródła i szablonu.
- Wymagane
- external_id jako parametr zapytania.
- Użyj najpierw
- Użyj przed utworzeniem zaproszenia, jeśli Twoja reguła zapobiega duplikowaniu zaproszeń.
API poprzez akcję Zapier
GET /cards/{user_card_id} Pobierz szczegóły karty
Odczytuje stan karty na podstawie jej 7stamp wewnętrznego ID.
- Wymagane
- Zamień {user_card_id} na ID zwrócone przez 7stamp.
- Przydatne dane wyjściowe
- stamps_count, stan portfela i active_vouchers_count.
API przez akcję Zapier
GET /templates List Templates
Wyświetla listę szablonów dostępnych dla połączonego profilu i weryfikuje połączenie API.
- Pierwszy test
- Wywołaj go przed jakąkolwiek czynnością zapisu: nie zmienia to żadnych danych klienta.
- Użyj później
- Aktywny identyfikator staje się template_id, gdy istnieje wiele szablonów.
API przez akcję Zapier
GET /templates/{template_id}/design Get Template Design
Pobiera ustawienia projektowe szablonu dla znanego szablonu ID.
Zapier wyzwalacz
Webhooks by Zapier → Catch Hook Odbierz zdarzenia karty
Catch Hook daje Zapier unikalny HTTPS URL. Wklej go do ustawień webhooka 7stamp Admin i przetestuj z prawdziwym zdarzeniem karcianym.
- In Zapier
- Użyj Catch Hook dla przeanalizowanych danych zdarzeń; użyj Catch Raw Hook tylko wtedy, gdy potrzebujesz także surowych nagłówków żądań/body.
- Dopasuj
- Znajdź kontakt CRM za pomocą external_id i opcjonalnie external_source z wydarzenia.
Trzy Zapier przepływy pracy, które możesz zbudować krok po kroku
Każdy scenariusz wykorzystuje realny, aktualnie dostępny moduł Zapier. Najpierw zbuduj jedną małą trasę i przetestuj ją za pomocą jednorazowego styku przed włączeniem Zapa.
1. Wykwalifikowany kontakt CRM → wystaw kartę
Oczekiwany wynik: Następny krok Zap otrzymuje install_url i może wysłać go do klienta lub odpisać do rekordu CRM.
- 1 Utwórz Zap i wybierz zdarzenie CRM oznaczające, że kontakt kwalifikuje się do programu lojalnościowego. Przetestuj wyzwalacz i potwierdź, że masz niezmienne ID kontaktu.
- 2 Dodaj API by Zapier → API Request. Utwórz lub wybierz połączenie klawisza 7stamp API, wybierz POST i ustaw URL na https://api.7loc.com/cards-api/cards/invite.
- 3 Ustaw treść na JSON. Zmapuj CRM ID na external_id, ustaw stałe external_source, takie jak kommo i dodaj template_id tylko wtedy, gdy aktywny jest więcej niż jeden szablon 7stamp.
- 4 Przetestuj działanie. Potwierdź, że odpowiedź zawiera install_url i delivery_insert_code dla tego samego external_id.
- 5 Dodaj swoją aktualizację CRM, e-mail lub akcję SMS. Mapa install_url z odpowiedzi API; nie koduj na stałe ani nie kopiuj testu URL.
Sprawdź: Utwórz Card Invite zawsze zwraca nowe zaproszenie. Dodaj prośbę Find Cards lub Zapier Najpierw przefiltruj, jeśli Twoja zasada przewiduje jedno zaproszenie na kontakt.
2. Zamówienie opłacone → znaczki premiowe
Oczekiwany wynik: Zamówienie tworzy identyfikowalny skan 7stamp, a Zap może zapisać stamps_added lub scan_id w systemie źródłowym.
- 1 Użyj zamówienia opłaconego/Closed Włącz wyzwalacz odbioru i przetestuj go. Zanim przejdziesz dalej, potwierdź obecność klienta ID i unikalnego zamówienia ID.
- 2 Dodaj API by Zapier → API Request z POST https://api.7loc.com/cards-api/cards/scan i wybierz to samo połączenie 7stamp.
- 3 Wyślij JSON z external_id, external_source, external_order_id i kwotę w przypadku szablonów opartych na kwocie lub stamps_count w przypadku wyraźnej nagrody znaczkowej.
- 4 Przetestuj za pomocą zamówienia jednorazowego. Sprawdź sukces, scan_id i stamps_added w odpowiedzi.
- 5 Dodaj filtr, który będzie kontynuowany dopiero po pomyślnej odpowiedzi, a następnie zaktualizuj zamówienie/CRM o potwierdzony wynik.
Sprawdź: Jeśli Zap zostanie odtworzony ponownie, sprawdź oryginalną kolejność przed wysłaniem kolejnego skanu. Zachowaj stabilność external_order_id, aby wydarzenie mogło zostać uzgodnione później.
3. 7stamp zdarzenie → utwórz notatkę lub zadanie CRM
Oczekiwany wynik: Zapier odbiera przeanalizowane zdarzenie 7stamp, znajduje klienta do external_id i tworzy odpowiednią kontynuację.
- 1 Utwórz nowego Zapa z Webhooks by Zapier jako wyzwalaczem. Wybierz Catch Hook, kontynuuj i skopiuj unikalny URL pokazany w kroku testowania.
- 2 W 7stamp Admin otwórz API & Integrations → Webhooks, dodaj Catch Hook URL, wybierz tylko potrzebne typy zdarzeń i zapisz.
- 3 Powoduje prawdziwy skan testowy lub zdarzenie karty. Wróć do Zapier, kliknij Test trigger i potwierdź, że event_type, external_id i external_source pojawiają się jako przykładowe pola.
- 4 Dodaj akcję CRM Znajdź kontakt za pomocą external_id. Dodaj regułę filtra lub ścieżki dla event_type, na przykład oddziel SCAN od REWARD_EARNED.
- 5 Utwórz notatkę CRM/task i zamapuj tylko pola, które istnieją dla tego zdarzenia, takie jak scanned_at, stamps_after, external_order_id lub issued_vouchers.
Sprawdź: Catch Hook URL to tajemnica. Jeśli Zap zostanie przekazany innemu właścicielowi, zaktualizuj URL w 7stamp Admin, zanim zaczniesz na nim polegać.
Utwórz klucz 7stamp API przed zbudowaniem Zapa
Są to kroki boczne 7stamp. Zrób to raz, a następnie użyj klawisza tylko wewnątrz połączenia API przez Zapier – a nie w polu akcji Webhooks by Zapier ani w notatce.
Reguły połączenia zapobiegające niezgodnościom danych
Zachowaj klucz API w API przez połączenie Zapier
W 7stamp Admin wybierz API & Integrations → API Keys → Add API Key. W API do Zapier utwórz połączenie z kluczem API ze statycznym nagłówkiem Authorization zawierającym Bearer, po którym następuje ten klucz. API przez Zapier utrzymuje poświadczenie w połączeniu zamiast widocznego kroku Zap; ogranicz dostęp do połączenia i obróć klucz, jeśli jest odsłonięty.
Mapa External ID i External Source konsekwentnie
External ID to Twój własny, stabilny identyfikator klienta; External Source etykiety, skąd pochodzi, na przykład hubspot, bitrix24, shopify lub plakat. Użyj tej samej pary do przepływów tworzenia, wyszukiwania, skanowania, kuponów i elementów webhook.
Dowiedz się, który identyfikator karty wygrywa
Działania ukierunkowane na karty akceptują User Card ID lub External ID. Gdy oba są obecne, priorytet ma User Card ID. Użyj wewnętrznego ID dopiero po zwróceniu go przez zaufany krok 7stamp; w przeciwnym razie preferuj system źródłowy External ID.
Dokładnie API przez Zapier prośba: przyznaj jeden znaczek
Skopiuj to do swojego kroku automatyzacji
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"
}Zbuduj swojego pierwszego Zapa
Utwórz klucz 7stamp API w Administracji: API & Integrations → API Keys → Add API Key. Użyj osobnego klucza testowego /profile, jeśli jest dostępny.
W Zapier utwórz Zap i przetestuj wyzwalacz źródłowy. Użyj prawdziwej próbki, aby kontakt ID, klient ID, zamówienie ID i kwota były dostępne do mapowania.
Dodaj API by Zapier → API Request. Utwórz połączenie 7stamp dla statycznego nagłówka Bearer Authorization zamiast umieszczać klucz tajny w polu akcji Webhooks by Zapier.
Najpierw zadzwoń pod numer GET https://api.7loc.com/cards-api/templates. Potwierdza to działanie klucza i pokazuje, które aktywne identyfikatory szablonów są dostępne bez modyfikowania danych klienta.
Wybierz POST /cards/invite lub POST /cards/scan, ustaw JSON jako typ treści i zmapuj stabilne pola External ID plus odpowiedni szablon /order z wyzwalacza.
Uruchom akcję z jednorazowym kontaktem, sprawdź dokładne pola odpowiedzi, a następnie przyporządkuj te pola do następnego kroku CRM, e-maila lub wiadomości przed opublikowaniem Zapa.
Użyj uniwersalnego żądania tylko dla udokumentowanych tras
Użyj API przez Zapier dla żądania 7stamp z kluczem Bearer API: przechowuje statyczne klucze nagłówka w połączeniu z aplikacją. Użyj Webhooks by Zapier do dostarczenia zdarzenia Catch Hook, a nie jako preferowanej lokalizacji dla sekretu 7stamp. Bazę URL przechowuj pod adresem https://api.7loc.com/cards-api,, korzystaj z publicznej referencji OpenAPI dla dokładnych schematów i nigdy nie wysyłaj danych uwierzytelniających ani danych klientów do niezweryfikowanego URL.
Odbierz 7stamp zdarzenia przez Catch Hook
Utwórz Webhooks by Zapier → Catch Hook, skopiuj unikalny URL pokazany w konfiguracji testu, wklej go do ustawień webhooka profilu 7stamp, wybierz typy zdarzeń, a następnie wyślij prawdziwy skan testowy lub zdarzenie karty. Użyj ładunku zdarzenia External ID i External Source, aby zlokalizować właściwy kontakt CRM. Wybierz Catch Raw Hook tylko wtedy, gdy szczególnie potrzebujesz nieprzeanalizowanej treści i nagłówków żądań.
Skorzystaj teraz z bezpiecznej trasy Zapier
API do Zapier i Catch Hook wystarczą dla każdej publicznej 7stamp API operacji i zdarzenia karty. Jeśli potrzebujesz przyszłej aplikacji natywnej 7stamp Zapier, wyślij nam dokładną akcję/trigger, z której Twój zespół najczęściej korzysta.
Często zadawane pytania
Gdzie mogę znaleźć aplikację 7stamp w Zapier?
Obecnie nie ma publicznej aplikacji na rynku 7stamp. Użyj API by Zapier → API Request dla połączeń 7stamp API i Webhooks by Zapier → Catch Hook dla przychodzących wydarzeń 7stamp.
Gdzie mogę utworzyć token Zapier?
Utwórz klucz 7stamp API w panelu administratora pod adresem API & Integrations → API Keys → Add API Key. Zapisz go jako statyczny nagłówek Bearer Authorization w połączeniu API przez Zapier, a nie w widocznym polu akcji Webhooks by Zapier.
Jak Zapier może otrzymać pieczątkę lub voucher na wydarzenie?
Utwórz Catch Hook w Webhooks by Zapier, wklej wygenerowany URL do ustawień webhooka profilu 7stamp, wybierz zdarzenia i wyślij zdarzenie testowe przed włączeniem aktualizacji CRM.
Czy powinienem wybrać Zapier czy Make?
Wybierz Zapier, aby uzyskać w większości liniowy przepływ pracy wyzwalacz-akcja. Wybierz Make, jeśli potrzebujesz routerów, złożonych transformacji lub długich scenariuszy obejmujących wiele oddziałów. Obydwa używają tego samego klucza i punktów końcowych 7stamp API.
Następny krok
Zbuduj pierwszego Zapa z kontaktem testowym
Utwórz klucz API, przetestuj GET /templates do API do Zapier, a następnie utwórz jedną akcję kontaktu z kartą lub zamówienia z pieczątkami. Dodaj Catch Hook, gdy przepływ wychodzący uzyska potwierdzone wyniki testu.