Créez une carte après un nouveau contact CRM
Utilisez le contact CRM ID comme External ID, créez une invitation de carte 7stamp, puis envoyez l'installation renvoyée URL via votre email habituel, SMS, ou étape de messagerie.
Guide d'automatisation sans code
Connectez 7stamp à Make — étape par étape
Guide de mise en œuvreUtilisez Make pour connecter 7stamp à un CRM, POS, une boutique en ligne, une feuille de calcul, un outil de messagerie ou tout autre système pouvant envoyer des données dans un scénario. L'itinéraire prêt pour la production aujourd'hui est l'application HTTP de Make pour les appels 7stamp API et Custom webhook de Make pour les événements 7stamp entrants.
Il n'y a pas encore d'application publique 7stamp dans le sélecteur d'applications de Make. N'en attendez pas un: ajoutez HTTP → Make a request, utilisez la méthode exacte URL, l'en-tête Bearer et JSON ci-dessous, puis mappez les champs de votre module source. C'est le même 7stamp Integration API qu'un futur connecteur utiliserait.
Choisissez le premier scénario qui correspond à votre flux de travail
Commencez avec un événement et un résultat. Une fois les données de test correctes, ajoutez des filtres, des routeurs, des mises à jour CRM et des messages de suivi autour.
Ajouter des tampons après une commande payante
Déclenchez le scénario à partir d'une commande payante POS ou ecommerce. Cartographiez son client stable ID et commandez ID dans Scan a Card, puis utilisez un montant ou un nombre de tampons explicite.
Envoyer un suivi de récompense
Lorsqu'un événement de carte signale une récompense ou un bon, branchez le scénario: mettez à jour le CRM, informez l'équipe et envoyez un push de carte de portefeuille ou un e-mail uniquement en cas de besoin.
Gérez un système sans application native Make
Utilisez le module HTTP de Make pour appeler directement 7stamp. Il s'agit du choix universel pour un moteur de réservation personnalisé POS, ERP ou tout autre service API-first.
7stamp opérations à appeler depuis Make HTTP
Pour chaque carte ci-dessous, ajoutez HTTP → Make a request, puis définissez la méthode et URL exactement comme indiqué. Utilisez la même clé Bearer pour chaque demande. Le mappage requis vous indique ce qu'il faut fournir à partir de votre déclencheur CRM, POS ou de commerce électronique.
Make déclenche
Webhooks → Custom webhook Recevez un événement de carte
Créez un Custom webhook dans Make, copiez son URL, puis collez ce URL dans les paramètres du webhook du profil 7stamp. Cela démarre un scénario lorsque 7stamp envoie un événement tel que SCAN, REWARD_EARNED ou VOUCHER_ISSUED.
- Dans Make
- Webhooks → Custom webhook → Ajouter; donnez-lui un nom clair et copiez son URL généré.
- Dans 7stamp
- Administrateur → API & Integrations → Webhooks; collez le URL, sélectionnez les types d'événements, enregistrez, puis créez un événement de test.
HTTP
POST /cards/invite Créer une action Card Invite
Crée une nouvelle installation personnelle URL et un code d'insertion de livraison pour un contact externe.
- Obligatoire
- external_id — mappez votre écurie CRM/contact ID, pas un nom.
- Utilisez ensuite
- Map install_url de la réponse dans votre e-mail, SMS ou CRM étape de mise à jour.
HTTP action
POST /cards/invite/bulk Création groupée Card Invites
Crée jusqu'à 100 liens d'invitation en une seule demande. Utilisez-le pour une migration ou une campagne contrôlée, et non pour une exportation illimitée de contacts.
- Éléments
- requis — un tableau JSON de 1 à 100 objets de demande d'invitation individuels.
- Vérifiez
- Lisez success_count, error_count et chaque résultat avant d'envoyer des liens.
HTTP action
GET /cards Find Cards
Recherche les enregistrements de carte par External ID, avec des filtres de modèle et de source facultatifs.
- Obligatoire
- Paramètre de requête external_id.
- Facultatif
- external_source et template_id limitent la recherche lorsqu'un système possède plusieurs programmes.
HTTP action
GET /cards/{user_card_id} Obtenez un détail de la carte
Lit l'état complet d'une carte lorsqu'une étape précédente a renvoyé son User Card ID interne.
- Obligatoire
- Remplacez {user_card_id} par le ID interne renvoyé par une réponse fiable 7stamp.
- Évitez
- Ne devinez pas et ne stockez pas une carte ID d'un profil différent.
HTTP action
POST /cards/scan Scanner une carte
Ajoute des tampons à partir d'un montant d'achat ou d'un décompte explicite. Il accepte User Card ID ou External ID et peut conserver la référence de commande externe.
- Identité
- Utilisez external_id et facultatif external_source; user_card_id gagne si les deux sont fournis.
- Achetez
- Utilisez le montant pour les cartes basées sur le montant ou stamps_count pour un numéro explicite; stamps_count est prioritaire.
- Traçabilité
- Mappez external_order_id à partir de la commande payée/receipt afin que les événements 7stamp puissent être associés.
HTTP action
GET /templates List Templates
Répertorie les modèles de cartes disponibles pour la touche API. Utilisez-le pour tester la connexion ou pour sélectionner un modèle de manière dynamique.
- Premier test
- C'est la première requête la plus sûre: elle n'a pas de corps et ne modifie pas les données client.
- Mapper plus tard
- Utilisez l'identifiant d'un modèle actif comme template_id uniquement lorsque le profil a plusieurs modèles actifs.
HTTP action
GET /templates/{template_id}/design Get Template Design
Returns the visual design settings for a known template, useful when another system needs to display a consistent card choice.
HTTP action
POST /vouchers/issue Émettre un bon
Émet un bon à un propriétaire de carte identifié par External ID ou User Card ID.
- Bon d'achat
- requis.short_description. Ciblez la carte avec external_id ou un user_card_id connu.
- Validité
- Utilisez validity_type avec validity_value, ou lisez la référence OpenAPI pour une date d'expiration fixe.
HTTP action
POST /messages/send Envoyer un message
Envoie le contenu au propriétaire de la carte via push de carte portefeuille et/or e-mail, sous réserve du canal configuré et des règles de consentement.
- Card Push
- card_push_text est limité à 20 caractères et nécessite un pass portefeuille installé.
- Envoyer le sujet et le corps; le basique HTML est pris en charge dans le corps.
Make module
Full 7stamp endpoint URL HTTP → Make a request
Il s'agit du module Make qui appelle chaque route 7stamp ci-dessus. Utilisez un URL complet, sélectionnez la méthode documentée, ajoutez l'en-tête Bearer et utilisez JSON uniquement lorsque l'itinéraire a besoin d'un corps.
- Base URL
- https://api.7loc.com/cards-api
- En-tête
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json pour les requêtes POST.
Trois scénarios Make que vous pouvez construire exactement comme écrit
Les noms ci-dessous sont les vrais modules Make. Commencez par le premier scénario, exécutez-le sur un contact jetable, puis ajoutez ensuite des routeurs, des filtres ou une planification de production.
1. Nouveau contact CRM → envoyer un lien de carte 7stamp
Résultat attendu: Le client reçoit le install_url retourné par 7stamp; votre CRM peut conserver ce URL dans le même enregistrement de contact.
- 1 Créez un scénario et ajoutez le déclencheur de contact New/Created de votre CRM. Pour Kommo, choisissez le déclencheur de création de contact et exécutez-le une fois pour charger un exemple de contact.
- 2 Ajoutez HTTP → Make a request. Set Method to POST and URL to https://api.7loc.com/cards-api/cards/invite.
- 3 Add Authorization: Bearer YOUR_7STAMP_API_KEY and Content-Type: application/json. Dans le corps JSON, mappez le contact CRM ID dans external_id et définissez external_source sur une étiquette fixe telle que kommo.
- 4 Exécutez une fois le module HTTP. Confirmez que la sortie contient install_url, delivery_insert_code, external_id et template_id.
- 5 Ajoutez votre module de mise à jour email/SMS/CRM après HTTP et mappez install_url à partir de la sortie HTTP. Enregistrez le URL sur le contact CRM si l'équipe doit le renvoyer ultérieurement.
Vérifiez: POST /cards/invite crée toujours une nouvelle invitation. Utilisez d'abord Find Cards si votre règle commerciale est d'éviter une autre invitation pour un contact existant.
2. Commande payante → ajouter des tampons de fidélité
Résultat attendu: Une réponse de numérisation réussie inclut le succès, scan_id, stamps_added et l'état de la carte après numérisation pour votre prochaine étape.
- 1 Commencez à partir du déclencheur POS/ecommerce Commande payée. Make assurez-vous que son échantillon contient un client stable ID et la commande/receipt ID.
- 2 Ajoutez HTTP → Make a request avec POST https://api.7loc.com/cards-api/cards/scan et le même en-tête Bearer.
- 3 Carte external_id du client, external_source du nom du système et external_order_id de la commande ID. Ajoutez le montant pour les cartes basées sur le montant, ou stamps_count pour un nombre explicite de tampons.
- 4 Run once avec une commande test. Vérifiez l'indicateur de réussite renvoyé et stamps_added avant d'activer la planification du scénario.
- 5 Ajoutez éventuellement un filtre après l'étape HTTP: continuez uniquement lorsque le succès est vrai, puis écrivez scan_id ou stamps_added dans l'enregistrement order/CRM.
Vérifiez: Utilisez le même external_order_id lors des tentatives afin que l'ordre puisse être retracé dans les événements de webhook ultérieurs; n'attribuez pas de timbres deux fois après un échec peu clair.
3. Événement 7stamp → mettre à jour l'événement CRM
Résultat attendu: Make reçoit immédiatement l'événement 7stamp et peut trouver l'enregistrement CRM correspondant via external_id et external_source.
- 1 Créez un scénario Make distinct. Ajoutez Webhooks → Custom webhook, sélectionnez Ajouter, nommez-le 7stamp-card-events et copiez le URL généré.
- 2 Dans 7stamp Admin, ouvrez API & Integrations → Webhooks. Ajoutez cela URL et sélectionnez un petit ensemble d'événements, par exemple SCAN et REWARD_EARNED.
- 3 Créez un test de numérisation ou un événement de carte jetable dans 7stamp. Revenez à Make et utilisez Run once pour laisser Make déterminer la structure des données d'événement.
- 4 Ajoutez une étape de recherche CRM en utilisant external_id. Ajoutez un filtre ou un routeur sur event_type afin que SCAN, REWARD_EARNED et VOUCHER_ISSUED puissent effectuer différentes actions.
- 5 Ajoutez l'action CRM update/note. Mappez scanned_at, stamps_after, external_order_id et issued_vouchers uniquement lorsque ces champs sont présents pour le type d'événement sélectionné.
Vérifiez: Gardez le webhook URL privé. Testez un événement réel avant d'activer des messages irréversibles, des bons ou des modifications CRM.
Obtenez la clé 7stamp API avant d'ouvrir Make
Ce sont les écrans 7stamp Admin exacts. Créez la clé une fois, copiez-la dans la connexion sécurisée HTTP de Make, puis supprimez-la immédiatement de votre presse-papiers. Écran
Préparez la connexion avant de construire
Créez une clé API par environnement
Dans 7stamp Admin, allez dans API & Integrations → API Keys → Add API Key. Stockez la valeur dans la connexion à clé HTTP API de Make lorsque cette option est disponible. Ne mappez jamais la clé à partir d’un champ de texte, ne la placez jamais dans une note ou ne l’utilisez pas dans un flux de travail orienté navigateur. Une clé appartient à un 7stamp lieu de travail/profile.
Utiliser une stable External ID
Cartographier l'immuable ID à partir de votre CRM, POS ou de votre commerce plateforme – par exemple un CRM contact ID ou un client UUID. Ajoutez External Source tel que hubspot, shopify ou poster lorsque le même identifiant peut apparaître dans plusieurs systèmes.
Décidez quel modèle s'applique
Lorsque le profil 7stamp connecté a un modèle de carte actif, le modèle peut être laissé vide. Avec plusieurs modèles, mappez ou choisissez délibérément template_id afin que chaque invitation et analyse atteigne le programme de fidélité prévu.
Configuration exacte de Make HTTP: créez une invitation de carte
Copiez ceci dans votre étape d'automatisation
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
}Construisez et testez votre premier scénario Make
Dans 7stamp Admin, créez une clé dans API & Integrations → API Keys → Add API Key. Utilisez un profil de test distinct/key lorsque la configuration de votre compte le permet.
Dans Make, créez un scénario et ajoutez le déclencheur source. Exécutez-le une fois avant le mappage afin que vous puissiez voir un véritable exemple de contact ou de commande payée.
Cliquez sur le plus suivant, recherchez HTTP et choisissez Make une demande. Définissez la méthode, le URL complet et les en-têtes de la carte d'opération sur cette page.
Utilisez GET https://api.7loc.com/cards-api/templates comme première requête. Sa réponse réussie prouve que la clé fonctionne sans modifier les données client.
Pour les itinéraires POST, sélectionnez application/json et collez la forme du corps à partir de ce guide. Cartographier une écurie External ID; ajoutez template_id uniquement si le profil a plusieurs modèles actifs.
Exécutez avec un contact jetable, inspectez la sortie HTTP, puis mappez ensuite ses champs de réponse exacts dans le prochain CRM, e-mail ou module de messagerie.
Quand devez-vous utiliser Make HTTP?
Utilisez HTTP pour 7stamp maintenant: il s'agit de l'itinéraire documenté et prêt pour la production, et non d'une solution de secours réduite. Choisissez-le chaque fois que vous avez besoin d'une opération 7stamp, d'un nouvel itinéraire API ou d'une connexion personnalisée POS/ERP. La référence OpenAPI est la source de vérité pour la méthode, le chemin complet, le corps et le schéma de réponse; la clé du porteur et la base URL restent les mêmes.
Recevez les événements 7stamp dans Make
Pour un scénario basé sur les événements, ajoutez Webhooks → Custom webhook et créez un webhook. Copiez son URL, ouvrez API & Integrations → Webhooks dans le profil 7stamp, collez le URL, sélectionnez les types d'événements, enregistrez et envoyez un véritable événement de test. Le profil 7stamp est propriétaire de cet abonnement; l'actuel API n'expose pas les points de terminaison automatiques du webhook Subscribe/unsubscribe.
Aucun connecteur public Make n'est requis
Les instructions sur cette page utilisent les modules Make qui sont disponibles pour chaque compte Make. Si vous souhaitez un futur module natif 7stamp plutôt que HTTP, envoyez-nous le workflow dont vous avez besoin; jusque-là, les HTTP et Custom webhook couvrent toutes les opérations 7stamp documentées.
Questions fréquemment posées
Je ne trouve pas 7stamp dans Make. Puis-je encore l’automatiser?
Oui. Il n'y a pas d'application publique 7stamp dans Make aujourd'hui. Ajoutez HTTP > Make une requête, utilisez le point de terminaison 7stamp complet URL et envoyez Authorization: Bearer suivi de votre clé 7stamp API. HTTP peut appeler chaque point de terminaison documenté.
Où puis-je obtenir le token pour la connexion Make?
Dans 7stamp Admin, ouvrez API Intégrations, puis API Keys, puis Add API Key. La clé est limitée au lieu de travail/profile qui l'a créée, utilisez donc un profil de test pour les scénarios de test autant que possible.
Quel identifiant dois-je mapper comme External ID?
Utilisez l'identifiant stable du système source, de préférence un contact CRM ID ou un client UUID. N’utilisez pas de nom d’affichage. Un numéro de téléphone ou une adresse e-mail peuvent fonctionner, mais peuvent changer et doivent être traités de manière cohérente.
Comment puis-je obtenir les événements 7stamp dans Make?
Créez un Webhooks > Custom webhook dans Make, puis collez son URL généré dans les paramètres du webhook du profil 7stamp. Utilisez un filtre ou un routeur Make après la livraison pour gérer le event_type entrant.
Étape suivante
Prêt à automatiser la première action de fidélité?
Créez la clé API, testez List Templates et créez un scénario d'invitation ou d'analyse avec un contact jetable. Ajoutez des routeurs et des messages uniquement une fois que ce simple flux est fiable.