Quand un habitué revient, votre programme de fidélité le sait le premier : le scan au comptoir enregistre la visite et le passe dans son Apple Wallet ou son Google Wallet se met à jour. Les webhooks font en sorte que vos propres systèmes le sachent aussi, à la même seconde. Votre CRM, votre comptabilité, l’écran de l’arrière-boutique : chacun apprend la visite, la récompense et le paiement par carte cadeau sans que personne ne recopie un chiffre à la main.
Un scan au comptoir ajoute un tampon ou des points, et la carte se met à jour sur le téléphone du client.
Qu’est-ce qu’un webhook de programme de fidélité ?
Un webhook est un court message que Fideliya envoie à une adresse de votre propre serveur dès que quelque chose se passe dans votre programme. Votre développeur ajoute l’adresse dans votre tableau de bord Fideliya et choisit les événements qu’elle doit recevoir. Ensuite, à chaque fois qu’un de ces événements a lieu, Fideliya l’y envoie en JSON : ce qui s’est passé, quand, pour quel commerce, et les détails qui vont avec.
Rien ne change pour vos clients. Ils rejoignent votre programme en scannant le QR code au comptoir et en donnant un nom et un e-mail, et le passe arrive dans Apple Wallet ou Google Wallet, sans application à télécharger ni compte ou mot de passe à créer. Les webhooks circulent entre Fideliya et vos systèmes.
Tous les événements que Fideliya envoie
Voici les dix événements, sous les noms exacts auxquels votre développeur s’abonne.
| Événement | Quand il part | Ce qu’il vous apprend |
|---|---|---|
customer.created | Un client a rejoint l’un de vos passes | Qui : son nom, son e-mail, son téléphone s’il l’a donné, quel passe, et dans quel wallet il est allé |
scan.recorded | Un passe a été scanné au comptoir : une visite, des points, une récompense utilisée ou réclamée | Quel client, ce que le comptoir a fait, le nouveau total, les récompenses prêtes, le comptoir concerné, et le montant saisi avec un scan de points |
scan.voided | Un scan a été annulé au comptoir dans les secondes qui ont suivi, parce que c’était une erreur | Ce qui a été annulé (une visite, une récompense donnée, une récompense en points réclamée ou un paiement par carte cadeau) et le total ou le solde après l’annulation |
milestone.reached | Un client a atteint une récompense | Qui, le nom de la récompense, et combien de récompenses il a atteintes sur ce passe en tout |
referral.completed | Un ami parrainé a fait sa première visite, et chacun a gagné son bonus | Qui a amené qui, et le bonus gagné par chacun |
gift_card.sent | L’e-mail d’une carte cadeau a été accepté pour livraison, à l’émission ou à un nouvel envoi | Le destinataire, le montant, le solde, la devise, et s’il s’agit d’un nouvel envoi |
gift_card.spent | Un paiement a été pris sur une carte cadeau, au comptoir ou par l’API | Le montant pris, le solde restant, le comptoir, la référence de votre caisse quand elle en a donné une, et si c’est le scanner ou votre système qui l’a pris |
pass.created | Un nouveau modèle de passe a été créé | Le passe, son style, tampons (visites) ou points, et l’objectif d’une récompense |
subscription.created | Votre abonnement Fideliya a commencé | L’offre, son statut, la période en cours, et s’il s’agit d’un essai |
subscription.cancelled | Votre abonnement Fideliya a été annulé | Quand il a été annulé |
Les deux événements d’abonnement concernent le compte : chaque adresse de votre compte les reçoit, quel que soit le commerce auquel elle appartient.
Deux autres que votre développeur rencontrera
webhook.test est ce qu’envoie le bouton d’événement de test de votre tableau de bord : il ne vient jamais d’une action réelle, votre développeur peut donc vérifier la connexion sans client au comptoir. webhook.ping est un contrôle que Fideliya envoie à une adresse qu’il a dû mettre en pause ; votre serveur n’a qu’à y répondre par un succès.
Quatre choses à construire avec les webhooks et vos propres systèmes
Aucune ne demande autre chose que les webhooks de Fideliya et les systèmes que vous utilisez déjà.
- Un remerciement depuis votre propre CRM quand un habitué atteint une récompense. Gardez chaque
customer.createddans votre CRM sous son identifiant client. Quandmilestone.reachedarrive avec le même identifiant et le nom de la récompense, votre CRM envoie le remerciement que vous avez écrit, depuis votre propre adresse. Le message et son moment vous appartiennent. - Des ventes par carte cadeau qui se rapprochent seules. Chaque
gift_card.spentporte le montant, le solde restant, le comptoir et, quand votre caisse a pris le paiement par l’API, son propre numéro de ticket. Rapprochez-le des tickets du jour et la ligne cartes cadeaux de votre comptabilité se ferme sans comptage à la main. Un paiement annulé à la caisse suit sous la forme descan.voided: l’annulation arrive dans le même registre. - Un écran des scans par établissement.
scan.recordednomme le comptoir de chaque scan. Comptez-les par établissement au fil de la journée et vous avez un tableau en direct de chaque boutique,scan.voidedretirant les erreurs. - Une liste de remerciements pour votre équipe.
referral.completednomme le client qui a amené un ami. Une liste dans votre propre système dit à votre équipe qui remercier de vive voix à sa prochaine visite.
Comment se comportent les envois
Chaque envoi est signé avec le secret de votre adresse, au format Standard Webhooks, pour que votre système vérifie qu’il vient de Fideliya avant de s’y fier. Chaque événement porte un identifiant qui reste le même à chaque tentative : gardez-le, et vous ne comptez jamais deux fois la même visite.
Si votre serveur est en panne ou répond par une erreur, Fideliya réessaie, en espaçant les tentatives sur environ une journée. Une adresse qui échoue pendant des jours est mise en pause. Fideliya la vérifie alors avec webhook.ping et, après deux réponses réussies d’affilée, la remet en service et rejoue ce qu’elle a manqué.
Quelle offre, et par où votre développeur commence
Les webhooks sont inclus dans l’offre Enterprise, à partir de 99,99 € par mois ou 79,99 € par mois en paiement annuel, avec l’API de Fideliya, des clients et des établissements illimités, et 10 sièges d’équipe. La référence complète, avec chaque champ de chaque événement, un exemple de chacun et son JSON Schema, est dans la documentation des webhooks.
Si votre caisse doit aussi écrire dans votre programme, enregistrer les visites et prendre les paiements par carte cadeau, c’est le rôle de l’API : ce qu’elle change pour un commerçant est dans ce qu’une API publique change pour un petit programme de fidélité, et la version courte sur relier Fideliya à votre caisse. Chaque offre et chaque prix sont sur la page des tarifs.