Your favorite animal is {{favoriteanimal}}.
" } } ``` Este código contiene las siguientes propiedades: + **TemplateName**— El nombre del `Template` recurso. Cuando envíe el correo electrónico, consulte este nombre. + **TemplateContent**— Un contenedor para los siguientes atributos: + **Asunto**: el asunto del mensaje de correo electrónico. Esta propiedad podría contener etiquetas de sustitución. Estas etiquetas utilizan el siguiente formato: `{{tagname}}`. Cuando envíe el correo electrónico, puede especificar un valor para `tagname` para cada destino. + **Html**: cuerpo HTML del correo electrónico. Esta propiedad podría contener etiquetas de sustitución. El ejemplo anterior incluye dos etiquetas: `{{name}}` y `{{favoriteanimal}}`. + **Text**: cuerpo de texto del correo electrónico. Los destinatarios cuyos clientes de correo electrónico no muestran el correo electrónico en HTML ven este contenido del correo electrónico. Esta propiedad podría contener etiquetas de sustitución. 1. Personalice el ejemplo anterior para adaptarse a sus necesidades y, a continuación, guarde el archivo como *mytemplate.json*. 1. En la línea de comandos, escriba el siguiente comando para crear una nueva plantilla utilizando la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html) de la API v2: ``` aws sesv2 create-email-template --cli-input-json file://mytemplate.json ``` ## Parte 3: Enviar el correo electrónico personalizado Puede usar las dos operaciones siguientes de la API v2 de SES para enviar correos electrónicos mediante *plantillas almacenadas* o *plantillas en línea*: + La operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) es útil para enviar un correo electrónico personalizado a un único objeto de destino. El [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html)objeto de la API v2 puede contener las *BccAddresses*propiedades *ToAddresses*CcAddresses**, y. Se pueden usar en cualquier combinación y pueden contener una o más direcciones de correo electrónico que recibirán el mismo correo electrónico. + La operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html) resulta útil para enviar correos electrónicos únicos a varios objetos de destino en una única llamada a la API v2. En esta sección se proporcionan ejemplos de cómo utilizarlos AWS CLI para enviar correos electrónicos con plantillas mediante estas dos operaciones de envío. ### Envío de correo electrónico de plantilla a un único objeto de destino Puede utilizar la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) para enviar un correo electrónico a uno o varios destinatarios definidos en un único objeto de destino. Todos los destinatarios del objeto [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) recibirán el mismo correo electrónico. **Cómo enviar un correo electrónico de plantilla a un objeto de destino único** 1. Dependiendo de si desea utilizar una *plantilla almacenada* o una *plantilla en línea*, seleccione el ejemplo de código correspondiente para pegarlo en un editor de texto y personalícelo según sus necesidades. ------ #### [ Stored template code example ] Observe que se hace referencia a la plantilla que creó en el paso anterior como valor del `TemplateName` parámetro. *MyTemplate* ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }" } }, "ConfigurationSetName": "ConfigSet" } ``` Este código contiene las siguientes propiedades: + **FromEmailAddress**— La dirección de correo electrónico del remitente. + **Destino**: objeto que contiene los destinatarios del correo electrónico definidos en las *BccAddresses*propiedades *ToAddresses*CcAddresses**, y. Se pueden usar en cualquier combinación y pueden contener una o más direcciones de correo electrónico que recibirán el mismo correo electrónico. + **TemplateContent**— Un contenedor para los siguientes atributos: + **Asunto**: el asunto del mensaje de correo electrónico. Esta propiedad podría contener etiquetas de sustitución. Estas etiquetas utilizan el siguiente formato: `{{tagname}}`. Cuando envíe el correo electrónico, puede especificar un valor para `tagname` para cada destino. + **Html**: cuerpo HTML del correo electrónico. Esta propiedad podría contener etiquetas de sustitución. El ejemplo anterior incluye dos etiquetas: `{{name}}` y `{{favoriteanimal}}`. + **Text**: cuerpo de texto del correo electrónico. Los destinatarios cuyos clientes de correo electrónico no muestran el correo electrónico en HTML ven este contenido del correo electrónico. Esta propiedad podría contener etiquetas de sustitución. + **TemplateData**— Una cadena JSON de escape que contiene pares clave-valor. Las claves corresponden a las variables definidas en las propiedades `TemplateContent` de este archivo, por ejemplo, `{{name}}`. Los valores representan el contenido que sustituye a las variables. + **ConfigurationSetName**— El nombre del conjunto de configuraciones que se utilizará al enviar el correo electrónico. **nota** Le recomendamos que utilice un conjunto de configuración que esté configurado para publicar eventos de errores de presentación en Amazon SNS. Para obtener más información, consulte [(Opcional) Parte 1: configuración de notificaciones de eventos de errores de renderizado](#send-personalized-email-set-up-notifications). ------ 1. Personalice el ejemplo anterior para adaptarse a sus necesidades y, a continuación, guarde el archivo como *myemail.json*. 1. En la línea de comandos, escriba el siguiente comando de la API v2 para enviar el correo electrónico: ``` aws sesv2 send-email --cli-input-json file://myemail.json ``` ### Envío de correo electrónico con plantilla a varios objetos de destino Puede utilizar la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html) para enviar un correo electrónico a varios destinos en una llamada única al API v2 de SES. SES envía un correo electrónico único al destinatario o destinatarios en cada objeto de [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html). **Cómo enviar un correo electrónico de plantilla a varios objetos de destino** 1. Dependiendo de si desea utilizar una *plantilla almacenada* o una *plantilla en línea*, seleccione el ejemplo de código correspondiente para pegarlo en un editor de texto y personalícelo según sus necesidades. ------ #### [ Stored template code example ] Observe que se hace referencia a la plantilla que creó en el paso anterior como valor del `TemplateName` parámetro. *MyTemplate* ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"friend\", \"favoriteanimal\":\"unknown\" }" } }, "BulkEmailEntries": [ { "Destination": { "ToAddresses": [ "anaya.iyengar@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }" } } }, { "Destination": { "ToAddresses": [ "liu.jie@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }" } } }, { "Destination": { "ToAddresses": [ "shirley.rodriguez@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }" } } }, { "Destination": { "ToAddresses": [ "richard.roe@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{}" } } } ], "ConfigurationSetName": "ConfigSet" } ``` Este código contiene las siguientes propiedades: + **FromEmailAddress**— La dirección de correo electrónico del remitente. + **DefaultContent**— Un objeto JSON que contiene los `TemplateData` objetos `TemplateContent` y. + **TemplateContent**— Un contenedor para los siguientes atributos: + **Asunto**: el asunto del mensaje de correo electrónico. Esta propiedad podría contener etiquetas de sustitución. Estas etiquetas utilizan el siguiente formato: `{{tagname}}`. Cuando envíe el correo electrónico, puede especificar un valor para `tagname` para cada destino. + **Html**: cuerpo HTML del correo electrónico. Esta propiedad podría contener etiquetas de sustitución. El ejemplo anterior incluye dos etiquetas: `{{name}}` y `{{favoriteanimal}}`. + **Text**: cuerpo de texto del correo electrónico. Los destinatarios cuyos clientes de correo electrónico no muestran el correo electrónico en HTML ven este contenido del correo electrónico. Esta propiedad podría contener etiquetas de sustitución. + **TemplateData**— Contiene pares clave-valor que se utilizarán si el `ReplacementEmailContent` objeto contiene un objeto JSON vacío`{}`, en la `ReplacementTemplateData` propiedad. + **BulkEmailEntries**— Una matriz que contiene uno o más `Destination` objetos. + **Destino**: objeto que contiene los destinatarios del correo electrónico definidos en las *BccAddresses*propiedades *ToAddresses*CcAddresses**, y. Se pueden usar en cualquier combinación y pueden contener una o más direcciones de correo electrónico que recibirán el mismo correo electrónico. + **ReplacementTemplateData**— Una cadena JSON de escape que contiene pares clave-valor. Las claves corresponden a las variables definidas en las propiedades `TemplateContent` de este archivo, por ejemplo, `{{name}}`. Los valores representan el contenido que sustituye las variables en el correo electrónico. (Si la cadena JSON aquí está vacía, lo que se indica mediante `{}`, se utilizarán los pares clave-valor definidos en la propiedad `TemplateData` dentro del objeto `DefaultContent`). + **ConfigurationSetName**— El nombre del conjunto de configuraciones que se utilizará al enviar el correo electrónico. **nota** Le recomendamos que utilice un conjunto de configuración que esté configurado para publicar eventos de errores de presentación en Amazon SNS. Para obtener más información, consulte [(Opcional) Parte 1: configuración de notificaciones de eventos de errores de renderizado](#send-personalized-email-set-up-notifications). ------ 1. Cambie los valores del código del paso anterior según sus necesidades y, a continuación, guarde el archivo como *mybulkemail.json*. 1. En la línea de comandos, escriba el siguiente comando de la API v2 para enviar el correo masivo: ``` aws sesv2 send-bulk-email --cli-input-json file://mybulkemail.json ``` # Personalización avanzada del correo electrónico Si utiliza una *plantilla almacenada*, es decir, si ha creado un recurso [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html) en Amazon SES mediante la operación `CreateEmailTemplate` con la API v2 de SES, puede aprovechar el sistema Handlebars para crear plantillas que incluyan características avanzadas, como atributos anidados, iteración de matrices, instrucciones condicionales básicas y la creación de parciales en línea. En esta sección se proporcionan ejemplos de estas características. Handlebars incluye características adicionales además de las documentadas en esta sección. Para obtener más información, consulte [Built-In Helpers](https://handlebarsjs.com/guide/builtin-helpers.html) en [handlebarsjs.com](http://handlebarsjs.com). **nota** SES no aplica secuencias de escape al contenido HTML cuando renderiza la plantilla HTML de un mensaje. Esto significa que si incluye datos introducidos por el usuario, como desde un formulario de contacto, tendrá que aplicar las secuencias de escape en el lado del cliente. **Topics** + [Análisis de atributos anidados](#send-personalized-email-advanced-nested) + [Recorrido de listas en iteración](#send-personalized-email-advanced-iterating) + [Uso de instrucciones condicionales básicas](#send-personalized-email-advanced-conditionals) + [Creación de funciones parciales insertadas](#send-personalized-email-advanced-inline-partials) ## Análisis de atributos anidados Handlebars admite rutas anidadas, lo que facilita la organización de datos de clientes complejos y la referencia a esos datos en sus plantillas de correo electrónico. Por ejemplo, puede organizar los datos de los destinatarios en varias categorías generales. Dentro de cada una de estas categorías, puede incluir información detallada. El siguiente ejemplo de código muestra un ejemplo de esta estructura para un único destinatario: ``` { "meta":{ "userId":"51806220607" }, "contact":{ "firstName":"Anaya", "lastName":"Iyengar", "city":"Bengaluru", "country":"India", "postalCode":"560052" }, "subscription":[ { "interest":"Sports" }, { "interest":"Travel" }, { "interest":"Cooking" } ] } ``` En sus plantillas de correo electrónico, puede hacer referencia a atributos anidados proporcionando el nombre del atributo principal, seguido de un punto (.), seguido del nombre del atributo para el que desea incluir el valor. Por ejemplo, si utiliza la estructura de datos que se muestra en el ejemplo anterior y desea incluir el nombre de cada destinatario en la plantilla de correo electrónico, incluya el siguiente texto en su plantilla de correo electrónico: `Hello {{contact.firstName}}!` Handlebars puede analizar rutas que tengan varios niveles anidados, lo que le proporciona flexibilidad a la hora de estructurar los datos de la plantilla. ## Recorrido de listas en iteración La función auxiliar `each` recorre en iteración los elementos de una matriz. El código siguiente es un ejemplo de una plantilla de correo electrónico que utiliza la función auxiliar `each` para crear una relación detallada de los intereses de cada destinatario. ``` { "Template": { "TemplateName": "Preferences", "SubjectPart": "Subscription Preferences for {{contact.firstName}} {{contact.lastName}}", "HtmlPart": "You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
", "TextPart": "Your Preferences\n\nYou have indicated that you are interested in receiving information about the following subjects:\n {{#each subscription}} - {{interest}}\n {{/each}} \nYou can change these settings at any time by visiting the Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}" } } ``` **importante** En el ejemplo de código anterior, los valores de los atributos `HtmlPart` y `TextPart` incluyen saltos de línea para facilitar la lectura del ejemplo. El archivo JSON de la plantilla no puede contener saltos de línea dentro de estos valores. Si ha copiado y pegado este ejemplo en su propio archivo JSON, elimine los saltos de línea y espacios adicionales de las secciones `HtmlPart` y `TextPart` antes de continuar. Después de crear la plantilla, puede utilizar la operación `SendEmail` o `SendBulkEmail` para enviar correo electrónico a los destinatarios a través de esta plantilla. Siempre y cuando los destinatarios tengan al menos un valor en el objeto `Interests`, reciben un correo electrónico que incluye una relación detallada de sus intereses. El siguiente ejemplo muestra un archivo JSON que se puede utilizar para enviar correo electrónico a varios destinatarios mediante la plantilla anterior: ``` { "Source":"Sender NameDear {{contact.firstName}},
{{#if subscription}}You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
{{else}}Please update your subscription preferences by visiting
the
Preference Center.
{{/if}}",
"TextPart": "Your Preferences\n\nDear {{contact.firstName}},\n\n
{{#if subscription}}
You have indicated that you are interested in receiving
information about the following subjects:\n
{{#each subscription}}
- {{interest}}\n
{{/each}}
\nYou can change these settings at any time by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{else}}
Please update your subscription preferences by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{/if}}"
}
}
```
**importante**
En el ejemplo de código anterior, los valores de los atributos `HtmlPart` y `TextPart` incluyen saltos de línea para facilitar la lectura del ejemplo. El archivo JSON de la plantilla no puede contener saltos de línea dentro de estos valores. Si ha copiado y pegado este ejemplo en su propio archivo JSON, elimine los saltos de línea y espacios adicionales de las secciones `HtmlPart` y `TextPart` antes de continuar.
El siguiente ejemplo muestra un archivo JSON que se puede utilizar para enviar correo electrónico a varios destinatarios mediante la plantilla anterior:
```
{
"Source":"Sender Name You have listed the following people as your friends: This is the HTML part of the message. This is the HTML part of the message.Hello {{> fullName}}!
{{#each friends}}
",
"TextPart": "{{#* inline \"fullName\"}}
{{firstName}}{{#if lastName}} {{lastName}}{{/if}}
{{/inline~}}\n
Hello {{> fullName}}! You have listed the following people
as your friends:\n
{{#each friends}}
- {{> fullName}}\n
{{/each}}"
}
}
```
**importante**
En el ejemplo de código anterior, los valores de los atributos `HtmlPart` y `TextPart` incluyen saltos de línea para facilitar la lectura del ejemplo. El archivo JSON de la plantilla no puede contener saltos de línea dentro de estos valores. Si ha copiado y pegado este ejemplo en su propio archivo JSON, elimine los saltos de línea y espacios adicionales de estas secciones.
# Administración de plantillas de correo electrónico
Además de [crear de plantillas de correo electrónico](send-personalized-email-api.md), también puede utilizar la API v2 de Amazon SES para actualizar o eliminar plantillas existentes, enumerar todas las plantillas existentes o ver el contenido de una plantilla.
Esta sección contiene los procedimientos para utilizarlos AWS CLI para realizar tareas relacionadas con las plantillas de SES.
**nota**
En los procedimientos que se describen en esta sección, se da por hecho que ya se ha instalado y configurado la AWS CLI. Para obtener más información sobre la instalación y configuración de AWS CLI, consulte la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
## Visualización de una lista de plantillas de correo electrónico
Puede utilizar la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html) de la API v2 de SES para ver una lista de todas las plantillas de correo electrónico existentes.
**Para ver una lista de plantillas de correo electrónico**
+ En la línea de comandos, introduzca el comando siguiente:
```
aws sesv2 list-email-templates
```
Si hay plantillas de correo electrónico existentes en su cuenta de SES en la región actual, este comando devuelve una respuesta similar al siguiente ejemplo:
```
{
"TemplatesMetadata": [
{
"Name": "SpecialOffers",
"CreatedTimestamp": "2020-08-05T16:04:12.640Z"
},
{
"Name": "NewsAndUpdates",
"CreatedTimestamp": "2019-10-03T20:03:34.574Z"
}
]
}
```
Si no ha creado ninguna plantilla, el comando devuelve un objeto `TemplatesMetadata` sin miembros.
## Visualización del contenido de una plantilla de correo electrónico específica
Puede utilizar la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html) de la API v2 de SES para ver el contenido de una plantilla de correo electrónico específica.
**Para ver el contenido de una plantilla de correo electrónico**
+ En la línea de comandos, introduzca el comando siguiente:
```
aws sesv2 get-email-template --template-name MyTemplate
```
En el comando anterior, *MyTemplate* sustitúyalo por el nombre de la plantilla que desee ver.
Si el nombre de la plantilla que ha proporcionado coincide con una plantilla existente en su cuenta de SES, este comando devuelve una respuesta similar al ejemplo siguiente:
```
{
"Template": {
"TemplateName": "TestMessage",
"SubjectPart": "Amazon SES Test Message",
"TextPart": "Hello! This is the text part of the message.",
"HtmlPart": "\n\nHello!
\nHello!
\n