Uso de plantillas de correo electrónico de verificación personalizado - Amazon Simple Email Service

Uso de plantillas de correo electrónico de verificación personalizado

Cuando intenta verificar una dirección de correo electrónico, Amazon SES envía un correo electrónico a esa dirección similar al del ejemplo que se muestra en la siguiente imagen.

Varios clientes de Amazon SES crean aplicaciones (como conjuntos de aplicaciones de marketing por correo electrónico o sistemas de tramitación de incidencias) que envían correo electrónico por medio de Amazon SES en nombre de sus propios clientes. Para los usuarios finales de estas aplicaciones, el proceso de verificación del correo electrónico puede ser confuso: el correo electrónico de verificación utiliza la información de marca de Amazon SES, en lugar de la información de marca de la aplicación, y los usuarios finales nunca se han registrado para utilizar Amazon SES directamente.

Si su caso de uso de Amazon SES requiere que las direcciones de correo electrónico de los clientes se verifiquen para poder usarlas con Amazon SES, puede crear mensajes de correo electrónico de verificación personalizados. Estos mensajes de correo electrónico personalizados ayudan a reducir la confusión de los clientes y aumentan la velocidad a las que sus clientes realizan el proceso de registro.

nota

Para utilizar esta característica, su cuenta de Amazon SES tiene que estar fuera del entorno pruebas. Para obtener más información, consulte Salida del entorno de pruebas de Amazon SES.

Creación de una plantilla de correo electrónico de verificación personalizado

Para crear un mensaje de correo electrónico de verificación personalizado, use la operación de la API CreateCustomVerificationEmailTemplate. Esta operación toma los siguientes parámetros de entrada:

Atributo Descripción
TemplateName El nombre de la plantilla. El nombre que especifique debe ser único.
FromEmailAddress La dirección de correo electrónico desde la que se envía el correo electrónico de verificación. La dirección o el dominio que especifique deben verificarse para su uso con su cuenta de Amazon SES.
nota

El atributo FromEmailAddress no admite nombres de visualización (también conocidos como nombres de "remitente descriptivo").

TemplateSubject La línea de asunto del correo electrónico de verificación.
TemplateContent El cuerpo del mensaje de correo electrónico. El cuerpo del mensaje de correo electrónico pueden contener HTML, con algunas restricciones. Para obtener más información, consulte Preguntas frecuentes sobre el correo electrónico de verificación personalizado.
SuccessRedirectionURL La dirección URL a la que se envía a los usuarios si sus direcciones de correo se verifican correctamente.
FailureRedirectionURL La dirección URL a la que se envía a los usuarios si sus direcciones de correo no se verifican correctamente.

Puede utilizar los SDK de AWS o la AWS CLI para crear una plantilla de correo electrónico de verificación personalizado con la operación CreateCustomVerificationEmailTemplate. Para obtener más información sobre los SDK de AWS, consulte Herramientas para Amazon Web Services. Para obtener más información sobre la AWS CLI, consulte Interfaz de línea de comandos de AWS.

La siguiente sección incluye procedimientos para crear un correo electrónico de verificación personalizado mediante la AWS CLI. Para estos procedimientos se presupone que ha instalado y configurado la AWS CLI. Para obtener más información sobre cómo instalar y configurar la AWS CLI, consulte la Guía del usuario de la AWS Command Line Interface.

nota

To complete the procedure in this section, you must use version 1.14.6 or later of the AWS CLI. For best results, upgrade to the latest version of the AWS CLI. For more information about updating the AWS CLI, see Installing the AWS Command Line Interface in the AWS Command Line Interface Guía del usuario.

  1. En un editor de texto, cree un nuevo archivo. Pegue el siguiente contenido en el editor:

    { "TemplateName": "SampleTemplate", "FromEmailAddress": "sender@example.com", "TemplateSubject": "Please confirm your email address", "TemplateContent": "<html> <head></head> <body style="font-family:sans-serif;"> <h1 style="text-align:center">Ready to start sending email with ProductName?</h1> <p>We here at Example Corp are happy to have you on board! There's just one last step to complete before you can start sending email. Just click the following link to verify your email address. Once we confirm that you're really you, we'll give you some additional information to help you get started with ProductName.</p> </body> </html>", "SuccessRedirectionURL": "https://www.example.com/verifysuccess", "FailureRedirectionURL": "https://www.example.com/verifyfailure" }
    importante

    Para que el ejemplo anterior sea más fácil de leer, el atributo TemplateContent contiene saltos de línea. Si pega el ejemplo anterior en el archivo de texto, elimine los saltos de línea antes de continuar.

    Reemplace los valores de TemplateName, FromEmailAddress, TemplateSubject, TemplateContent, SuccessRedirectionURL y FailureRedirectionURL por sus propios valores. Guarde el archivo como customverificationemail.json.

  2. En la línea de comandos, escriba el siguiente comando para crear la plantilla de correo electrónico de verificación personalizado: aws ses create-custom-verification-email-template --cli-input-json file://customverificationemail.json

  3. Si lo desea, puede confirmar que la plantilla se ha creado escribiendo el siguiente comando: aws ses list-custom-verification-email-templates

Edición de una plantilla de correo electrónico de verificación personalizado

Puede editar una plantilla de correo electrónico de verificación personalizado mediante la operación UpdateCustomVerificationEmailTemplate. Esta operación acepta los mismos parámetros de entrada que la operación CreateCustomVerificationEmailTemplate (es decir, los atributos TemplateName, FromEmailAddress, TemplateSubject, TemplateContent, SuccessRedirectionURL y FailureRedirectionURL). Sin embargo, con la operación UpdateCustomVerificationEmailTemplate, ninguno de estos atributos son obligatorios. Cuando pasa un valor para TemplateName que es igual al nombre de una plantilla de correo electrónico de verificación personalizado, los atributos que especifique sobrescriben los que se encuentran originalmente en la plantilla.

Envío de correos electrónicos de verificación usando plantillas personalizadas

Después de crear al menos una plantilla de correo electrónico de verificación personalizado, puede enviarla a sus clientes llamando a la operación de la API SendCustomVerificationEmail. Puede llamar a la operación SendCustomVerificationEmail mediante cualquiera de los SDK de AWS o la AWS CLI. La operación SendCustomVerificationEmail toma los siguientes parámetros de entrada:

Atributo Descripción
EmailAddress La dirección de correo electrónico que se va a verificar.
TemplateName El nombre de la plantilla de correo electrónico de verificación personalizado que se envía a la dirección de correo electrónico que va a verificar.
ConfigurationSetName (Opcional) El nombre del conjunto de configuración que se va a usar al enviar el correo electrónico de verificación.

Suponga, por ejemplo, que sus clientes se registran en el servicio mediante un formulario de su aplicación. Cuando el cliente completa el formulario y lo envía, su aplicación llama a la operación SendCustomVerificationEmail, pasando la dirección de correo electrónico del cliente y el nombre de la plantilla que desee utilizar.

El cliente recibe un correo electrónico que utiliza la plantilla de correo electrónico personalizado que ha creado. Amazon SES añade automáticamente un enlace único para el destinatario, así como una breve renuncia de responsabilidades. En la siguiente imagen se muestra un correo electrónico de verificación de ejemplo que utiliza la plantilla creada en Creación de una plantilla de correo electrónico de verificación personalizado.

Preguntas frecuentes sobre el correo electrónico de verificación personalizado

Esta sección contiene respuestas a preguntas frecuentes acerca de la característica de plantilla de correo electrónico de verificación personalizado.

P1. ¿Cuántas plantillas de correo electrónico de verificación personalizado puedo crear?

Puede crear hasta 50 plantillas de correo electrónico de verificación personalizado para cada cuenta de Amazon SES.

P2. ¿Cómo se muestran los mensajes de correo electrónico de verificación personalizados a los destinatarios?

Los mensajes de correo electrónico de verificación personalizados incluyen el contenido que especificó al crear la plantilla, seguido de un enlace en el que los destinatarios deben hacer clic para verificar sus direcciones de correo electrónico.

P3. ¿Puedo obtener una vista previa del correo electrónico de verificación personalizado?

Para obtener una vista previa de un correo electrónico de verificación personalizado, utilice la operación SendCustomVerificationEmail para enviar un correo electrónico de verificación a una dirección de su propiedad. Si no hace clic en el enlace de verificación, Amazon SES no crea una nueva identidad. Si hace clic en el enlace de verificación, tiene la opción de eliminar la identidad recién creada mediante la operación DeleteIdentity.

P4. ¿Puedo incluir imágenes en mis plantillas de correo electrónico de verificación personalizado?

Puede incrustar imágenes en el código HTML para las plantillas a través de la codificación Base64. Cuando incrusta imágenes de esta forma, Amazon SES las convierte automáticamente en archivos adjuntos. Puede codificar una imagen en la línea de comandos ejecutando uno de los siguientes comandos:

  • Linux, macOS, or Unix: base64 -i imagefile.png | tr -d '\n' > output.txt

  • Windows: certutil -encode imagefile.png output.tmp && findstr /v /c:- output.tmp > output.txt && del output.tmp

Reemplace imagefile.png por el nombre del archivo que desea codificar. En ambos de los comandos anteriores, la imagen codificada en Base64 se almacena en output.txt.

nota

Si ha codificado la imagen mediante la línea de comandos de Windows, debe abrir output.txt en un editor de texto y eliminar los saltos de línea del archivo antes de continuar.

Puede incrustar la imagen codificada en Base64 incluyendo lo siguiente en el código HTML de la plantilla: <img src="data:image/png;base64,base64EncodedImage"/>

En el ejemplo anterior, sustituya png por el tipo de archivo de la imagen codificada (por ejemplo, jpg o gif) y sustituya base64EncodedImage por la imagen codificada en Base64 (es decir, el contenido de output.txt de uno de los comandos anteriores).

P5. ¿Existe algún límite en el contenido que puedo incluir en las plantillas de correo electrónico de verificación personalizado?

Las plantillas de correo electrónico de verificación personalizado no pueden tener más de 10 MB. Además, las plantillas de correo electrónico de verificación personalizado que contienen HTML solo pueden utilizar las etiquetas y atributos que se muestran en la siguiente tabla:

Etiqueta HTML Atributos permitidos
abbr class, id, style, title
acronym class, id, style, title
address class, id, style, title
area class, id, style, title
b class, id, style, title
bdo class, id, style, title
big class, id, style, title
blockquote cite, class, id, style, title
body class, id, style, title
br class, id, style, title
button class, id, style, title
caption class, id, style, title
center class, id, style, title
cite class, id, style, title
code class, id, style, title
col class, id, span, style, title, width
colgroup class, id, span, style, title, width
dd class, id, style, title
del class, id, style, title
dfn class, id, style, title
dir class, id, style, title
div class, id, style, title
dl class, id, style, title
dt class, id, style, title
em class, id, style, title
fieldset class, id, style, title
font class, id, style, title
form class, id, style, title
h1 class, id, style, title
h2 class, id, style, title
h3 class, id, style, title
h4 class, id, style, title
h5 class, id, style, title
h6 class, id, style, title
head class, id, style, title
hr class, id, style, title
html class, id, style, title
i class, id, style, title
img align, alt, class, height, id, src, style, title, width
input class, id, style, title
ins class, id, style, title
kbd class, id, style, title
label class, id, style, title
legend class, id, style, title
li class, id, style, title
map class, id, style, title
menu class, id, style, title
ol class, id, start, style, title, type
optgroup class, id, style, title
option class, id, style, title
p class, id, style, title
pre class, id, style, title
q cite, class, id, style, title
s class, id, style, title
samp class, id, style, title
select class, id, style, title
small class, id, style, title
span class, id, style, title
strike class, id, style, title
strong class, id, style, title
sub class, id, style, title
sup class, id, style, title
table class, id, style, summary, title, width
tbody class, id, style, title
td abbr, axis, class, colspan, id, rowspan, style, title, width
textarea class, id, style, title
tfoot class, id, style, title
th abbr, axis, class, colspan, id, rowspan, scope, style, title, width
thead class, id, style, title
tr class, id, style, title
tt class, id, style, title
u class, id, style, title
ul class, id, style, title, type
var class, id, style, title

P6. ¿Cuántas direcciones de correo electrónico verificadas pueden existir en mi cuenta?

Su cuenta de Amazon SES puede tener hasta 10 000 identidades verificadas en cada región de AWS. En Amazon SES; las identidades incluyen dominios y direcciones de correo electrónico verificados.

P7. ¿Puedo crear plantillas de correo electrónico de verificación personalizado mediante la consola de Amazon SES?

Actualmente, solo es posible crear, editar y eliminar los mensajes de correo electrónico de verificación personalizados mediante la API de Amazon SES.

P8. ¿Puedo realizar un seguimiento de los eventos "open" y "click" que se producen cuando los clientes reciben mensajes de correo electrónico de verificación personalizados?

Los mensajes de correo electrónico de verificación personalizados no pueden incluir un seguimiento de los eventos "open" o "click".

P9. ¿Pueden los mensajes de correo electrónico de verificación personalizados incluir encabezados personalizados?

Los mensajes de correo electrónico de verificación personalizados no pueden incluir encabezados personalizados.

P10. ¿Puedo eliminar el texto que aparece en la parte inferior de los mensajes de correo electrónico de verificación personalizados?

El siguiente texto se añade automáticamente al final de cada mensaje de correo de verificación personalizado y no se puede eliminar:

If you did not request to verify this email address, please disregard this message. If you have any concerns, please forward this message to the following email address along with your questions or comments. (Si no ha solicitado la verificación de esta dirección de correo electrónico, omita este mensaje. Si tiene alguna duda, reenvíe este mensaje a la siguiente dirección de correo electrónico junto con sus preguntas o comentarios).

El enlace de dirección de correo electrónico en este texto hace referencia a aws-email-domain-verification@amazon.com, una bandeja de entrada que es monitoreada activamente por el equipo de Amazon SES.

P11. ¿Están los mensajes de correo electrónico de verificación personalizados firmados con DKIM?

Para que los mensajes de correo electrónico de verificación se firmen con DKIM, la dirección de correo electrónico que especifique en el atributo FromEmailAddress al crear la plantilla de correo electrónico de verificación debe configurarse para generar una firma DKIM. Para obtener más información sobre cómo configurar DKIM para los dominios y direcciones de correo electrónico, consulte Autenticación de correo electrónico con DKIM en Amazon SES.

P12. ¿Por qué no aparecen las operaciones de la API de la plantilla de correo electrónico de verificación personalizada en el SDK o en la CLI?

Si no puede utilizar las operaciones de la plantilla de correo electrónico de verificación personalizada en una SDK o en la AWS CLI, es posible que esté utilizando una versión más antigua del SDK o de la CLI. Las operaciones de la plantilla de correo electrónico de verificación personalizada están disponibles en los siguientes SDK y CLI:

  • Versión 1.14.6 o posterior de la AWS Command Line Interface

  • Versión 3.3.205.0 o posterior del AWS SDK para .NET

  • Versión 1.3.20170531.19 o posterior del AWS SDK para C++

  • Versión 1.12.43 o posterior del AWS SDK for Go

  • Versión 1.11.245 o posterior del AWS SDK for Java

  • Versión 2.166.0 o posterior del AWS SDK for JavaScript

  • Versión 3.45.2 o posterior del AWS SDK para PHP

  • Versión 1.5.1 o posterior del AWS SDK for Python (Boto)

  • Version 1.5.0 o posterior de la gema aws-sdk-ses en el AWS SDK parar Ruby

P13. ¿Por qué recibo errores ProductionAccessNotGranted cuando envío correos electrónicos de verificación personalizados?

El error ProductionAccessNotGranted indica que su cuenta sigue estando en el entorno de pruebas de Amazon SES. Solo puede enviar correos electrónicos de verificación personalizados si su cuenta se ha eliminado del entorno de pruebas. Para obtener más información, consulte Salida del entorno de pruebas de Amazon SES.