Erstellen Sie eine Karte nach einem neuen CRM-Kontakt
Verwenden Sie den CRM-Kontakt ID als External ID, erstellen Sie eine 7stamp-Karteneinladung und senden Sie dann die zurückgegebene Installation URL wie gewohnt E-Mail, SMS oder Messaging-Schritt.
Leitfaden zur No-Code-Automatisierung
Verbinden Sie 7stamp mit Make – Schritt für Schritt
ImplementierungsleitfadenVerwenden Sie Make, um 7stamp mit einem CRM, POS, einem Online-Shop, einer Tabellenkalkulation, einem Messaging-Tool oder einem anderen System zu verbinden, das Daten in ein Szenario senden kann. Die produktionsbereite Route ist heute die HTTP-App von Make für 7stamp API-Anrufe und die Custom webhook-App von Make für eingehende 7stamp-Ereignisse.
Es gibt noch keine öffentliche 7stamp-App in der App-Auswahl von Make. Warten Sie nicht auf eine: Fügen Sie HTTP → Make a request hinzu, verwenden Sie die genaue URL-Methode, den Bearer-Header und JSON unten und ordnen Sie dann die Felder aus Ihrem Quellmodul zu. Dies ist derselbe 7stamp Integration API, den ein zukünftiger Anschluss verwenden würde.
Wählen Sie das erste Szenario, das zu Ihrem Workflow passt.
Beginnen Sie mit einem Ereignis und einem Ergebnis. Sobald die Testdaten korrekt sind, fügen Sie Filter, Router, CRM-Updates und Folgemeldungen hinzu.
Fügen Sie Stempel nach einer bezahlten Bestellung hinzu.
Lösen Sie das Szenario aus einer bezahlten POS- oder E-Commerce-Bestellung aus. Ordnen Sie den stabilen Kunden ID zu und bestellen Sie ID in „Karte scannen“ und verwenden Sie dann einen Betrag oder eine explizite Stempelanzahl.
Senden Sie eine Belohnungsnachverfolgung
Wenn ein Kartenereignis eine Belohnung oder einen Gutschein meldet, verzweigen Sie das Szenario: Aktualisieren Sie die CRM, benachrichtigen Sie das Team und senden Sie nur bei Bedarf einen Wallet-Card-Push oder eine E-Mail.
Behandeln Sie ein System ohne eine native Make-App
Verwenden Sie das HTTP-Modul von Make, um 7stamp direkt aufzurufen. Dies ist die universelle Wahl für eine benutzerdefinierte POS-, ERP-Buchungsmaschine oder einen beliebigen API-First-Service.
7stamp Operationen zum Aufrufen von Make HTTP
Für jeden Karte unten, fügen Sie HTTP → Make a request hinzu und stellen Sie dann die Methode und URL genau wie gezeigt ein. Verwenden Sie für jede Anfrage denselben Schlüssel Bearer. Die erforderliche Zuordnung sagt Ihnen, was Sie von Ihrem CRM, POS oder E-Commerce-Trigger bereitstellen müssen.
Make-Trigger
Webhooks → Custom webhook Erhalten Sie ein Kartenereignis
Erstellen Sie ein Custom webhook in Make, kopieren Sie dessen URL und fügen Sie dann dieses URL in die Webhook-Einstellungen des 7stamp-Profils ein. Dies startet ein Szenario, wenn 7stamp ein Ereignis wie SCAN, REWARD_EARNED oder VOUCHER_ISSUED sendet.
- In Make
- Webhooks → Custom webhook → Hinzufügen; Geben Sie ihm einen klaren Namen und kopieren Sie den generierten URL.
- In 7stamp
- Admin → API & Integrations → Webhooks; Fügen Sie URL ein, wählen Sie Ereignistypen aus, speichern Sie und erstellen Sie dann ein Testereignis.
HTTP.
POST /cards/invite Erstellen Sie eine Aktion Card Invite
Erstellt eine neue persönliche Installation URL und einen Liefer-Einfügungscode für einen externen Kontakt.
- Erforderlich
- external_id – Ordnen Sie Ihren Stall zu CRM/contact ID, kein Name.
- Verwenden Sie dann
- Map install_url aus der Antwort in Ihrer E-Mail, SMS oder CRM Aktualisierungsschritt.
HTTP Aktion
POST /cards/invite/bulk Massenerstellung Card Invites
Erstellt bis zu 100 Einladungslinks in einer Anfrage. Verwenden Sie es für eine kontrollierte Migration oder Kampagne, nicht für einen unbegrenzten Kontaktexport.
- Erforderliche
- Elemente – ein JSON Array von 1–100 einzelnen Einladungsanfrageobjekten.
- Überprüfen Sie
- Lesen Sie success_count, error_count und jedes Ergebnis, bevor Sie Links senden.
HTTP Aktion
GET /cards Find Cards
Sucht Kartendatensätze nach External ID, mit optionalen Vorlagen- und Quellfiltern.
- Erforderlich
- Abfrageparameter external_id.
- Optional
- external_source und template_id schränken die Suche ein, wenn ein System über mehrere Programme verfügt.
HTTP Aktion
GET /cards/{user_card_id} Holen Sie sich ein Kartendetail
Liest den vollständigen Status einer Karte, wenn ein vorheriger Schritt seinen internen User Card ID zurückgegeben hat.
- Erforderlich
- Ersetzen Sie {user_card_id} durch das interne ID, das von einer vertrauenswürdigen 7stamp-Antwort zurückgegeben wird.
- Vermeiden Sie
- Erraten oder speichern Sie keine Karte ID aus einem anderen Profil.
HTTP Aktion
POST /cards/scan Eine Karte scannen
Fügt Stempel aus einem Kaufbetrag oder einer expliziten Anzahl hinzu. Es akzeptiert User Card ID oder External ID und kann die externe Bestellreferenz beibehalten.
- Identität
- Verwenden Sie external_id und optional external_source; user_card_id gewinnt, wenn beide versorgt werden.
- Kauf
- Betrag für betragsbasierte Karten verwenden oder stamps_count für eine explizite Nummer; stamps_count hat Priorität.
- Rückverfolgbarkeit
- Ordnen Sie external_order_id aus der bezahlten Bestellung /receipt zu, damit 7stamp Ereignisse wieder zugeordnet werden können.
HTTP Aktion
GET /templates List Templates
Listet die Kartenvorlagen auf, die für die Taste API verfügbar sind. Verwenden Sie es, um die Verbindung zu testen oder eine Vorlage dynamisch auszuwählen.
- Erster Test
- Dies ist die sicherste erste Anfrage: Sie hat keinen Körper und ändert keine Kundendaten.
- Später zuordnen
- Verwenden Sie die ID einer aktiven Vorlage nur als template_id, wenn das Profil mehr als eine aktive Vorlage hat.
HTTP Aktion
GET /templates/{template_id}/design Get Template Design
Gibt die visuellen Designeinstellungen für eine bekannte Vorlage zurück, nützlich, wenn ein anderes System eine konsistente Kartenauswahl anzeigen muss.
HTTP Aktion
POST /vouchers/issue Einen Gutschein ausstellen
Stellt einen Gutschein an einen Karteninhaber aus, der durch External ID oder User Card ID identifiziert wird.
- Erforderlicher
- Gutschein.short_description. Zielen Sie auf die Karte mit external_id oder einem bekannten user_card_id.
- Gültigkeit
- Verwenden Sie validity_type mit validity_value oder lesen Sie die Referenz OpenAPI für ein festes Ablaufdatum.
HTTP Aktion
POST /messages/send Eine Nachricht senden
Sendet Inhalte per Wallet-Card-Push und /or E-Mail an den Karteninhaber, vorbehaltlich des konfigurierten Kanals und der Einwilligungsregeln.
- Card Push
- card_push_text ist auf 20 Zeichen begrenzt und erfordert einen installierten Wallet-Pass.
- Betreff und Text senden; basic HTML wird im Körper unterstützt.
Make Modul
Full 7stamp endpoint URL HTTP → Make a request
Dies ist das Make-Modul, das jede oben genannte 7stamp-Route aufruft. Verwenden Sie eine vollständige URL, wählen Sie die dokumentierte Methode aus, fügen Sie den Header Bearer hinzu und verwenden Sie JSON nur, wenn die Route einen Körper benötigt.
- Basis URL
- https://api.7loc.com/cards-api
- Kopf
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json für POST Anfragen.
Drei Make-Szenarien, die Sie genau wie beschrieben erstellen können
Die folgenden Namen sind die echten Make-Module. Beginnen Sie mit dem ersten Szenario, führen Sie es für einen verfügbaren Kontakt aus und fügen Sie erst dann Router, Filter oder Produktionsplanung hinzu.
1. Neuer CRM-Kontakt → einen 7stamp-Kartenlink senden
Erwartetes Ergebnis: Der Kunde erhält das install_url von 7stamp zurückgesendet; Ihr CRM kann das URL im selben Kontaktdatensatz behalten.
- 1 Erstellen Sie ein Szenario und fügen Sie den neuen Kontaktauslöser Ihres CRM/Created hinzu. Wählen Sie für Kommo den Auslöser für die Kontakterstellung und führen Sie ihn einmal aus, um einen Beispielkontakt zu laden.
- 2 HTTP → Make a request hinzufügen. Setzen Sie die Methode auf POST und URL auf https://api.7loc.com/cards-api/cards/invite.
- 3 . Fügen Sie Authorization hinzu: Bearer YOUR_7STAMP_API_KEY und Content-Type: application/json. Ordnen Sie im JSON-Körper den CRM-Kontakt ID in external_id zu und setzen Sie external_source auf eine feste Bezeichnung wie kommo.
- 4 Führen Sie das Modul HTTP einmal aus. Bestätigen Sie, dass die Ausgabe install_url, delivery_insert_code, external_id und template_id hat.
- 5 Fügen Sie Ihr E-Mail-/SMS/CRM-Aktualisierungsmodul nach HTTP hinzu und ordnen Sie install_url aus der HTTP-Ausgabe zu. Speichern Sie die URL im Kontakt CRM, falls das Team sie später erneut senden muss.
Überprüfen Sie: POST /cards/invite erstellt immer eine neue Einladung. Verwenden Sie zuerst Find Cards, wenn Ihre Geschäftsregel darin besteht, eine weitere Einladung für einen bestehenden Kontakt zu vermeiden.
2. Bezahlte Bestellung → Treuestempel hinzufügen
Erwartetes Ergebnis: Eine erfolgreiche Scan-Antwort umfasst Erfolg, scan_id, stamps_added und den Kartenstatus nach dem Scan für Ihren nächsten Schritt.
- 1 Beginnen Sie mit dem Auslöser „Bezahlte Bestellung“ POS/ecommerce. Make Stellen Sie sicher, dass seine Stichprobe einen stabilen Kunden ID und die Bestellung /receipt ID enthält.
- 2 Fügen Sie HTTP → Make a request mit POST https://api.7loc.com/cards-api/cards/scan und demselben Bearer-Header hinzu.
- 3 Karte external_id vom Kunden, external_source vom Systemnamen und external_order_id vom Auftrag ID. Addieren Sie den Betrag für betragsbasierte Karten oder stamps_count für eine explizite Anzahl von Stempeln.
- 4 Run once mit einer Testbestellung. Überprüfen Sie die zurückgegebene Erfolgsflagge und stamps_added, bevor Sie den Szenarioplan aktivieren.
- 5 Fügen Sie optional nach dem Schritt HTTP einen Filter hinzu: Fahren Sie nur fort, wenn der Erfolg wahr ist, und schreiben Sie dann scan_id oder stamps_added zurück in den Auftrags-/CRM-Datensatz.
Überprüfen Sie: Verwenden Sie dasselbe external_order_id bei Wiederholungsversuchen, damit die Reihenfolge bei späteren Webhook-Ereignissen nachverfolgt werden kann; Vergeben Sie nach einem unklaren Fehllauf keine doppelten Stempel.
3. 7stamp-Ereignis → Aktualisieren Sie das CRM
Erwartetes Ergebnis: Make empfängt das 7stamp-Ereignis sofort und kann den passenden CRM-Datensatz über external_id finden und external_source.
- 1 Erstellen Sie ein separates Make-Szenario. Fügen Sie Webhooks → Custom webhook hinzu, wählen Sie Hinzufügen, nennen Sie es 7stamp-card-events und kopieren Sie das generierte URL.
- 2 Öffnen Sie in 7stamp Admin API & Integrations → Webhooks. Fügen Sie URL hinzu und wählen Sie eine kleine Gruppe von Ereignissen aus, zum Beispiel SCAN und REWARD_EARNED.
- 3 Erstellen Sie einen Einweg-Testscan oder ein Kartenereignis in 7stamp. Kehren Sie zu Make zurück und verwenden Sie Run once, um Make die Ereignisdatenstruktur bestimmen zu lassen.
- 4 Fügen Sie einen Suchschritt CRM mit external_id hinzu. Fügen Sie einen Filter oder Router auf event_type hinzu, damit SCAN, REWARD_EARNED und VOUCHER_ISSUED unterschiedliche Aktionen ausführen können.
- 5 Fügen Sie die Aktion CRM Update/note hinzu. Ordnen Sie scanned_at, stamps_after, external_order_id und issued_vouchers nur zu, wenn diese Felder für den ausgewählten Ereignistyp vorhanden sind.
Überprüfen Sie: Halten Sie den Webhook URL privat. Testen Sie ein reales Ereignis, bevor Sie unwiderrufliche Nachrichten, Gutscheine oder CRM Änderungen einschalten.
Holen Sie sich den 7stamp API-Schlüssel, bevor Sie Make
öffnen. Dies sind die genauen 7stamp Admin-Bildschirme. Erstellen Sie den Schlüssel einmal, kopieren Sie ihn in die sichere HTTP-Verbindung/keychain von Make und entfernen Sie ihn dann sofort aus Ihrer Zwischenablage.
Bereiten Sie die Verbindung vor dem Aufbau vor.
Erstellen Sie einen API-Schlüssel pro Umgebung.
Gehen Sie in 7stamp Admin zu API & Integrations → API Keys → Add API Key. Speichern Sie den Wert in der HTTP API-Schlüsselverbindung/keychain von Make, wenn diese Option verfügbar ist. Ordnen Sie den Schlüssel niemals einem Textfeld zu, platzieren Sie ihn nicht in einer Notiz und verwenden Sie ihn niemals in einem browserbasierten Workflow. Ein Schlüssel gehört zu einem 7stamp Arbeitsplatz/profile.
. Verwenden Sie einen stabilen External ID
. Ordnen Sie den unveränderlichen ID von Ihrem CRM, POS oder Ihrer Handelsplattform zu – zum Beispiel a CRM Kontakt ID oder Kunde UUID. Fügen Sie External Source wie Hubspot, Shopify oder Poster hinzu, wenn dieselbe Kennung in mehr als einem System vorkommen könnte.
Entscheiden Sie, welche Vorlage angewendet werden soll
Wenn das verbundene 7stamp-Profil über eine aktive Kartenvorlage verfügt, kann die Vorlage leer gelassen werden. Bei mehreren Vorlagen können Sie template_id gezielt zuordnen oder auswählen, damit jede Einladung und jeder Scan das vorgesehene Treueprogramm erreicht.
Genaues Make HTTP-Setup: Erstellen Sie eine Karteneinladung
Kopieren Sie dies in Ihren Automatisierungsschritt
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
}Erstellen und testen Sie Ihr erstes Make-Szenario
Erstellen Sie in 7stamp Admin einen Schlüssel in API & Integrations → API Keys → Add API Key. Verwenden Sie ein separates Testprofil/key, wenn Ihre Kontoeinrichtung dies zulässt.
Erstellen Sie in Make ein Szenario und fügen Sie den Quellauslöser hinzu. Führen Sie es vor der Zuordnung einmal aus, damit Sie einen echten Beispielkontakt oder eine bezahlte Bestellung sehen können.
Klicken Sie auf das nächste Pluszeichen, suchen Sie nach HTTP und wählen Sie Make eine Anfrage aus. Legen Sie die Methode, das vollständige URL und die Header über die Operationskarte auf dieser Seite fest.
Verwenden Sie GET https://api.7loc.com/cards-api/templates als erste Anfrage. Die erfolgreiche Reaktion beweist, dass der Schlüssel funktioniert, ohne dass Kundendaten geändert werden.
Wählen Sie für POST-Routen application/json aus und fügen Sie die Körperform aus dieser Anleitung ein. Ordnen Sie einen Stall External ID zu; Fügen Sie template_id nur hinzu, wenn das Profil über mehrere aktive Vorlagen verfügt.
Führen Sie den Vorgang mit einem verfügbaren Kontakt aus, überprüfen Sie die Ausgabe von HTTP und ordnen Sie erst dann seine genauen Antwortfelder dem nächsten CRM, E-Mail- oder Messaging-Modul zu.
Wann sollten Sie Make HTTP verwenden?
Verwenden Sie jetzt HTTP für 7stamp: Es handelt sich um die dokumentierte, produktionsbereite Route, nicht um einen reduzierten Fallback. Wählen Sie es immer dann, wenn Sie einen 7stamp-Vorgang, eine neue API-Route oder eine benutzerdefinierte POS/ERP-Verbindung benötigen. Die Referenz OpenAPI ist die Quelle der Wahrheit für die Methode, den vollständigen Pfad, den Textkörper und das Antwortschema. Der Inhaberschlüssel und die Basis URL bleiben gleich.
Empfangen Sie 7stamp Ereignisse in Make
Für ein ereignisgesteuertes Szenario fügen Sie Webhooks → Custom webhook hinzu und erstellen Sie einen Webhook. Kopieren Sie dessen URL, öffnen Sie API & Integrations → Webhooks im Profil 7stamp, fügen Sie URL ein, wählen Sie die Ereignistypen aus, speichern Sie und senden Sie ein echtes Testereignis. Das 7stamp-Profil besitzt dieses Abonnement; Das aktuelle API stellt keine automatischen Webhook-Abonnement-Endpunkte /unsubscribe zur Verfügung.
Es ist kein öffentlicher Make-Anschluss erforderlich.
Die Anweisungen auf dieser Seite verwenden Make-Module, die für jedes Make-Konto verfügbar sind. Wenn Sie in Zukunft ein natives 7stamp-Modul anstelle von HTTP wünschen, senden Sie uns den Workflow, den Sie benötigen; Bis dahin decken HTTP und Custom webhooks alle dokumentierten 7stamp-Vorgänge ab.
Häufig gestellte Fragen
Ich kann 7stamp in Make nicht finden. Kann ich es trotzdem automatisieren?
Ja. Heute gibt es in Make keine öffentliche 7stamp-App. Fügen Sie eine Anfrage HTTP > Make hinzu, verwenden Sie den vollständigen 7stamp-Endpunkt URL und senden Sie Authorization: Bearer gefolgt von Ihrem 7stamp API-Schlüssel. HTTP kann jeden dokumentierten Endpunkt aufrufen.
Wo bekomme ich den Token für die Make-Verbindung?
Öffnen Sie in 7stamp Admin API Integrationen, dann API Keys, dann Add API Key. Der Schlüssel ist auf den Arbeitsplatz/profile beschränkt, der ihn erstellt hat. Verwenden Sie daher nach Möglichkeit ein Testprofil für Testszenarien.
Welche Kennung soll ich als External ID zuordnen?
Verwenden Sie die stabile Kennung aus dem Quellsystem, vorzugsweise einen CRM Kontakt ID oder einen Kunden UUID. Verwenden Sie keinen Anzeigenamen. Eine Telefonnummer oder E-Mail kann funktionieren, kann sich aber ändern und sollte einheitlich gehandhabt werden.
Wie bekomme ich 7stamp-Ereignisse in Make?
Erstellen Sie einen Webhooks > Custom webhook in Make und fügen Sie dann den generierten URL in die Webhook-Einstellungen des 7stamp-Profils ein. Verwenden Sie nach der Lieferung einen Make-Filter oder Router, um den eingehenden event_type zu verarbeiten.
Nächster Schritt
Sind Sie bereit, die erste Treueaktion zu automatisieren?
Erstellen Sie den Schlüssel API, testen Sie List Templates und erstellen Sie ein Einladungs- oder Scan-Szenario mit einem verfügbaren Kontakt. Fügen Sie Router und Messaging erst hinzu, wenn dieser einfache Ablauf zuverlässig ist.