Enviar i personalitzar correus electrònics transaccionals
Cada crida a l'API transaccional inclou el HTML complet del vostre correu electrònic directament al cos de la sol·licitud. Això us dóna un control complet sobre el contingut i l'estructura de cada missatge que envia la vostra aplicació.
Com funciona
Passeu el HTML (i opcionalment el text pla) directament al cos de la sol·licitud de l'API. La vostra aplicació construeix el contingut del correu electrònic de manera dinàmica i l'inclou a cada sol·licitud.
Personalització
La personalització us permet inserir valors dinàmics al vostre correu electrònic: el nom de pila del destinatari, un número de comanda, un nom de producte, un preu. Definiu marcadors de posició al vostre HTML i passeu els valors corresponents a la crida de l'API.
La sintaxi exacta dels marcadors de posició i els paràmetres de l'API per passar valors de variables estan documentats a la documentació de l'API de correu electrònic de Flexmail a email-api.flexmail.eu/documentation, a les seccions de Personalització.
Variables de personalització habituals
Les variables típiques usades en correus electrònics transaccionals inclouen:
- Nom del destinatari (nom de pila, nom complet)
- Número de comanda o referència
- Noms de productes i quantitats
- Preus i totals
- Dates i terminis
- Enllaços de confirmació o restabliment
- URL o codis específics del compte
Provar la personalització
Abans de posar-ho en producció, proveu el vostre correu electrònic amb valors de variables realistes per assegurar-vos que tots els marcadors de posició es resolen correctament. La documentació de l'API inclou orientació sobre l'enviament de missatges de prova amb valors de variables personalitzats.
Comproveu en particular que:
- Tots els marcadors de posició se substitueixen; cap sintaxi de variable en brut apareix al correu electrònic lliurat.
- Els valors de reserva es mostren correctament quan no es passa una variable opcional.
- Els enllaços es resolen a les URL correctes després de la substitució de variables.
Important
Si falta una variable requerida a la vostra crida de l'API i no hi ha cap valor de reserva definit, el marcador de posició pot aparèixer literalment al correu electrònic lliurat. Proveu sempre amb el mateix conjunt de variables que la vostra aplicació enviarà en producció.
Passos següents
- Vegeu "Primers passos amb l'API transaccional" per a la configuració del compte i el primer enviament.
- Reviseu la secció Plantilles a la documentació de l'API a email-api.flexmail.eu/documentation per a la referència completa de paràmetres.
- Vegeu "Webhooks transaccionals" per fer un seguiment del lliurament i l'engagement dels vostres enviaments basats en plantilles.