Quando usare un feed da chiamata API
Puoi utilizzare una chiamata API come origine del data feed quando i dati che vuoi usare nelle tue comunicazioni non si trovano già in una tabella di magnews, ma sono disponibili in un sistema esterno.
In questo modo puoi recuperare contenuti aggiornati in tempo reale — come prodotti, disponibilità, prezzi, articoli o informazioni personalizzate — e usarli direttamente nelle tue email o nei tuoi contenuti dinamici, senza doverli importare manualmente.
È una soluzione particolarmente utile quando lavori con eCommerce, CMS o applicazioni aziendali che espongono API, e vuoi mantenere le tue comunicazioni sempre allineate ai dati più recenti.
Alcuni esempi
Ad esempio puoi utilizzare una chiamata API quando:
- devi recuperare prodotti, prezzi o disponibilità da un eCommerce o da una piattaforma esterna;
- vuoi inserire articoli, news o contenuti editoriali gestiti in un CMS;
- hai dati salvati in un gestionale, CRM o ERP e vuoi usarli direttamente nelle tue comunicazioni;
- lavori con sistemi di booking o travel e hai bisogno di mostrare disponibilità aggiornate o offerte;
- utilizzi marketplace o cataloghi che non dispongono di un connettore in magnews.
Come si configura un data feed via API
Quando crei il data feed, scegli Chiamata API come origine dei dati.
Dopo aver creato il feed, spostati nel tab Chiamata API.
Qui compila l'URL dell'API da cui magnews recupera i contenuti del feed.
Se vuoi configurare la chiamata API manualmente, deseleziona l'opzione a fondo pagina Seleziona guidata dei campie prosegui compilando i campi disponibili. Per utilizzare la procedura guidata clicca sul pulsante Recupera anteprima dei dati (dopo aver scritto l'URL).
In entrambi i casi, a seconda della struttura delle API a cui ti colleghi, potrebbe essere necessario indicare header, body o deselezionare la verifica del certificato SSL nel caso in cui l'URL chiamato non ne fosse in possesso.
Configurazione guidata
Dopo aver utilizzato il pulsante Recupera anteprima dei dati, se non ci sono errori, vedrai una piccola finestra di conferma.
Ora nel tab Contenuti puoi selezionare i campi che ti occorrono nel feed.
Innanzitutto seleziona il percorso dei contenuti (JSONPath) in cui si trovano i contenuti da utilizzare nel feed, in automatico sarà compilata la tabella con i campi del feed.
L'elenco che vedi riporta tutti i campi che sono stati trovati all'interno del percorso (JSONPath) che hai indicato. Seleziona o deseleziona i campi che ti occorrono nel feed. Nella colonna Segnaposto vedi come si chiameranno le variabili che puoi utilizzare nelle tue email o nei tuoi contenuti.
Con Conferma selezione termini la selezione dei contenuti.
Ora puoi impostare un filtro, aggiungere altri campi oppure configurare una modalità di utilizzo dei contenuti, esattamente come fai quando scegli come origine dati un'estensione contatto (tabella dati).
Hai a disposizione anche un pulsante Aggiungi campo; nel caso il JSON cambi, puoi aggiornare e selezionare nuovi campi da considerare.
Come riavviare la configurazione
Se ti trovi in difficoltà o vuoi ricominciare oppure hai cambiato il json e vorresti collegare in automatico la nuova versione, puoi utilizzare il pulsante Riavvia configurazione guidata che trovi in fondo al tab Chiamata API.