Cos’è il External Lexpad e come si usa? MAX

Utilizzo di External Lexpad

I clienti MAX possono sfruttare uno strumento chiamato External Lexpad che, se combinato con gli eventi di automazione, permette di creare scenari personalizzati non realizzabili con gli strumenti standard. Questo strumento è particolarmente utile per i clienti che non utilizzano le piattaforme di e-commerce con cui ci integriamo o per coloro che hanno bisogno di creare workflow e messaggi che vanno oltre le capacità di queste integrazioni. Esempi di scenari realizzati dai nostri clienti con External Lexpad sono:

• Un’azienda del settore alberghiero che invia messaggi per prenotazioni alberghiere abbandonate.
• Un’azienda di giochi d’azzardo che invia agli utenti il saldo dei punti disponibili nel suo programma di premi.
• Un’azienda di viaggi che invia voucher in base alla posizione dell’utente.
• Un’azienda immobiliare che invia offerte in base alla posizione dell’utente.

Considerazioni importanti

• Requisiti dello sviluppatore: È necessario uno sviluppatore che abbia familiarità con API e JSON. Anche se i nostri Customer Solutions Architect possono assisterti nel processo, è necessaria una competenza tecnica da parte del cliente.
• Responsabilità: I Customer Solution Architect aiutano a impostare il flusso, a testare il messaggio, a verificare l’endpoint, a recuperare le informazioni, a combinare i dati necessari nel database e a strutturare il JSON, se necessario. Tuttavia, non sono responsabili del contenuto finale e del risultato del messaggio. I clienti devono testare accuratamente i flussi di lavoro prima di lanciarli.

Requisiti degli endpoint

External Lexpad ha bisogno di un endpoint che soddisfi i seguenti criteri:

• Il WebService deve rispondere entro 4 secondi.
• La dimensione della risposta non può superare i 32KB.
• Lexpad deve essere in formato JSON utilizzando il set di caratteri UTF-8.
• La struttura di primo livello deve essere un oggetto JSON. Non sono ammessi array o valori nudi.
• L’endpoint deve essere accessibile dagli IP elencati qui: Intervalli IP.

Per stabilire la connessione è necessario fornirci i dettagli dell’endpoint. Inoltre, devi informarci su ogni messaggio che vuoi collegare.

Linee guida per i messaggi

Il messaggio deve essere un messaggio di automazione, poiché il processo di aggiunta del Lexpad esterno è manuale. È possibile fare alcune eccezioni per le newsletter. Tuttavia, ti preghiamo di informarci almeno 24 ore prima dell’invio del messaggio. La documentazione sulla sintassi dei contenuti dinamici utilizzati nel External Lexpad è disponibile qui: Documentazione di External Lexpad.

Workflow di automazione

Non ci sono regole specifiche per il workflow, purché il messaggio venga inviato utilizzando un Lexpad. L’unica limitazione è che un messaggio non può utilizzare contemporaneamente il External Lexpad e le variabili degli eventi o degli elementi dell’e-commerce, poiché questi utilizzano il Internal Lexpad. Di seguito è riportato un esempio di un possibile workflow:

Assistenza di Lexpad

• Fornisci un messaggio o un modello di messaggio con i segnaposto per i valori External Lexpad. Se i segnaposto non sono chiari, fornisci istruzioni dettagliate su dove deve essere mappato ogni valore.
• Fornisci i dettagli dell’endpoint che deve essere collegato al messaggio.
• Se si limitano gli indirizzi IP che accedono all’endpoint, fornire un esempio di risposta JSON come file di testo. Questo aiuta i Customer Solutions Architect a configurare e testare il contenuto dinamico.
• Aggiungeremo un indirizzo e-mail di prova a un elenco nel tuo account e la risposta JSON dovrà essere inviata per questo indirizzo.
• Se Lexpad restituisce un elenco di elementi (ad esempio, offerte), la risposta di esempio deve contenere più valori per garantire un rendering corretto.
• Se sono incluse immagini (ad esempio, miniature per le offerte), fornisci i link alle immagini nella risposta JSON insieme alle dimensioni desiderate.

Tempo di elaborazione

La modifica del messaggio può richiedere circa 2 giorni lavorativi, a seconda del carico di lavoro. I Customer Solution Architect possono fare domande o dare suggerimenti durante questo processo. Anche se si impegnano a garantire che il messaggio funzioni correttamente, i clienti dovrebbero testare il messaggio per verificare che venga visualizzato come previsto prima di inviarlo ai loro contatti.