Intégration des développeurs

7stamp Webhooks

Disponible

Poussez chaque événement de fidélité de 7stamp vers vos propres systèmes en temps réel. Pas d'interrogation et pas d'appels API programmés. Les événements arrivent sous la forme de requêtes HTTPS POST quelques secondes après leur apparition.

Utilisez des webhooks pour synchroniser votre CRM, ERP ou votre backend personnalisé avec ce qui se passe du côté de la fidélité: qui a rejoint, qui a reçu un tampon, qui a utilisé un bon d'achat, qui a déclenché un cadeau d'anniversaire et qui est devenu inactif. Ensuite, vos systèmes décident quoi faire de ces données.

Ce que vous pouvez faire avec les webhooks

Les webhooks sont le côté sortant de la pile d'intégration. Ils reflètent l'activité des clients et des récompenses dans les systèmes auxquels vous faites déjà confiance pour les ventes, le service, l'analyse et la messagerie.

Mettez en miroir l'historique de fidélité dans votre CRM

Chaque tampon, bon, anniversaire et déclencheur d'inactivité atterrit sur le dossier client dans votre CRM. Vous voyez la chronologie complète de la fidélité à côté des ventes, des appels et des billets sans vous connecter au 7stamp.

Déclenchez votre propre pile de messagerie

Lorsqu'un client utilise un bon, envoyez un remerciement SMS depuis votre passerelle SMS existante. Lorsqu'un client atteint l'objectif, publiez une célébration dans Slack. Lorsqu'une personne devient inactive, acheminez le dossier vers votre responsable de compte.

Analyse puissante et rapprochement

Diffusez les événements dans votre outil BI, votre entrepôt ou votre pipeline de rapprochement. Faites correspondre les échanges de bons avec les reçus POS et calculez la fidélité ROI selon vos propres mesures.

Types d'événements de carte

SCAN — Une carte a reçu une action scan/stamp.
REWARD_EARNED — Une récompense a été gagnée sur la carte.
VOUCHER_ISSUED — Un bon a été émis.
VOUCHER_REDEEMED — Un bon a été utilisé.
LOTTERY_WIN — Une loterie a donné lieu à un gain.
DELIVERY_INSERT — Un flux d'insertion de livraison a été enregistré.
CARD_JOINED — Un client a rejoint une carte.
CARD_CAMPAIGN — Un événement de campagne de cartes s'est produit.
BIRTHDAY_GREETING — Un événement de vœux d'anniversaire s'est produit.
ADMIN_VOUCHER_ISSUE — Un administrateur a émis un bon.
CARD_ADDED_TO_WALLET — Un client a ajouté la carte à son portefeuille.
CARD_REMOVED_FROM_WALLET — Un client a retiré la carte de son portefeuille.

Créer un récepteur webhook sécurisé

Accuser réception après une manipulation durable

Votre point de terminaison doit accepter HTTPS POST, validez la forme de la requête, conservez ou mettez l'événement en file d'attente, puis renvoyez une réponse 2xx réussie. Ne passez pas d'appel lent CRM ou de messagerie avant l'accusé de réception s'il peut être mis en file d'attente en toute sécurité.

Corréler avec External ID

Chaque événement associé peut porter le External ID et le External Source en option que vous avez utilisés lors de la création ou de la numérisation de la carte. Utilisez cette paire pour mettre à jour votre propre CRM, POS ou votre enregistrement de commande sans deviner à partir d'un nom ou d'un e-mail.

Make livraison idempotente

Stockez une clé de traitement durable ou une empreinte digitale d'événement avant de déclencher des effets secondaires. If your receiver sees the same delivery again, it should not add a duplicate CRM note, voucher, or message. Traitez le point de terminaison URL comme un secret.

Exemple de forme de charge utile d'événement

Copiez ceci dans votre étape d'automatisation json
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

Configurer et tester un webhook

01

Créez un point de terminaison HTTPS dans votre backend, une couche d'intégration CRM, un webhook Make ou Zapier Catch Hook. Make assurez-vous de contrôler la destination avant de copier son URL.

02

Dans 7stamp Admin, ouvrez Stamp Cards → API & Integrations → Webhooks.

03

Ajoutez le point de terminaison URL et sélectionnez uniquement les types d'événements dont le workflow de réception a réellement besoin.

04

Enregistrez les paramètres du profil, puis déclenchez une analyse de test jetable ou une action de carte pour produire un événement.

05

Inspectez la charge utile reçue. Faites correspondre External ID et External Source à l'enregistrement attendu et confirmez que le récepteur renvoie une réponse réussie.

06

Activez CRM, le bon ou les effets secondaires de messagerie uniquement après avoir géré et surveillé les échecs en toute sécurité.

Options sans code: Make et Zapier

Dans Make, utilisez Webhooks → Custom webhook pour générer un URL de réception et collez-le dans le 7stamp profil. Dans Zapier, utilisez Webhooks by Zapier → Catch Hook dans le même but. Le profil 7stamp est propriétaire de l'abonnement car le API actuel n'expose pas les points de terminaison d'enregistrement automatique des webhooks.

Contrat de sécurité et de livraison

Utilisez la section Webhooks de la référence publique OpenAPI comme source du schéma de charge utile actuel et de la signification du champ. Exigez HTTPS, gardez le récepteur URL hors des journaux publics et rendez le traitement idempotent. Confirmez la procédure de demande d'authentification/signature pour votre profil 7stamp lors de l'intégration avant d'appliquer un nom d'en-tête spécifique ou une politique de nouvelle tentative en production.

Questions fréquemment posées

Puis-je sélectionner uniquement certains événements de webhook?

Oui. Sélectionnez les types d'événements dans les paramètres du webhook du profil 7stamp afin que le destinataire reçoive uniquement les événements importants pour son flux de travail.

Comment connecter des webhooks à Make ou Zapier?

Créez le webhook de réception dans Make ou un Catch Hook dans Zapier, copiez le URL généré, puis collez-le dans les paramètres du webhook du profil 7stamp et envoyez un événement de test.

Comment dois-je associer un événement à mon contact CRM?

Utilisez External ID et, le cas échéant, External Source. Il s'agit des identifiants fournis par votre intégration lors de la création ou du scan de la carte.

Dois-je supposer un en-tête de signature ou un timing de nouvelle tentative?

Non. Utilisez le contrat de livraison OpenAPI/profile actuel et confirmez la procédure d'authentification de votre profil lors de l'intégration avant de coder en dur un en-tête ou de réessayer.

Étape suivante

Prêt à envoyer le premier événement de carte?

Créez un récepteur, collez son HTTPS URL dans le profil, exécutez une analyse jetable et validez le External ID correspondant avant d'activer l'automatisation en aval.