Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso de plantillas para el envío de correo electrónico personalizado con la API de Amazon SES
En Amazon SES, puede enviar correos electrónicos con plantillas mediante una *plantilla almacenada* o una *plantilla en línea*.
+ **Plantilla almacenada**: hace referencia al 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) que se crea y guarda en SES mediante la operación `CreateEmailTemplate` de la API v2 de Amazon SES. La plantilla contiene el asunto y el cuerpo del correo electrónico y contiene variables (marcadores de posición) en línea con el contenido escrito. El nombre de la plantilla almacenada y los datos dinámicos de las variables de marcador de posición de la plantilla se proporcionan al llamar a las operaciones de la API v2 `SendEmail` o `SendBulkEmail`.
*Plantillas almacenadas*: se pueden reutilizar fácilmente y pueden ahorrarle tiempo y esfuerzo al enviar tipos de correos electrónicos similares. En lugar de crear cada correo electrónico desde cero, solo necesita crear la estructura base y el diseño una vez y, a continuación, actualizar simplemente el contenido dinámico de la plantilla.
+ **Plantilla en línea**: no se utiliza el recurso `Template`, sino que se proporcionan el asunto y el cuerpo del correo electrónico que contiene variables (marcadores de posición) en línea con el contenido escrito, junto con los valores de esas variables de marcador de posición, al llamar a las operaciones de la API v2 `SendEmail` o `SendBulkEmail`.
Las *plantillas integradas* simplifican el proceso de envío masivo de correos electrónicos al eliminar la necesidad de administrar los recursos de plantillas en su cuenta de SES y simplifican el proceso de integración al permitirle incluir el contenido de la plantilla directamente en la lógica de la aplicación. No se tienen en cuenta para el límite de 20 000 plantillas por plantilla. Región de AWS
Se aplican los siguientes límites cuando se utilizan *plantillas almacenadas*:
+ Puedes crear hasta 20 000 plantillas de correo electrónico en cada una. Región de AWS
+ Cada plantilla puede tener un tamaño de hasta 500 KB, incluidos el texto y las partes en HTML.
Se aplican los siguientes límites cuando se utilizan *plantillas en línea*:
+ Cada archivo JSON de entrada puede tener hasta 1 MB de tamaño, incluido el texto y las partes HTML.
Lo siguiente se aplica a las plantillas *almacenadas* y *en línea*:
+ No hay límites en cuanto al número de variables de reemplazo que se pueden utilizar.
+ Puede enviar correo electrónico a un máximo de 50 objetos de destino en cada llamada a la operación `SendBulkEmail`. 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 puede contener varios destinatarios definidos en **ToAddresses**CcAddresses****, y **BccAddresses**. El número de destinos con los que puede ponerse en contacto en una única llamada a la API v2 podría estar limitado por la tasa de envío máxima de su cuenta. Para obtener más información, consulte [Administración de sus límites de envío de Amazon SES](manage-sending-quotas.md).
En este capítulo se incluyen procedimientos con ejemplos para usar *plantillas almacenadas* y *plantillas en línea*.
**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 del AWS CLI, consulte la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
## (Opcional) Parte 1: configuración de notificaciones de eventos de errores de renderizado
Si envía un correo electrónico que contiene contenido de personalización no válido, Amazon SES puede aceptar inicialmente el mensaje, pero puede no ser capaz de enviarlo. Por este motivo, si tiene previsto enviar correo electrónico personalizado, debe configurar SES para enviar notificaciones de eventos de errores de presentación a través de Amazon SNS. Cuando reciba una notificación de evento de error de presentación, puede identificar qué mensaje incluía el contenido no válido, solucionar los problemas y enviar el mensaje de nuevo.
Es absolutamente recomendable que realice el procedimiento de esta sección, aunque sea opcional.
**Para configurar notificaciones de eventos de errores de presentación**
1. Crear un tema de Amazon SNS Para obtener información acerca de los procedimientos, consulte [Creación de un tema](https://docs.aws.amazon.com/sns/latest/dg/sns-create-subscribe-endpoint-to-topic.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*.
1. Suscríbase al tema de Amazon SNS. Por ejemplo, si desea recibir notificaciones de errores de presentación por correo electrónico, suscriba un punto de enlace de correo electrónico (es decir, su dirección de correo electrónico) al tema.
Para obtener información acerca de los procedimientos, consulte [Suscribirse a un tema](https://docs.aws.amazon.com/sns/latest/dg/SubscribeTopic.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*.
1. Realice los procedimientos de [Configuración de un destino de eventos de Amazon SNS para la publicación de eventos](event-publishing-add-event-destination-sns.md) para configurar los conjuntos de configuración con el objetivo de publicar eventos de errores de presentación en su tema de Amazon SNS.
## (Opcional) Parte 2: creación de una plantilla de correo electrónico
Si piensa utilizar una *plantilla almacenada*, en esta sección se mostrará cómo utilizar la operación de la API v2 de SES [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html) para crear la plantilla. Puede omitir este paso si desea utilizar si desea utilizar una *plantilla en línea*.
En este procedimiento se presupone que ya ha instalado y configurado la AWS CLI. Para obtener más información sobre la instalación y configuración del AWS CLI, consulte la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
**Para crear la plantilla**
1. En un editor de texto, cree un nuevo archivo y pegue el siguiente código para personalizarlo según sus necesidades.
```
{
"TemplateName": "MyTemplate",
"TemplateContent": {
"Subject": "Greetings, {{name}}!",
"Text": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}.",
"Html": "Hello {{name}},
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 Major ",
"Destination": {
"ToAddresses": [
"alejandro.rosalez@example.com", "jimmy.jet@example.com"
]
},
"Content": {
"Template": {
"TemplateName": "MyTemplate",
"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.
+ **TemplateName**— El nombre del `Template` recurso que se va a aplicar al correo electrónico.
+ **TemplateData**— Una cadena JSON de escape que contiene pares clave-valor. Las claves corresponden a las variables definidas en las propiedades `TemplateContent` de la plantilla almacenada, 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).
------
#### [ Inline template code example ]
Observe que las propiedades `TemplateContent` (que normalmente se definirían en una *plantilla almacenada*) se definen *en línea* junto con la propiedad `TemplateData`, lo que la convierte en una *plantilla en línea*.
```
{
"FromEmailAddress": "Mary Major ",
"Destination": {
"ToAddresses": [
"alejandro.rosalez@example.com", "jimmy.jet@example.com"
]
},
"Content": {
"Template": {
"TemplateContent": {
"Subject": "Greetings, {{name}}!",
"Text": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}.",
"Html": "Hello {{name}},
Your 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 Major ",
"DefaultContent": {
"Template": {
"TemplateName": "MyTemplate",
"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 `TemplateName` y.
+ **TemplateName**— El nombre del `Template` recurso que se va a aplicar al correo electrónico.
+ **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 de la plantilla, 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).
------
#### [ Inline template code example ]
Observe que las propiedades `TemplateContent` (que normalmente se definirían en una *plantilla almacenada*) se definen *en línea* junto con la propiedad `TemplateData`, lo que la convierte en una *plantilla en línea*.
```
{
"FromEmailAddress": "Mary Major ",
"DefaultContent": {
"Template": {
"TemplateContent": {
"Subject": "Greetings, {{name}}!",
"Text": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}.",
"Html": "Hello {{name}},
Your 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}}
```