Utwórz kartę po nowym kontakcie CRM
Użyj kontaktu CRM ID jako External ID, utwórz zaproszenie do karty 7stamp, a następnie wyślij zwróconą instalację URL w zwykły sposób e-mail, SMS lub etap wysyłania wiadomości.
Przewodnik po automatyzacji bez kodu
Połącz 7stamp z Make — krok po kroku
Przewodnik po implementacjiUżyj Make, aby połączyć 7stamp z CRM, POS, sklepem internetowym, arkuszem kalkulacyjnym, narzędziem do przesyłania wiadomości lub dowolnym systemem, który może wysyłać dane do scenariusza. Dzisiejsza trasa gotowa do produkcji to aplikacja Make HTTP dla połączeń 7stamp API i Make Custom webhook dla przychodzących wydarzeń 7stamp.
W selektorze aplikacji Make nie ma jeszcze publicznej aplikacji 7stamp. Nie czekaj na jeden: dodaj HTTP → Make a request, użyj dokładnej metody URL, nagłówka Bearer i JSON poniżej, a następnie zmapuj pola z modułu źródłowego. To jest to samo 7stamp Integration API, którego będzie używać przyszłe złącze.
Wybierz pierwszy scenariusz pasujący do Twojego przepływu pracy
Zacznij od jednego zdarzenia i jednego wyniku. Gdy dane testowe będą prawidłowe, dodaj filtry, routery, aktualizacje CRM i kolejne komunikaty.
Dodaj znaczki po opłaconym zamówieniu
Uruchom scenariusz z opłaconego zamówienia POS lub e-commerce. Zamapuj swojego stałego klienta ID i zamów ID w Zeskanuj kartę, a następnie podaj kwotę lub wyraźną liczbę znaczków.
Wyślij informację o nagrodzie
Gdy zdarzenie związane z kartą zgłasza nagrodę lub kupon, rozgałęzij scenariusz: zaktualizuj CRM, powiadom zespół i wyślij wiadomość push lub e-mail z portfelem tylko wtedy, gdy będzie to konieczne.
Obsługa systemu bez natywnej aplikacji Make
Użyj modułu HTTP Make, aby bezpośrednio wywołać 7stamp. Jest to uniwersalny wybór w przypadku niestandardowej usługi POS, ERP, systemu rezerwacji lub dowolnej pierwszej usługi API.
7stamp operacje do wywołania z Make HTTP
Dla każdego kartę poniżej, dodaj HTTP → Make a request, następnie ustaw metodę i URL dokładnie tak, jak pokazano. Użyj tego samego klucza Bearer dla każdego żądania. Wymagane mapowanie informuje, co należy dostarczyć z wyzwalacza CRM, POS lub e-commerce.
Wyzwalacz Make
Webhooks → Custom webhook Odbierz wydarzenie z karty
Utwórz Custom webhook w Make, skopiuj jego URL, a następnie wklej URL do ustawień webhooka profilu 7stamp. Rozpoczyna się scenariusz, gdy 7stamp wysyła zdarzenie takie jak SCAN, REWARD_EARNED lub VOUCHER_ISSUED.
- W Make
- Webhooks → Custom webhook → Dodaj; nadaj mu jasną nazwę i skopiuj wygenerowany URL.
- W 7stamp
- Administrator → API & Integrations → Webhooks; wklej URL, wybierz typy zdarzeń, zapisz, a następnie utwórz wydarzenie testowe.
HTTP akcję
POST /cards/invite Utwórz akcję Card Invite
Tworzy nową osobistą instalację URL i kod wstawienia dostawy dla jednego kontaktu zewnętrznego.
- Wymagane
- external_id — zmapuj swoją stajnię CRM/contact ID, a nie nazwę.
- Następnie użyj
- mapy install_url z odpowiedzi na swój e-mail, SMS lub CRM krok aktualizacji.
HTTP akcja
POST /cards/invite/bulk Tworzenie zbiorcze Card Invites
Tworzy do 100 linków z zaproszeniem w jednym żądaniu. Użyj go do kontrolowanej migracji lub kampanii, a nie do nieograniczonego eksportu kontaktów.
- Wymagane
- elementów — tablica JSON zawierająca 1–100 pojedynczych obiektów żądań zaproszenia.
- Sprawdź
- Przeczytaj success_count, error_count i każdy wynik przed wysłaniem jakichkolwiek linków.
HTTP akcja
GET /cards Find Cards
Znajduje rekordy kart według External ID, z opcjonalnym szablonem i filtrami źródłowymi.
- Wymagany
- Parametr zapytania external_id.
- Opcjonalne
- external_source i template_id zawężają wyszukiwanie, gdy jeden system ma wiele programów.
HTTP akcja
GET /cards/{user_card_id} Uzyskaj szczegółowe informacje o karcie
Odczytuje pełny stan jednej karty, gdy poprzedni krok zwrócił jej wewnętrzne User Card ID.
- Wymagane
- Zastąp {user_card_id} wewnętrznym ID zwróconym przez zaufaną odpowiedź 7stamp.
- Unikaj
- Nie zgaduj ani nie przechowuj karty ID z innego profilu.
HTTP akcja
POST /cards/scan Zeskanuj kartę
Dodaje znaczki z kwoty zakupu lub jawnej liczby. Akceptuje User Card ID lub External ID i może zachować odniesienie do zamówienia zewnętrznego.
- Tożsamość
- Użyj external_id i opcjonalnie external_source; user_card_id wygrywa, jeśli oba zostaną dostarczone.
- Zakup
- Użyj kwoty w przypadku kart kwotowych lub stamps_count w przypadku wyraźnego numeru; stamps_count ma pierwszeństwo.
- Możliwość śledzenia
- Mapa external_order_id z opłaconego zamówienia/receipt, dzięki czemu można dopasować zdarzenia 7stamp.
HTTP akcja
GET /templates List Templates
Wyświetla listę szablonów kart dostępnych dla klawisza API. Użyj go, aby przetestować połączenie lub dynamicznie wybrać szablon.
- Pierwszy test
- To najbezpieczniejsze pierwsze żądanie: nie ma treści i nie zmienia danych klienta.
- Mapuj później
- Użyj identyfikatora aktywnego szablonu jako template_id tylko wtedy, gdy profil ma więcej niż jeden aktywny szablon.
HTTP akcja
GET /templates/{template_id}/design Get Template Design
Zwraca ustawienia projektu wizualnego dla znanego szablonu, przydatne, gdy inny system musi wyświetlić spójny wybór karty.
HTTP akcja
POST /vouchers/issue Wydaj kupon
Wydaje kupon właścicielowi karty zidentyfikowanemu przez External ID lub User Card ID.
- Wymagany kupon
- .short_description. Wyceluj w kartę za pomocą external_id lub znanego user_card_id.
- Ważność
- Użyj validity_type z validity_value lub przeczytaj odnośnik OpenAPI dotyczący ustalonej daty ważności.
HTTP akcja
POST /messages/send Wyślij wiadomość
Wysyła zawartość do właściciela karty za pomocą funkcji push karty portfela i /or e-maila, z zastrzeżeniem skonfigurowanego kanału i zasad zgody.
- Naciśnięcie karty
- card_push_text jest ograniczone do 20 znaków i wymaga zainstalowanej przepustki do portfela.
- Wyślij temat i treść; podstawowy HTML jest obsługiwany w organizmie.
Make moduł
Full 7stamp endpoint URL HTTP → Make a request
To jest moduł Make, który wywołuje każdą 7stamp trasę powyżej. Użyj pełnego URL, wybierz udokumentowaną metodę, dodaj nagłówek Bearer i użyj JSON tylko wtedy, gdy trasa wymaga treści.
- Baza URL
- https://api.7loc.com/cards-api
- Nagłówek
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json dla żądań POST.
Trzy Make scenariusze, które możesz zbudować dokładnie tak, jak napisano
Poniższe nazwy to prawdziwe moduły Make. Zacznij od pierwszego scenariusza, uruchom go na jednorazowym kontakcie, a dopiero potem dodaj routery, filtry lub harmonogram produkcji.
1. Nowy kontakt CRM → wyślij link do karty 7stamp
Oczekiwany wynik: Klient otrzymuje install_url zwrócony przez 7stamp; Twój CRM może zachować URL w tym samym rekordzie kontaktu.
- 1 Utwórz scenariusz i dodaj wyzwalacz nowego kontaktu CRM New/Created. Dla Kommo wybierz wyzwalacz tworzenia kontaktu i uruchom go raz, aby załadować przykładowy kontakt.
- 2 Dodaj HTTP → Make a request. Ustaw metodę na POST i URL na https://api.7loc.com/cards-api/cards/invite.
- 3 Dodaj Authorization: Bearer YOUR_7STAMP_API_KEY i Content-Type: application/json. W treści JSON zmapuj kontakt CRM ID na external_id i ustaw external_source na stałą etykietę, taką jak kommo.
- 4 Uruchom moduł HTTP raz. Upewnij się, że na wyjściu znajdują się install_url, delivery_insert_code, external_id i template_id.
- 5 Dodaj swój adres e-mail/SMS/CRM moduł aktualizacji po HTTP i mapę install_url z wyjścia HTTP. Zapisz URL w kontakcie CRM, jeśli zespół będzie musiał wysłać go później.
Sprawdź: POST /cards/invite zawsze tworzy nowe zaproszenie. Użyj Find Cards najpierw, jeśli regułą Twojej firmy jest unikanie kolejnego zaproszenia dla istniejącego kontaktu.
2. Zamówienie opłacone → dodaj znaczki lojalnościowe
Oczekiwany wynik: Pomyślna odpowiedź skanowania obejmuje sukces, scan_id, stamps_added i stan karty po zeskanowaniu do następnego kroku.
- 1 Zacznij od wyzwalacza POS/ecommerce Zamówienie płatne. Make upewnij się, że jego próbka zawiera stabilnego klienta ID i zamówienie/receipt ID.
- 2 Dodaj HTTP → Make a request z POST https://api.7loc.com/cards-api/cards/scan i ten sam nagłówek Bearer.
- 3 Mapa external_id od klienta, external_source z nazwy systemu oraz external_order_id z zamówienia ID. Dodaj kwotę dla kart kwotowych lub stamps_count dla określonej liczby znaczków.
- 4 Run once z zamówieniem testowym. Przed włączeniem harmonogramu scenariuszy sprawdź zwróconą flagę sukcesu i stamps_added.
- 5 Opcjonalnie dodaj filtr po kroku HTTP: kontynuuj tylko wtedy, gdy sukces jest prawdziwy, następnie wpisz scan_id lub stamps_added z powrotem do rekordu zamówienia/CRM.
Sprawdź: Użyj tego samego external_order_id przy ponownych próbach, aby można było prześledzić kolejność w późniejszych zdarzeniach webhooka; nie przyznaje się znaczków dwukrotnie po niejasnym nieudanym biegu.
3. 7stamp zdarzenie → zaktualizuj CRM
Oczekiwany wynik: Make natychmiast odbiera zdarzenie 7stamp i może znaleźć pasujący rekord CRM poprzez external_id i external_source.
- 1 Utwórz osobny scenariusz Make. Dodaj Webhooks → Custom webhook, wybierz Dodaj, nadaj mu nazwę 7stamp-card-events i skopiuj wygenerowany URL.
- 2 W 7stamp Admin otwórz API & Integrations → Webhooks. Dodaj to URL i wybierz mały zestaw zdarzeń, na przykład SCAN i REWARD_EARNED.
- 3 Utwórz jednorazowy skan testowy lub zdarzenie karty w 7stamp. Wróć do Make i użyj Run once, aby Make określiło strukturę danych zdarzenia.
- 4 Dodaj krok wyszukiwania CRM, używając external_id. Dodaj filtr lub router na event_type, aby SCAN, REWARD_EARNED i VOUCHER_ISSUED mogły wykonywać różne działania.
- 5 Dodaj akcję CRM aktualizacja/note. Mapuj scanned_at, stamps_after, external_order_id i issued_vouchers tylko wtedy, gdy te pola są obecne dla wybranego typu zdarzenia.
Sprawdź: Zachowaj webhook URL jako prywatny. Przetestuj prawdziwe wydarzenie, zanim włączysz nieodwracalne wiadomości, kupony lub CRM zmiany.
Zdobądź klucz 7stamp API przed otwarciem Make
To są dokładne ekrany 7stamp Admin. Utwórz klucz raz, skopiuj go do bezpiecznego połączenia Make HTTP/keychain, a następnie natychmiast usuń go ze schowka.
Przygotuj połączenie przed budowaniem
Utwórz jeden klucz API na środowisko
W 7stamp Admin przejdź do API & Integrations → API Keys → Add API Key. Zapisz wartość w Make HTTP API-kluczowe połączenie/keychain, jeśli ta opcja jest dostępna. Nigdy nie mapuj klucza z pola tekstowego, nie umieszczaj go w notatce ani nie używaj go w przepływie pracy w przeglądarce. Klucz należy do jednego 7stamp miejsca pracy/profile.
Użyj stabilnego External ID
Zamapuj niezmienny ID z CRM, POS lub platformy handlowej — na przykład CRM kontakt ID lub klient UUID. Dodaj External Source, taki jak hubspot, shopify lub plakat, jeśli ten sam identyfikator może pojawić się w więcej niż jednym systemie.
Zdecyduj, który szablon ma zastosowanie
Jeśli podłączony profil 7stamp ma jeden aktywny szablon karty, Szablon można pozostawić pusty. Dzięki wielu szablonom zamapuj lub wybierz template_id celowo, aby każde zaproszenie i skan dotarły do zamierzonego programu lojalnościowego.
Dokładna konfiguracja Make HTTP: utwórz jedno zaproszenie na kartę
Skopiuj to do swojego kroku automatyzacji
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
}Zbuduj i przetestuj swój pierwszy scenariusz Make
W 7stamp Admin utwórz klucz w API & Integrations → API Keys → Add API Key. Użyj osobnego profilu testowego/key, jeśli pozwala na to konfiguracja konta.
W Make utwórz scenariusz i dodaj wyzwalacz źródłowy. Uruchom go raz przed mapowaniem, aby zobaczyć prawdziwy przykładowy kontakt lub opłacone zamówienie.
Kliknij kolejny plus, wyszukaj HTTP i wybierz Make żądanie. Ustaw metodę, pełną URL i nagłówki z karty operacji na tej stronie.
Użyj GET https://api.7loc.com/cards-api/templates jako pierwszego żądania. Pomyślna reakcja potwierdza, że klucz działa bez zmiany jakichkolwiek danych klienta.
W przypadku tras POST wybierz application/json i wklej kształt bryły z tego przewodnika. Zamapuj stajnię External ID; dodaj template_id tylko jeśli profil ma wiele aktywnych szablonów.
Uruchom z kontaktem jednorazowym, sprawdź wyjście HTTP i dopiero wtedy zmapuj jego dokładne pola odpowiedzi na następny moduł CRM, e-mail lub moduł przesyłania wiadomości.
Kiedy należy użyć Make HTTP?
Użyj teraz HTTP dla 7stamp: jest to udokumentowana, gotowa do produkcji trasa, a nie zredukowana trasa rezerwowa. Wybierz tę opcję, gdy potrzebujesz operacji 7stamp, nowej trasy API lub niestandardowego połączenia POS/ERP. Odniesienie OpenAPI jest źródłem prawdy dla metody, pełnej ścieżki, treści i schematu odpowiedzi; klucz na okaziciela i podstawa URL pozostają takie same.
Odbieraj 7stamp zdarzenia w Make
W przypadku scenariusza opartego na zdarzeniach dodaj Webhooks → Custom webhook i utwórz webhook. Skopiuj jego URL, otwórz API & Integrations → Webhooks w profilu 7stamp, wklej URL, wybierz typy zdarzeń, zapisz i wyślij prawdziwe zdarzenie testowe. Profil 7stamp jest właścicielem tej subskrypcji; bieżący API nie udostępnia punktów końcowych automatycznej subskrypcji webhooka/unsubscribe.
Nie jest wymagane publiczne złącze Make
Instrukcje na tej stronie korzystają z modułów Make dostępnych dla każdego konta Make. Jeśli chcesz w przyszłości natywny moduł 7stamp zamiast HTTP, wyślij nam potrzebny przepływ pracy; do tego czasu HTTP i Custom webhooks obejmują każdą udokumentowaną operację 7stamp.
Często zadawane pytania
Nie mogę znaleźć 7stamp w Make. Czy nadal mogę to zautomatyzować?
Tak. Dzisiaj w Make nie ma publicznej aplikacji 7stamp. Dodaj HTTP > Make żądanie, użyj pełnego punktu końcowego 7stamp URL i wyślij Authorization: Bearer, a następnie swój klucz 7stamp API. HTTP może wywołać każdy udokumentowany punkt końcowy.
Skąd zdobyć token dla połączenia Make?
W 7stamp Admin otwórz API Integracje, następnie API Keys, a następnie Add API Key. Klucz obejmuje miejsce pracy/profile, w którym go utworzono, więc jeśli to możliwe, używaj profilu testowego w scenariuszach testowych.
Który identyfikator powinienem zmapować jako External ID?
Użyj stabilnego identyfikatora z systemu źródłowego, najlepiej kontaktu CRM ID lub klienta UUID. Nie używaj nazwy wyświetlanej. Numer telefonu lub adres e-mail mogą działać, ale mogą się zmieniać i należy się z nimi konsekwentnie obchodzić.
Jak umieścić zdarzenia 7stamp w Make?
Utwórz webhooki > Custom webhook w Make, a następnie wklej wygenerowany URL do ustawień webhooka w profilu 7stamp. Po dostawie użyj filtra lub routera Make, aby obsłużyć przychodzące event_type.
Następny krok
Gotowy do zautomatyzowania pierwszej akcji lojalnościowej?
Utwórz klucz API, przetestuj List Templates i zbuduj jeden scenariusz zaproszenia lub skanowania za pomocą kontaktu jednorazowego. Dodawaj routery i komunikatory dopiero wtedy, gdy prosty przepływ będzie niezawodny.