Quando un cliente abituale torna, il tuo programma fedeltà lo sa per primo: la scansione al banco registra la visita e la tessera nel suo Apple Wallet o Google Wallet si aggiorna. I webhook fanno sì che lo sappiano anche i tuoi sistemi, nello stesso secondo. Il tuo CRM, la tua contabilità, lo schermo nel retro: ognuno viene a sapere della visita, del premio e del pagamento con carta regalo senza che nessuno ricopi un numero a mano.
Una scansione alla cassa aggiunge un timbro o dei punti, e la tessera si aggiorna sul telefono del cliente.
Cos’è un webhook di un programma fedeltà?
Un webhook è un breve messaggio che Fideliya invia a un indirizzo del tuo server nel momento in cui succede qualcosa nel tuo programma. Il tuo sviluppatore aggiunge l’indirizzo nella dashboard di Fideliya e sceglie gli eventi che deve ricevere. Da lì in poi, ogni volta che uno di questi eventi accade, Fideliya lo invia lì in JSON: cosa è successo, quando, per quale attività e i dettagli che lo accompagnano.
Per i tuoi clienti non cambia nulla. Si iscrivono scansionando il codice QR al banco e lasciando un nome e un’email, e la tessera arriva in Apple Wallet o Google Wallet, senza app da scaricare né account o password da creare. I webhook passano tra Fideliya e i tuoi sistemi.
Tutti gli eventi che Fideliya invia
Ecco i dieci eventi, con i nomi esatti a cui si iscrive il tuo sviluppatore.
| Evento | Quando viene inviato | Cosa ti dice |
|---|---|---|
customer.created | Un cliente si è iscritto a una delle tue tessere | Chi: nome, email, telefono se l’ha dato, quale tessera e in quale wallet è finita |
scan.recorded | Una tessera è stata scansionata al banco: una visita, punti, un premio usato o riscattato | Quale cliente, cosa ha fatto il banco, il nuovo totale, i premi pronti, il banco in cui è successo e l’importo inserito con una scansione a punti |
scan.voided | Una scansione è stata annullata al banco pochi secondi dopo, perché era un errore | Cosa è stato annullato (una visita, un premio dato, un premio a punti riscattato o un pagamento con carta regalo) e il totale o il saldo dopo l’annullamento |
milestone.reached | Un cliente ha raggiunto un premio | Chi, il nome del premio e quanti premi ha raggiunto in tutto su quella tessera |
referral.completed | Un amico invitato ha fatto la sua prima visita, quindi entrambi hanno ottenuto il loro bonus | Chi ha portato chi e il bonus ottenuto da ciascuno |
gift_card.sent | L’email di una carta regalo è stata accettata per la consegna, all’emissione o a un nuovo invio | Il destinatario, l’importo, il saldo, la valuta e se si tratta di un nuovo invio |
gift_card.spent | È stato preso un pagamento da una carta regalo, al banco o tramite l’API | L’importo preso, il saldo rimasto, il banco, il riferimento della tua cassa quando l’ha dato e se l’ha preso lo scanner o il tuo sistema |
pass.created | È stato creato un nuovo modello di tessera | La tessera, il suo stile, timbri (visite) o punti, e l’obiettivo per un premio |
subscription.created | Il tuo abbonamento a Fideliya è iniziato | Il piano, il suo stato, il periodo in corso e se è una prova |
subscription.cancelled | Il tuo abbonamento a Fideliya è stato annullato | Quando è stato annullato |
I due eventi di abbonamento riguardano l’account: li riceve ogni indirizzo del tuo account, qualunque sia l’attività a cui appartiene.
Altri due che il tuo sviluppatore incontrerà
webhook.test è ciò che invia il pulsante dell’evento di prova nella tua dashboard: non nasce mai da un’azione reale, così il tuo sviluppatore può controllare il collegamento senza un cliente al banco. webhook.ping è un controllo che Fideliya invia a un indirizzo che ha dovuto mettere in pausa; al tuo server basta rispondere con un successo.
Quattro cose da costruire con i webhook e i tuoi sistemi
Nessuna richiede altro che i webhook di Fideliya e i sistemi che usi già.
- Un grazie dal tuo CRM quando un cliente abituale raggiunge un premio. Conserva ogni
customer.creatednel tuo CRM con il suo identificativo cliente. Quando arrivamilestone.reachedcon lo stesso identificativo e il nome del premio, il tuo CRM invia il ringraziamento che hai scritto, dal tuo indirizzo. Il messaggio e il momento sono tuoi. - Vendite con carta regalo che si riconciliano da sole. Per le carte regalo di Fideliya, ogni
gift_card.spentporta l’importo, il saldo rimasto, il banco e, quando la tua cassa ha preso il pagamento tramite l’API, il suo numero di scontrino. Confrontalo con gli scontrini del giorno e la voce carte regalo della tua contabilità si chiude senza contare a mano. Un pagamento annullato alla cassa arriva dopo comescan.voided, così l’annullamento finisce nello stesso registro. - Uno schermo delle scansioni per sede.
scan.recordedindica il banco di ogni scansione. Contale per sede durante la giornata e hai un quadro in diretta di come va ogni negozio, conscan.voidedche toglie gli errori. - Una lista di ringraziamenti per il tuo team.
referral.completedindica il cliente che ha portato un amico con Porta un amico. Una lista nel tuo sistema dice al tuo team chi ringraziare di persona alla sua prossima visita.
Come si comportano gli invii
Ogni invio è firmato con il segreto del tuo indirizzo, nel formato Standard Webhooks, così il tuo sistema controlla che arrivi da Fideliya prima di fidarsi. Ogni evento porta un identificativo che resta lo stesso a ogni tentativo: conservalo e non conterai mai due volte la stessa visita.
Se il tuo server è giù o risponde con un errore, Fideliya riprova, distanziando i tentativi nell’arco di circa un giorno. Un indirizzo che fallisce per giorni viene messo in pausa. Fideliya lo controlla allora con webhook.ping e, dopo due risposte riuscite di fila, lo riattiva e gli invia ciò che ha perso.
Quale piano, e da dove parte il tuo sviluppatore
I webhook sono inclusi nel piano Enterprise, a partire da 99,99 € al mese o 79,99 € al mese con pagamento annuale, insieme all’API di Fideliya, clienti e sedi illimitati e 10 posti per il team. Il riferimento completo, con ogni campo di ogni evento, un esempio di ciascuno e il suo JSON Schema, è nella documentazione dei webhook.
Se anche la tua cassa deve scrivere nel tuo programma, registrare le visite e prendere i pagamenti con carta regalo, quello è il compito dell’API: cosa cambia per un titolare è in cosa cambia un’API pubblica per un piccolo programma fedeltà, e la versione breve su collegare Fideliya alla tua cassa. Ogni piano e ogni prezzo sono nella pagina dei prezzi.