Integrazione con

Public API

Cos'è la Public API di Yalt?

La Public API di Yalt è un'API REST completa che offre accesso programmatico a tutte le funzionalità dei programmi di fidelizzazione. Permette agli sviluppatori di costruire integrazioni personalizzate, automatizzare i flussi di fidelizzazione, sincronizzare i dati clienti da qualsiasi fonte, attivare campagne automatiche, gestire le ricompense ed estrarre analytics, il tutto tramite endpoint HTTP standardizzati con payload JSON. L'API segue le convenzioni REST moderne, supporta l'autenticazione via chiavi API o OAuth, gestisce gli errori in modo completo e include documentazione dettagliata con esempi di codice in più linguaggi.

Perché usare la Public API di Yalt?

La Public API consente di integrare i programmi di fidelizzazione in qualsiasi sistema, applicazione o flusso di lavoro, senza dipendere da connettori predefiniti. Che tu stia collegando sistemi custom, applicazioni legacy, piattaforme proprietarie o tecnologie emergenti, l'API ti dà la flessibilità per adattare la logica di fidelizzazione ai tuoi processi. Così puoi andare oltre le integrazioni standard: collegare dispositivi IoT ai programmi di fidelizzazione, costruire app mobile con funzioni di fidelizzazione, integrare la fidelizzazione in chioschi o digital signage, o creare automazioni che attraversano più sistemi. L'API dà ai team tecnici gli strumenti per costruire esattamente le esperienze di fidelizzazione di cui il business ha bisogno.

Come l'API abilita programmi di fidelizzazione personalizzati

L'API di Yalt organizza gli endpoint intorno alle entità core del programma di fidelizzazione: clienti, transazioni, punti, ricompense, carte fedeltà, livelli, segmenti e campagne. Gli sviluppatori possono creare e aggiornare i profili clienti, inviare transazioni per attivare il calcolo delle ricompense, assegnare punti bonus o ricompense manuali, interrogare lo stato di fidelizzazione, recuperare l'appartenenza ai segmenti, attivare campagne automatiche, generare codici sconto ed estrarre dati di analytics. Tutte le operazioni avvengono in tempo reale, così i programmi si aggiornano subito quando succede qualcosa nei sistemi collegati. L'API supporta sia push sia pull: i tuoi sistemi possono inviare dati a Yalt per attivare azioni di fidelizzazione, e leggere dati da Yalt per mostrarli nelle interfacce custom.

Capacità complete dell'API per i programmi di fidelizzazione

Gestione clienti: Crea, aggiorna, recupera e cerca profili clienti. Gestisci attributi, contatti, preferenze e campi personalizzati. Interroga lo stato di fidelizzazione, inclusi saldi punti, livello, ricompense disponibili e storico transazioni.

Elaborazione delle transazioni: Invia transazioni per attivare automaticamente l'accumulo di punti, cashback o avanzamento delle carte a timbri. Supporto per strutture complesse con righe, categorie prodotto, metodi di pagamento e metadata personalizzati.

Carte fedeltà e punti: Emetti carte fedeltà digitali in modo programmatico. Assegna punti bonus, regola i saldi, elabora i riscatti e interroga lo storico dei punti. Supporto per più tipi di punti e valute di ricompensa personalizzate.

Ricompense e riscatto: Crea e gestisci cataloghi di ricompense. Elabora i riscatti, genera codici sconto e traccia l'utilizzo. Interroga le ricompense disponibili per un cliente in base al suo stato di fidelizzazione.

Programmi di fidelizzazione a livelli: Gestisci definizioni di livello, regole di avanzamento e benefit specifici. Interroga lo stato di livello, calcola i requisiti di avanzamento e gestisci aggiustamenti manuali in casi eccezionali.

Segmentazione dei clienti: Crea e gestisci segmenti in modo programmatico. Interroga l'appartenenza, calcola le popolazioni ed esporta le liste. Supporto per segmenti dinamici che si aggiornano automaticamente in base al comportamento.

Campagne automatiche: Attiva campagne email e SMS via API. Crea trigger basati su eventi, gestisci i template e interroga le metriche di performance. Consenti ai sistemi esterni di avviare le comunicazioni di fidelizzazione.

Analytics e report: Estrai analytics del programma, incluse metriche di retention, lifetime value, ROI, efficacia delle campagne e pattern di riscatto. Interroga i dati a vari livelli di aggregazione, dal singolo cliente all'intero programma.

Carte a timbri: Gestisci programmi di carte a timbri digitali: creazione delle carte, emissione dei timbri, tracking dell'avanzamento e ricompense di completamento. Supporto per più campagne di carte a timbri in parallelo.

Gestione del cashback: Calcola e traccia i saldi cashback, elabora i riscatti e interroga lo storico. Supporto per strutture a percentuale e a importo fisso.

Integrazione webhook: Configura webhook via API per ricevere notifiche in tempo reale degli eventi di fidelizzazione, abilitando integrazioni bidirezionali che reagiscono subito ai cambiamenti.

Operazioni batch: Esegui operazioni in blocco in modo efficiente: import clienti, aggiustamenti di punti o attivazioni di campagne di massa. Ottimizzate per la sincronizzazione di grandi volumi.

Vantaggi strategici della fidelizzazione guidata da API

• Integra i programmi di fidelizzazione in qualsiasi sistema o applicazione, indipendentemente da piattaforma e tecnologia
• Costruisci esperienze utente custom che incorporano le funzioni di fidelizzazione nelle interfacce esistenti
• Automatizza flussi di fidelizzazione complessi che attraversano più sistemi, senza interventi manuali
• Crea touchpoint innovativi su dispositivi IoT, chioschi, app mobile o nuovi canali
• Mantieni una fonte unica di verità per i dati di fidelizzazione, accessibile da tutti i sistemi aziendali
• Abilita aggiornamenti in tempo reale quando gli eventi avvengono in qualsiasi punto del tuo stack
• Scala i programmi in modo efficiente con la gestione programmatica di clienti, ricompense e campagne
• Rendi l'infrastruttura a prova di futuro disaccoppiando la logica di fidelizzazione da applicazioni o piattaforme specifiche
• Dai ai team di sviluppo la possibilità di iterare rapidamente sulle funzioni di fidelizzazione senza dipendenze dal vendor
• Estrai i dati di fidelizzazione per l'analisi in tool di BI, data warehouse o sistemi di machine learning

Integrazione pensata per gli sviluppatori

Iniziare con l'API di Yalt richiede pochi minuti. Genera le credenziali dalla dashboard Yalt, consulta la documentazione completa con specifiche degli endpoint ed esempi di codice, e fai la prima chiamata con strumenti come Postman o curl. L'API usa metodi HTTP standard (GET, POST, PUT, DELETE), accetta e restituisce payload JSON e fornisce messaggi di errore chiari con gli status code appropriati. Le opzioni di autenticazione includono chiavi API per integrazioni server-to-server o OAuth per applicazioni che richiedono accesso legato all'utente. I limiti di rate sono generosi per l'uso normale, con opzioni di aumento in base alle esigenze. SDK ed esempi sono disponibili in linguaggi popolari come Python, JavaScript, PHP, Ruby e Java. I webhook completi abilitano integrazioni bidirezionali che reagiscono subito agli eventi del programma di fidelizzazione.

Casi d'uso dell'API in vari settori

Le catene retail integrano i programmi di fidelizzazione in app mobile custom, così i clienti vedono le carte fedeltà, i saldi punti, le ricompense e le offerte personalizzate in esperienze branded costruite sull'API. Le aziende manifatturiere collegano gli ERP ai programmi di fidelizzazione, premiando automaticamente i clienti B2B in base ai volumi d'ordine catturati nei sistemi aziendali. Le aziende hospitality integrano la fidelizzazione nei property management system, aggiornando in tempo reale lo stato degli ospiti in base a soggiorni, servizi usati e spesa tra le strutture. Le attività di servizi inseriscono la fidelizzazione nei sistemi di prenotazione, premiando i clienti al completamento degli appuntamenti e attivando campagne automatiche di reminder. I franchise creano portali custom in cui i franchisee accedono ai dati di fidelizzazione delle proprie sedi con interfacce pensate per reporting e operazioni. Le aziende tech incorporano i programmi di fidelizzazione in dispositivi IoT, così elettrodomestici smart o dispositivi connessi premiano i pattern d'uso e attivano campagne in base ai dati del dispositivo. I team data estraggono le metriche di fidelizzazione in data warehouse o piattaforme di BI, combinandole con altri KPI per un'analisi completa.