Product
Conviértete en especialista del email con nuestra API de plantillas
Las plantillas de email son el ingrediente secreto para crear campañas de email consistentes y escalables.
En Mailgun, hemos puesto varias plantillas de email responsive a tu disposición en nuestra interfaz de usuario. Estos archivos HTML contienen bloques de código modulares que definen el aspecto de tus emails.
También hemos publicado plantillas de código abierto en GitHub para cubrir tus necesidades diarias de email. Lo único que tienes que hacer es añadir el contenido de tu email.
¿Pero qué pasa si ya tienes una plantilla o necesitas una mayor personalización más allá de nuestros diseños listos para usar? Ahora puedes usar nuestra API de plantillas para importar tus propias plantillas de email a tu cuenta de Mailgun.
A continuación, explicaremos dónde encontrar una plantilla de email, cómo subir tu plantilla a Mailgun a través de la API de plantillas y algunas mejores prácticas.
¿Cuáles son las ventajas de las plantillas de email?
Las plantillas de email son archivos HTML que contienen código reutilizable que hace que crear campañas de email sea muy sencillo. En lugar de escribir y probar código nuevo cada vez, puedes simplemente copiar y pegar texto, URL de imágenes y enlaces en una plantilla existente para crear una nueva campaña.
Entre las ventajas principales se incluyen:
- Eficiencia: no reinventes la rueda, simplemente pega el contenido de tu email en la plantilla y listo.
- Consistencia: mantén la imagen de tu marca en todos tus emails utilizando el mismo código.
- Escalabilidad: permite que los miembros del equipo sin perfil técnico creen campañas de email reduciendo la dependencia del equipo de desarrollo para diseñar campañas una a una.
En resumen, las plantillas de email hacen el trabajo duro a la hora de crear nuevos formatos de email para tus campañas.
¿Cuáles son los diferentes tipos de plantillas de email?
Pero hay tantas plantillas… ¿Cómo puedes saber cuál es la adecuada? A continuación, hemos identificado los tres tipos principales de plantillas de email y proporcionado una breve descripción de las necesidades que cubren:
- Los envíos masivos de email son campañas de marketing puntuales que se envían a casi toda tu base de usuarios.
- Emails transaccionales son mensajes desencadenados por las acciones del usuario en tu sitio web, como crear una cuenta, realizar una compra o solicitar una nueva contraseña.
- Newsletters son conversaciones recurrentes entre tu marca y tus suscriptores. Envía emails de este tipo para mantener el interés de tus usuarios.
¿Dónde puedo encontrar plantillas de email?
En caso de que no quieras subir tus propias plantillas de email, aquí tienes una lista de plantillas de Mailgun gratuitas:
- Elige entre seis plantillas existentes en nuestra interfaz de usuario.
- Haz un fork plantillas de email transaccional desde nuestro repositorio de GitHub.
- Echa un vistazo a las plantillas HTML gratuitas en Email on Acid.
Puedes usar nuestras plantillas tal cual o como inspiración para crear una nueva plantilla. Luego, puedes subir tus plantillas a tu cuenta de Mailgun a través de la API de plantillas.
¿Cómo empiezo a usar la API de plantillas?
Antes de subir tu plantilla de email, debes tener una Cuenta de Mailgun y un dominio verificado en nuestro sistema. Además, ten en cuenta que actualmente solo admitimos el Handlebars motor de plantillas, que es una opción muy popular para el diseño de emails.
A continuación, explicaremos dos formas de almacenar e inicializar una plantilla. Después, hablaremos sobre cómo gestionar las versiones de tus plantillas y enviar emails de prueba para comprobar si tu plantilla se ha almacenado correctamente.
Nuestra API de plantillas forma parte de la potente API de email de Mailgun. Puedes acceder a nuestra API de plantillas en el siguiente punto de conexión: /templates. Echa un vistazo a nuestras documentación de referencia de la API de plantillas para obtener información más detallada.
¿Cómo almaceno e inicializo una plantilla al mismo tiempo?
Empecemos por almacenar tu plantilla en tu cuenta de Mailgun.
Primero, intentemos almacenar una plantilla con una versión activa inicial enviando una solicitud POST al punto de conexión de la API de plantillas. Esto almacena tanto los metadatos de la plantilla como su contenido.
curl -X POST https://api.mailgun.net/v3/example.com/templates
-F name="billing"
-F description="template description" -F tag="v0"
-F template=”template contents”
En esta solicitud, los parámetros name, tag y template son obligatorios. El parámetro name indica el nombre de la plantilla, que se utiliza para hacer referencia a ella en otras llamadas a la API. El parámetro tag identifica la versión específica de esta plantilla. El control de versiones es útil en las campañas de email, algo de lo que hablaremos más adelante. El parámetro template especifica el contenido de la propia plantilla. Aquí, puedes pegar el contenido HTML de la plantilla directamente en la solicitud.
¿Pero qué pasa si tu plantilla está almacenada en tu disco local? La siguiente solicitud de muestra enseña cómo extraer el contenido de la plantilla desde un archivo. Para este ejemplo, supongamos que tu plantilla está guardada localmente como billing.html.
curl -X POST https://api.mailgun.net/v3/example.com/templates
-F name="billing"
-F description="template description" -F tag="v0"
-F template=<code data-enlighter-language="generic" class="EnlighterJSRAW">content from file billing.html</code>
Al igual que en el primer ejemplo, esto requiere los parámetros name, template y tag.
¿Cómo almaceno una plantilla y luego la inicializo por separado?
Como alternativa, puedes almacenar una plantilla en dos pasos:
- Almacena los metadatos de una plantilla.
- Almacena una versión de la plantilla.
Cuando almacenas una plantilla sin usar el parámetro tag para añadir un número de versión o el parámetro template para proporcionar el contenido de la plantilla, registras los metadatos de la misma en tu cuenta de Mailgun. Tu plantilla no estará activa en ese momento, sino que se almacenará para más tarde.
Para activar tu plantilla, debes actualizar los metadatos almacenados proporcionando el contenido de la plantilla en otra solicitud. Esto crea la primera versión, v0, de tu plantilla.
Almacenar los metadatos de una plantilla
Utiliza la siguiente solicitud para almacenar los metadatos de una plantilla sin inicializarla.
curl -X POST https://api.mailgun.net/v3/example.com/templates
-F name="billing"
-F description = "description of your template"
El parámetro name es obligatorio.
Almacenar una versión de la plantilla
Utiliza la siguiente solicitud para almacenar una versión de una plantilla después de haber creado un registro de sus metadatos. Una vez más, supongamos que el contenido de la plantilla está almacenado en tu disco local como billing.html. Hemos utilizado Python en el siguiente ejemplo.
import requests
content = None
with open("/path_to_file/billing.html", 'r') as f:
content = f.read()
requests.post("https://api/mailgiun.net/v3/example.com/templates/billing/versions",
auth=('api': "key"),
data={"tag": "v0",
"comment": "version comment",
"template": content})
Tu plantilla ya está activa puesto que has proporcionado el contenido y el número de versión.
¿Por qué necesito crear versiones de una plantilla?
Para que tu plantilla esté activa, necesitas tener al menos una versión. La versión inicial se llama “v0” en el parámetro tag de los ejemplos anteriores. Sin embargo, a veces resulta útil tener varias versiones de una plantilla.
Por ejemplo, puedes utilizar varias versiones para:
- Proporcionar información o actualizaciones de productos.
- Realizar investigaciones de la experiencia de usuario sobre textos, elementos de diseño o llamadas a la acción.
- Adaptar los emails para que se ajusten a las necesidades cambiantes de la campaña.
Ten en cuenta que siempre debes tener una versión activa de una plantilla. Los emails utilizan esta versión activa a menos que se especifique lo contrario. Por defecto, la versión activa es la primera que almacenas cuando subes tu plantilla.
Como se muestra a continuación, puedes actualizar la versión activa a una nueva versión con una sencilla solicitud PUT utilizando el punto de conexión de la API de plantillas. Para este ejemplo, supongamos que hay dos versiones de tu plantilla, v0 y v1, y que la v0 está actualmente activa.
Entonces, ¿qué hay de los envíos?
Ahora que hemos añadido tu plantilla a tu cuenta, vamos a usar la API de mensajes de Mailgun para enviar un email de prueba. Podríamos simplemente renderizar un mensaje, pero enviar un mensaje de prueba te permite ver si la información de tu variable funciona como debería. Ten en cuenta que debes asegurarte de adjuntar tus datos correctamente para que la información de la variable funcione. La forma de hacerlo depende de si estás enviando a través de SMTP o API.
Vamos a enviar un mensaje de prueba con una solicitud POST usando variables de destinatario en un objeto JSON. Usaremos la API de mensajes de Mailgun para hacerlo.
curl -X POST https://api.mailgun.net/v3/example.com/messages
-F template="billing"
-H "X-Mailgun-Variables: {"firstName": "John",
"lastName": "Doe",
"number": "12345",
"data":"Mar 01, 2019",
"amount1": "23.00",
"amount2": "10.20",
"total": "33.20"}"
Si has adjuntado tus datos correctamente, el email de prueba debería coincidir con tu renderizado con las variables en su lugar.
¿Cómo envío una versión específica de una plantilla?
Hemos hablado de cómo crear varias versiones de una plantilla de email realmente potencia tu campaña. Pero ¿cómo envías una versión específica de una plantilla?
Por defecto, los emails utilizan la versión activa de tu plantilla. Sin embargo, es bastante sencillo configurar tu email para que envíe una versión específica que no está activa. Utiliza los siguientes indicadores en tu llamada a la API: t:version y t:text.
curl -X POST https://api.mailgun.net/v3/example.com/messages
-F template="billing"
-F t:version="v1"
-F t:text="yes"
El indicador t:version señala qué versión de tu plantilla usar. Para el par clave-valor t:text , pasa yes para renderizar tu plantilla en la parte de texto de tu email.
En resumen
¡Y ya está! Hemos almacenado correctamente nuestra plantilla en nuestra cuenta de Mailgun, probado el control de versiones y enviado emails de prueba. Dirígete a nuestra documentación para sacar el máximo partido a nuestra API de plantillas.
Si tienes algún problema con tus plantillas, abre una incidencia de asistencia. Nos pondremos en contacto contigo lo antes posible.
¿Te sientes con inspiración? Envíanos tus diseños de plantillas. Lee más sobre esto en nuestro artículo del blog.
