Esta publicación está dirigida al desarrollador que quiere sacar el máximo provecho de las capacidades de plantillas de correo electrónico de SparkPost. Se asume que estás cómodo leyendo contenido JSON y siguiendo el flujo básico de programación. A medida que se introducen términos que pueden ser nuevos para ti, como RFC 5322, el texto está vinculado a su referencia fuente. Con eso fuera del camino, vamos a comenzar de inmediato.

Las capacidades de plantillas y de transmisión de SparkPost hacen que enviar correos electrónicos sea sencillo. Esas capacidades proporcionan una abstracción para contenido de texto y HTML, lo que significa que la mayoría de las veces no es necesario codificar directamente el formato de correo electrónico bruto definido en RFC 5322, conocido anteriormente como (RFC 822). Pero a veces es posible que desees crear mensajes más complejos que tengan otras partes de Extensiones de Correo de Internet Multipropósito (MIME) que no están directamente expuestas a través de la interfaz RESTful de SparkPost.

Composición Simplificada de Correos Electrónicos

Primero, revisemos un escenario ideal para enviar un correo electrónico. Utiliza el endpoint de transmisión para proporcionar el contenido de texto y HTML. Detrás de escena, SparkPost se encarga de componer un correo electrónico válido RFC 5322. SparkPost insertará variables de sustitución de substitution_data en el texto y el contenido HTML. Esta es una forma poderosa de generar contenido personalizado para cada destinatario en una plantilla común.

Aquí tienes un ejemplo de transmisión con contenido HTML y texto con substitution_data.

{
  "options": {
    "open_tracking": true,
    "click_tracking": true
  },
  "campaign_id": "christmas_campaign",
  "return_path": "bounces-christmas-campaign@domain.com",
  "metadata": {
    "user_type": "students"
  },
  "substitution_data": {
    "sender": "Big Store Team"
  },
  "recipients": [
    {
      "return_path": "123@bounces.domain.com",
      "address": {
        "email": "wilma@domain.com",
        "name": "Wilma Flintstone"
      },
      "tags": [
        "greeting",
        "prehistoric",
        "fred",
        "flintstone"
      ],
      "metadata": {
        "place": "Bedrock"
      },
      "substitution_data": {
        "customer_type": "Platinum"
      }
    }
  ],
  "content": {
    "from": {
      "name": "Fred Flintstone",
      "email": "fred@domain.com"
    },
    "subject": "Big Christmas savings!",
    "reply_to": "Christmas Sales <sales@domain.com>",
    "headers": {
      "X-Customer-Campaign-ID": "christmas_campaign"
    },
    "text": "Hi {{address.name}} \nSave big this Christmas in your area {{place}}! \nClick http://www.mysite.com and get huge discount\n Hurry, this offer is only to {{user_type}}\n {{sender}}",
    "html": "<p>Hi {{address.name}} <br>Save big this Christmas in your area {{place}}! <br>Click <a href=\"http://www.mysite.com\">here</a> and get huge discount</p><p>Hurry, this offer is only to {{user_type}}</p><p>{{sender}}</p>"
  }
}

Sustituir Arreglos de Datos

Muchas personas se dan cuenta de que los endpoints de transmisión y plantillas de SparkPost pueden hacer sustitución de contenido sencillo en los encabezados y cuerpos de los correos electrónicos. Pero muchos pasan por alto la capacidad de proporcionar contenido condicional o arreglos de datos que también pueden sustituirse. También puedes proporcionar contenido único por destinatario. En este ejemplo, enviamos un arreglo de enlaces únicos a cada destinatario.

Esto se logra proporcionando un arreglo JSON de datos que se poblará en el cuerpo del correo electrónico. Una vez que se proporcionan los datos, SparkPost usará la lógica en la plantilla para poblarla.

En este ejemplo, SparkPost buscará datos de sustitución llamados “files_html” y realizará un “for each” en cada elemento del arreglo. Creará una fila con el valor de