Inviare e personalizzare le email transazionali
Ogni chiamata API transazionale include l'HTML completo dell'email direttamente nel corpo della richiesta. Questo offre il controllo completo sul contenuto e sulla struttura di ogni messaggio inviato dall'applicazione.
Come funziona
Si passa l'HTML (e facoltativamente il testo normale) direttamente nel corpo della richiesta API. L'applicazione crea il contenuto dell'email in modo dinamico e lo include in ogni richiesta.
Personalizzazione
La personalizzazione consente di inserire valori dinamici nell'email — il nome del destinatario, un numero d'ordine, il nome di un prodotto, un prezzo. Si definiscono i segnaposto nell'HTML e si passano i valori corrispondenti nella chiamata API.
La sintassi esatta dei segnaposto e i parametri API per passare i valori delle variabili sono documentati nella documentazione dell'API Email di Flexmail su email-api.flexmail.eu/documentation, nelle sezioni Personalizzazione.
Variabili di personalizzazione comuni
Le variabili tipiche utilizzate nelle email transazionali includono:
- Nome del destinatario (nome, nome completo)
- Numero d'ordine o di riferimento
- Nomi e quantità dei prodotti
- Prezzi e totali
- Date e scadenze
- Link di conferma o di reimpostazione
- URL o codici specifici dell'account
Test della personalizzazione
Prima di andare in produzione, testare l'email con valori di variabile realistici per assicurarsi che tutti i segnaposto vengano risolti correttamente. La documentazione API include indicazioni per l'invio di messaggi di test con valori di variabili personalizzati.
Verificare in particolare che:
- Tutti i segnaposto siano sostituiti — nessuna sintassi di variabile grezza appare nell'email recapitata.
- I valori di fallback vengano visualizzati correttamente quando una variabile opzionale non viene passata.
- I link si risolvano negli URL corretti dopo la sostituzione delle variabili.
Importante
Se una variabile obbligatoria manca dalla chiamata API e non è definito alcun fallback, il segnaposto potrebbe apparire letteralmente nell'email recapitata. Testare sempre con lo stesso set di variabili che l'applicazione invierà in produzione.
Passi successivi
- Si consulti "Iniziare con l'API transazionale" per la configurazione dell'account e il primo invio.
- Rivedere la sezione Modelli nella documentazione API su email-api.flexmail.eu/documentation per il riferimento completo dei parametri.
- Si consulti "Webhook transazionali" per tracciare la consegna e il coinvolgimento per gli invii basati su modelli.