Integrazione con

Webhooks

Cosa sono i webhook Yalt?

I webhook Yalt sono callback HTTP in tempo reale che notificano i tuoi sistemi all'istante quando avvengono eventi nei programmi di fidelizzazione. Invece di interrogare di continuo l'API Yalt, i webhook inviano notifiche al tuo server nel momento in cui succede qualcosa: un cliente guadagna punti, riscatta una ricompensa, avanza di livello o qualsiasi altro evento significativo. Ogni webhook consegna un payload JSON strutturato con i dettagli completi dell'evento, così i tuoi sistemi possono reagire subito e automatizzare i flussi nello stack. I webhook supportano retry, verifica della firma per la sicurezza e tipi di evento completi su tutta l'attività del programma di fidelizzazione.

Perché usare i webhook Yalt?

I webhook abilitano architetture event-driven in cui le attività di fidelizzazione attivano automaticamente azioni nei sistemi aziendali. Elimini inefficienza e latenza delle integrazioni basate su polling e ottieni esperienze cliente davvero in tempo reale. Quando un cliente riscatta una ricompensa, i webhook possono avvisare subito il sistema di fulfillment. Quando si guadagnano punti, possono attivare conferme in app o aggiornare le dashboard cliente. Quando le campagne automatiche inviano messaggi, possono loggare l'attività nel CRM. Questo approccio event-driven consente di costruire ecosistemi di fidelizzazione reattivi, in cui i sistemi reagiscono al comportamento nel momento in cui avviene, creando esperienze fluide che aumentano engagement e soddisfazione.

Come funzionano le integrazioni webhook

Configurare i webhook significa registrare i tuoi endpoint server su Yalt e scegliere quali eventi del programma di fidelizzazione ricevere. Quando quegli eventi avvengono — una transazione elaborata, punti assegnati, una ricompensa riscattata, un avanzamento di livello o una campagna automatica attivata — Yalt invia subito una POST HTTP agli endpoint registrati, con un payload JSON strutturato e i dettagli completi. Il tuo server elabora il payload e agisce: aggiorna display, attiva workflow, logga attività o avvia processi nei sistemi collegati. Il sistema webhook di Yalt include retry automatici con backoff esponenziale se l'endpoint è temporaneamente non disponibile, garantendo una consegna affidabile anche durante manutenzioni o picchi di traffico.

Tipi di evento webhook completi

Eventi cliente: Ricevi notifiche quando i clienti vengono creati, aggiornati o eliminati. Traccia i cambiamenti a profili, contatti, preferenze o attributi custom per tenere tutti i sistemi sincronizzati.

Eventi transazione: Ricevi notifiche immediate quando le transazioni vengono elaborate nei programmi di fidelizzazione. Il payload include importi, articoli acquistati, metodi di pagamento e ricompense calcolate.

Eventi punti: Ricevi aggiornamenti in tempo reale quando i clienti guadagnano punti, li riscattano, ricevono punti bonus o subiscono aggiustamenti. Traccia lo storico completo dei punti nello stack.

Eventi carta fedeltà: Ricevi notifiche quando le carte fedeltà digitali vengono emesse, attivate, aggiornate o disattivate. Monitora uso e cambi di stato in tempo reale.

Eventi ricompensa: Ricevi notifiche immediate quando le ricompense vengono emesse, riscattate o scadono. Il payload include dettagli della ricompensa, timestamp di riscatto e informazioni cliente per i processi di fulfillment.

Eventi di avanzamento di livello: Ricevi notifiche quando i clienti avanzano o retrocedono nei livelli di fidelizzazione. Attiva messaggi di congratulazioni, aggiorna i sistemi di customer service o regola i prezzi in tempo reale.

Eventi carta a timbri: Ricevi notifiche quando vengono emessi timbri, le carte a timbri vengono completate o si guadagnano ricompense tramite questi programmi. Abilita il fulfillment immediato delle ricompense delle carte a timbri.

Eventi cashback: Ricevi aggiornamenti immediati quando il cashback viene guadagnato, riscattato o aggiustato. Sincronizza i saldi cashback su tutti i touchpoint in tempo reale.

Eventi campagna: Ricevi notifiche quando le campagne automatiche vengono attivate, i messaggi inviati o gli obiettivi raggiunti. Logga l'attività di marketing in CRM o piattaforme di analytics.

Eventi segmento: Ricevi notifiche quando i clienti entrano o escono dai segmenti, per aggiustamenti immediati di personalizzazione basati sui cambiamenti di comportamento.

Eventi coupon: Ricevi notifiche immediate quando i codici sconto vengono generati, usati o scadono. Traccia l'utilizzo e previeni le frodi tra i sistemi.

Eventi analytics: Ricevi notifiche quando si raggiungono metriche o soglie chiave: traguardi del programma, target di ricavo o benchmark di engagement.

Capacità webhook enterprise

Verifica della firma: Ogni webhook include una firma crittografica che consente ai tuoi sistemi di verificarne l'autenticità e prevenire spoofing o manomissioni.

Retry automatici: Le consegne fallite vengono ritentate automaticamente con backoff esponenziale, così gli eventi arrivano anche durante outage temporanei o manutenzioni.

Filtro degli eventi: Iscriviti solo ai tipi di evento rilevanti per la tua integrazione, riducendo rumore e overhead di elaborazione.

Personalizzazione del payload: Configura quali campi includere nei payload per ottimizzare la dimensione e inviare solo le informazioni necessarie.

Endpoint multipli: Registra più endpoint per instradare tipi di evento diversi a sistemi specializzati: transazioni alle analytics, ricompense al fulfillment, campagne al CRM.

Monitoraggio e log: Accedi a log completi di consegna con stato, response code, tentativi di retry e dettagli del payload, per troubleshooting e audit.

Rate limiting: Le consegne rispettano limiti di rate configurabili per non saturare i sistemi riceventi nei periodi di alto volume.

Modalità test: Testa le integrazioni webhook in ambienti sandbox prima della produzione, senza impattare i programmi di fidelizzazione live.

Vantaggi strategici dell'integrazione

• Abilita esperienze in tempo reale reagendo subito agli eventi di fidelizzazione su tutti i touchpoint
• Elimina overhead di polling e costi di chiamate API ricevendo push invece di controlli continui
• Costruisci architetture event-driven in cui le attività di fidelizzazione attivano automaticamente i workflow tra i sistemi
• Riduci la complessità iscrivendoti agli eventi invece di implementare logiche di sync complesse
• Migliora l'affidabilità con retry automatici che evitano la perdita di eventi
• Scala in modo efficiente: la consegna dei webhook avviene in indipendenza, senza bloccare le operazioni del programma
• Mantieni la coerenza dei dati propagando subito i cambiamenti del programma di fidelizzazione
• Accelera lo sviluppo sfruttando le notifiche di evento invece di costruire meccanismi di polling custom
• Abilita scenari di automazione sofisticati su più sistemi, innescati da un singolo evento di fidelizzazione
• Rendi le integrazioni a prova di futuro iscrivendoti agli eventi invece di dipendere da endpoint API specifici

Setup e test rapidi dei webhook

Configurare i webhook richiede pochi minuti per gli sviluppatori. Dalla dashboard Yalt registra gli endpoint server che riceveranno le notifiche, seleziona i tipi di evento a cui iscriverti e configura la verifica della firma con le chiavi segrete fornite. Testa gli endpoint con gli strumenti di testing di Yalt, che inviano payload di esempio per verificare che la tua integrazione gestisca gli eventi correttamente. Il sistema fornisce log dettagliati di consegna: cosa è stato inviato, quando, i response code ricevuti e i tentativi di retry. Una volta testato e verificato, i webhook vanno live subito, così i tuoi sistemi reagiscono in tempo reale a tutta l'attività del programma. La documentazione include schemi dei payload, esempi di verifica della firma in più linguaggi e best practice per l'implementazione degli endpoint.

Casi d'uso reali dei webhook

Le piattaforme e-commerce usano i webhook per aggiornare subito le dashboard cliente quando si guadagnano punti o diventano disponibili ricompense, creando esperienze engaging in tempo reale. I sistemi di fulfillment ricevono notifiche quando le ricompense vengono riscattate, avviando spedizioni o consegne senza interventi manuali. Le app mobile si iscrivono agli eventi di fidelizzazione per push su avanzamento di livello, traguardi di punti o ricompense esclusive. I CRM ricevono webhook quando le campagne automatiche inviano messaggi o i clienti raggiungono traguardi, mantenendo uno storico completo delle interazioni. Le piattaforme di BI consumano gli eventi per aggiornare dashboard in tempo reale su performance del programma, engagement e impatto sui ricavi. I sistemi anti-frode monitorano webhook di transazione e riscatto per identificare pattern sospetti. I sistemi di magazzino ricevono notifiche quando si guadagnano ricompense delle carte a timbri, per assicurare la disponibilità di stock. Le piattaforme di customer service si iscrivono agli eventi così i team di supporto vedono l'attività di fidelizzazione completa durante le interazioni, per un servizio personalizzato e informato.