Créez une invitation à partir d'un contact CRM
Déclenchez un contact nouveau ou qualifié, mappez son CRM ID à External ID, créez une invitation par carte et transmettez l'installation renvoyée URL à un e-mail ou étape SMS.
Guide d'automatisation sans code
Connectez 7stamp à Zapier — étape par étape
Guide d'implémentationUtilisez Zapier lorsque votre flux de travail est une séquence claire: un contact ou une commande apparaît, 7stamp effectue une action, puis un autre outil métier est mis à jour. L'itinéraire sécurisé aujourd'hui est API par Zapier pour les appels sortants 7stamp API et Webhooks by Zapier → Catch Hook pour les événements entrants 7stamp.
Il n'y a pas d'application publique 7stamp sur le marché de Zapier. Utilisez API by Zapier → API Request là où il est disponible: il stocke une clé statique API dans la connexion de l'application au lieu de l'exposer dans une étape Zap. Utilisez Webhooks by Zapier uniquement pour les événements Catch Hook entrants; ne placez pas de clé 7stamp Bearer dans un champ d'action Webhooks visible.
Commencez avec un Zap linéaire et testable
Gardez le premier Zap petit. Un flux fiable de contact vers carte ou de commande payante vers timbres est un meilleur point de départ qu'une large synchronisation bidirectionnelle CRM.
Ajoutez des tampons après le paiement
Déclenchez à partir de la commande payée ou du reçu fermé, mappez l'identité du client et commandez ID, puis utilisez Scan Card avec le montant de la commande ou le nombre explicite de tampons.
Émettez un bon de récupération unique
Utilisez une règle CRM, un événement d'assistance ou une exportation de segment pour identifier un client, émettre un bon sur sa carte et envoyer un message de suivi à partir du canal approprié.
Écrivez les événements de carte sur votre CRM
Utilisez Webhooks by Zapier > Catch Hook pour recevoir des événements de carte 7stamp. Faites correspondre le External ID renvoyé à l'enregistrement CRM et ajoutez la note, la balise ou la tâche appropriée.
7stamp opérations à appeler depuis API par Zapier
Ajouter API by Zapier → API Request après votre déclencheur. Créez une connexion à clé 7stamp API, puis sélectionnez la méthode exacte et le URL complet ci-dessous. Chaque opération renvoie des champs que vous pouvez mapper à l'étape Zap suivante.
API par Zapier action
POST /cards/invite Créer Card Invite
Crée une nouvelle installation de carte de portefeuille URL et un code d'insertion de livraison pour un contact externe.
- Requis
- external_id à partir du déclencheur CRM/contact.
- Étape suivante
- Mappez install_url dans un e-mail, SMS ou un champ CRM.
API par Zapier action
POST /cards/invite/bulk Création groupée de Card Invites
Crée jusqu'à 100 liens d'invitation à partir d'un lot JSON contrôlé.
- Tableau d'éléments
- requis avec 1 à 100 objets d'invitation.
- Vérifiez
- Lisez success_count, error_count et chaque résultat avant la livraison.
API par Zapier action
POST /cards/scan Scan Card
Ajoute des timbres par User Card ID ou External ID, avec montant, nombre de timbres, commande ID et données de réception facultatives.
- Identité
- external_id plus facultatif external_source; user_card_id gagne si les deux sont présents.
- La règle du timbre
- stamps_count est prioritaire sur le montant.
API par Zapier action
POST /vouchers/issue Issue Voucher
Émet un bon directement au titulaire de la carte.
- Bon
- requis.short_description et une cible external_id ou connue user_card_id.
- Résultat
- Mapper unique_code, statut ou expires_at à une note ou un message CRM.
API par Zapier action
POST /messages/send Send Message
Envoie le contenu d'un push de carte de portefeuille et/or d'e-mail à un propriétaire de carte.
- Card Push
- card_push_text est limité à 20 caractères.
- sujet et corps; le résultat indique si la livraison a été mise en file d'attente.
API par Zapier action
GET /cards Find Cards
Recherche les enregistrements de carte par External ID, avec des filtres de source et de modèle en option.
- Requis
- external_id comme paramètre de requête.
- À utiliser en premier
- À utiliser avant de créer une invitation lorsque votre règle évite les invitations en double.
API par Zapier action
GET /cards/{user_card_id} Obtenir les détails de la carte
Lit l'état d'une carte par son 7stamp interne ID.
- Obligatoire
- Remplacez {user_card_id} par un ID renvoyé par 7stamp.
- Sortie utile
- stamps_count, état du portefeuille et active_vouchers_count.
API par Zapier action
GET /templates List Templates
Répertorie les modèles disponibles pour le profil connecté et vérifie la connexion API.
- Premier test
- Appelez-le avant toute action d'écriture: il ne modifie aucune donnée client.
- Utiliser plus tard
- Un identifiant actif devient template_id lorsque plusieurs modèles existent.
API par Zapier action
GET /templates/{template_id}/design Get Template Design
Récupère les paramètres de conception d'un modèle pour un modèle connu ID.
Zapier le déclencheur
Webhooks by Zapier → Catch Hook Recevoir les événements de la carte
Catch Hook donne à Zapier un HTTPS URL unique. Collez-le dans les paramètres du webhook 7stamp Admin et testez-le avec un véritable événement de carte.
- Dans Zapier
- Utilisez Catch Hook pour les données d'événement analysées; utilisez Catch Raw Hook uniquement lorsque vous avez également besoin d'en-têtes de requête bruts/body.
- Match
- Recherchez le contact CRM en utilisant external_id et facultatif external_source de l'événement.
Trois workflows Zapier que vous pouvez créer étape par étape
Chaque scénario utilise un module Zapier réel et actuellement disponible. Construisez d'abord un petit itinéraire et testez-le avec un contact jetable avant d'allumer le Zap.
1. Contact CRM qualifié → émettre une carte
Résultat attendu: L'étape Zap suivante reçoit install_url et peut l'envoyer au client ou la réécrire dans l'enregistrement CRM.
- 1 Créez un Zap et sélectionnez l'événement CRM qui signifie qu'un contact est éligible à la fidélité. Testez le déclencheur et confirmez que vous disposez du ID immuable du contact.
- 2 Ajoutez API by Zapier → API Request. Créez ou sélectionnez la connexion clé 7stamp API, choisissez POST et définissez URL sur https://api.7loc.com/cards-api/cards/invite.
- 3 Réglez le corps sur JSON. Mappez le CRM ID dans external_id, définissez un external_source fixe tel que kommo et ajoutez template_id uniquement lorsque plusieurs modèles 7stamp sont actifs.
- 4 Testez l'action. Confirmez que la réponse contient install_url et delivery_insert_code pour le même external_id.
- 5 Ajoutez votre action CRM Mise à jour, e-mail ou SMS. Carte install_url de la réponse API; ne codez pas en dur et ne copiez pas un test URL.
Vérifiez: Créer Card Invite renvoie toujours une nouvelle invitation. Ajoutez d'abord une demande Find Cards ou un filtre Zapier si votre politique est d'une invitation par contact.
2. Commande payée → timbres d'attribution
Résultat attendu: La commande crée un scan traçable 7stamp et le Zap peut enregistrer stamps_added ou scan_id dans le système source.
- 1 Utilisez un déclencheur de commande payée/Closed Réception et testez-le. Confirmez que le client ID et la commande unique ID sont tous deux présents avant de continuer.
- 2 Ajoutez API by Zapier → API Request avec POST https://api.7loc.com/cards-api/cards/scan et sélectionnez la même connexion 7stamp.
- 3 Envoyez JSON avec external_id, external_source, external_order_id et soit le montant pour les modèles basés sur le montant, soit stamps_count pour une attribution de timbre explicite.
- 4 Testez avec une commande jetable. Inspectez le succès, scan_id et stamps_added dans la réponse.
- 5 Ajoutez un filtre qui ne continue qu'après une réponse réussie, puis mettez à jour la commande/CRM avec le résultat confirmé.
Vérifiez: Si le Zap est relu, vérifiez la commande d'origine avant d'envoyer un autre scan. Gardez external_order_id stable afin que l'événement puisse être réconcilié plus tard.
3. Événement 7stamp → créer une note ou une tâche CRM
Résultat attendu: Zapier reçoit un événement 7stamp analysé, trouve le client par external_id et crée l'événement approprié suivi.
- 1 Créez un nouveau Zap avec Webhooks by Zapier comme déclencheur. Sélectionnez Catch Hook, continuez et copiez l'unique URL affiché à l'étape de test.
- 2 Dans 7stamp Admin, ouvrez API & Integrations → Webhooks, ajoutez le Catch Hook URL, sélectionnez uniquement les types d'événements nécessaires et enregistrez.
- 3 Provoque un véritable test de numérisation ou un événement de carte. De retour dans Zapier, cliquez sur Test trigger et confirmez que event_type, external_id et external_source arrivent comme exemples de champs.
- 4 Ajoutez une action CRM Rechercher un contact à l'aide de external_id. Ajoutez une règle de filtre ou de chemins pour event_type, par exemple séparez SCAN de REWARD_EARNED.
- 5 Créez une note CRM/task et mappez uniquement les champs qui existent pour cet événement, tels que scanned_at, stamps_after, external_order_id ou issued_vouchers.
Vérifiez: Un Catch Hook URL est un secret. Si le Zap est transféré à un autre propriétaire, mettez à jour le URL dans 7stamp Admin avant de vous y fier.
Créez la clé 7stamp API avant de construire le Zap
Ce sont les étapes secondaires 7stamp. Faites-le une fois, puis utilisez la clé uniquement à l'intérieur de la connexion API par Zapier, pas dans un champ d'action Webhooks by Zapier ou dans une note.
Règles de connexion qui empêchent les incompatibilités de données
Conservez la clé API dans une connexion API par Zapier
Dans 7stamp Admin, choisissez API & Integrations → API Keys → Add API Key. Dans API par Zapier, créez une connexion de clé API avec un en-tête statique Authorization contenant Bearer suivi de cette clé. API par Zapier conserve les informations d'identification dans la connexion au lieu d'une étape Zap visible; restreindre l’accès à la connexion et faire pivoter la clé si elle est exposée.
Mapper External ID et External Source de manière cohérente
External ID est votre propre identifiant client stable; External Source étiquettes d'où il vient, par exemple hubspot, bitrix24, shopify ou poster. Utilisez la même paire pour les flux de création, de recherche, d’analyse, de bon et de webhook.
Sachez quel identifiant de carte gagne
Les actions de ciblage de cartes acceptent User Card ID ou External ID. Lorsque les deux sont présents, User Card ID est prioritaire. Utilisez le ID interne uniquement après qu'il ait été renvoyé par une étape 7stamp de confiance; sinon préférez le système source External ID.
Exact API par Zapier demande: attribuez un timbre
Copiez ceci dans votre étape d'automatisation
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"
}Construisez votre premier Zap
Créez une clé 7stamp API dans Admin: API & Integrations → API Keys → Add API Key. Utilisez une clé de test distincte/profile lorsqu'elle est disponible.
Dans Zapier, créez un Zap et testez le déclencheur source. Utilisez un échantillon réel afin que le contact ID, le client ID, la commande ID et le montant soient disponibles pour le mappage.
Ajoutez API by Zapier → API Request. Créez une connexion 7stamp pour l'en-tête statique Bearer Authorization plutôt que de mettre le secret dans un champ d'action Webhooks by Zapier.
Appelez d'abord le GET https://api.7loc.com/cards-api/templates. Cela confirme le fonctionnement de la clé et montre quels ID de modèle actifs sont disponibles sans modifier les données client.
Sélectionnez POST /cards/invite ou POST /cards/scan, définissez JSON comme type de corps et mappez les champs stables External ID plus le modèle approprié/order déclencheur.
Exécutez l'action avec un contact jetable, inspectez ses champs de réponse exacts, puis mappez ces champs à l'étape suivante CRM, e-mail ou messagerie avant de publier le Zap.
Utilisez la requête universelle uniquement pour les itinéraires documentés
Utilisez API par Zapier pour une requête 7stamp avec une clé Bearer API: elle conserve les clés d'en-tête statiques dans une connexion d'application. Utilisez Webhooks by Zapier pour la diffusion de l'événement Catch Hook, et non comme emplacement préféré pour un secret 7stamp. Conservez la base URL à https://api.7loc.com/cards-api,, utilisez la référence publique OpenAPI pour les schémas exacts et n'envoyez jamais d'informations d'identification ou de données client à un URL non vérifié.
Recevez des événements 7stamp via Catch Hook
Créez Webhooks by Zapier → Catch Hook, copiez le URL unique affiché dans la configuration de test, collez-le dans les paramètres du webhook du profil 7stamp, sélectionnez les types d'événements, puis envoyez un véritable test de numérisation ou un événement de carte. Utilisez les données utiles External ID et External Source de la charge utile de l'événement pour localiser le bon contact CRM. Choisissez Catch Raw Hook uniquement lorsque vous avez spécifiquement besoin du corps non analysé et des en-têtes de requête.
Utilisez maintenant l'itinéraire sécurisé Zapier
API par Zapier et Catch Hook sont suffisants pour chaque opération publique 7stamp API et événement de carte. Si vous avez besoin d'une future application native 7stamp Zapier, envoyez-nous l'action exacte/trigger que votre équipe utilise le plus.
Questions fréquemment posées
Où puis-je trouver l'application 7stamp dans Zapier?
Il n'existe pas d'application de marché publique 7stamp aujourd'hui. Utilisez API by Zapier → API Request pour les appels 7stamp API et Webhooks by Zapier → Catch Hook pour les événements 7stamp entrants.
Où puis-je créer le jeton Zapier?
Créez une clé 7stamp API dans l'administrateur sous API & Integrations → API Keys → Add API Key. Stockez-le comme un en-tête statique Bearer Authorization dans la connexion API par Zapier, et non dans un champ d'action Webhooks by Zapier visible.
How can Zapier receive a stamp or voucher event?
Créez un Catch Hook dans Webhooks by Zapier, collez le URL généré dans les paramètres du webhook du profil 7stamp, sélectionnez les événements et envoyez un événement de test avant d'activer les mises à jour CRM.
Dois-je choisir Zapier ou Make?
Choisissez Zapier pour un flux de travail de déclenchement-action principalement linéaire. Choisissez Make lorsque vous avez besoin de routeurs, de transformations complexes ou de longs scénarios multibranches. Les deux utilisent la même clé 7stamp API et les mêmes points de terminaison.
Étape suivante
Construire le premier Zap avec un contact test
Créer la clé API, tester GET /templates à API par Zapier, puis créez une action de contact vers la carte ou de commande vers les tampons. Ajoutez le Catch Hook une fois que le flux sortant a un résultat de test prouvé.