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. # Gestión de listas y suscripciones en Amazon Simple Email Service Puede administrar sus propias listas para envío de correo y suscripciones, así como para supresión de correo electrónico en Amazon SES. Para ayudarle a mantener su reputación como remitente, SES ofrece supresión de nivel de cuenta y de nivel de conjunto de configuración que le impide enviar correos a destinatarios no válidos y perjudicar su reputación como remitente. Como medida adicional contra los rebotes y los reclamos de correo electrónico, SES puede agregar automáticamente enlaces de cancelación de suscripción a todo el correo saliente a través de la gestión de suscripciones. Cada uno de estos tipos de listas se analiza en detalle en las secciones enumeradas en los temas de este capítulo; sin embargo, aquí se presenta información general de las listas de supresión para entender las diferencias entre ellas, así como un cambio clave en la administración global de las listas de supresión. Se sugiere que lea esta información general antes de trabajar con cualquiera de las listas analizadas en este capítulo. **Descripción general de las listas de supresión y del mecanismo de anulación de la supresión** La característica de eliminación de listas de supresión global ya no está orientada al cliente y ya no interactuará con ella para administrar la supresión. La lista de supresión global funciona y es administrada en segundo plano por SES. Como cliente, ahora tiene a su disposición listas de supresión para cuentas y anulaciones de supresión para conjuntos de configuración que le ofrecen un control más personalizado sobre la gestión de la supresión de correo electrónico de su propia cuenta. A continuación se explican los diferentes tipos de listas de supresión, su alcance y las ventajas que ofrecen. + **Lista de supresión global**: propiedad y administración a cargo de SES para proteger la reputación de las direcciones del grupo de direcciones IP compartidas de SES. + **Lista de supresión para cuentas**: propiedad y administración a cargo del cliente para proteger la reputación de su cuenta; *reemplaza la lista de supresión global*. + **Supresión para conjuntos de configuración**: mecanismo de anulación para proporcionar un control condicional o detallado de la lista de supresión para cuentas mediante el uso de anulaciones especificadas en un conjunto de configuración. *La lista de supresión global* era el único tipo de lista de supresión hasta que se introdujo la supresión para cuentas y conjuntos de configuración en la nueva consola y en la API v2 de Amazon SES. La propiedad y administración de la lista de supresión global está a cargo de SES para proteger la reputación de las direcciones del grupo de IP compartidas de SES. Esto es necesario porque todos los clientes de SES comparten el mismo conjunto de direcciones IP (a menos que tengan direcciones dedicadas IPs), por lo que es importante que SES se asegure de que los clientes no envían spam ni nada que pueda afectar negativamente a la reputación de esas direcciones IP en el grupo de IP compartidas de SES. Si bien usted ya no interactúa directamente con la lista de supresión global, esta sigue funcionando en segundo plano y sus principios generales de funcionamiento también se pueden aplicar para explicar los de los otros tipos de supresión. Consulte [Lista de supresión global de Amazon SES](sending-email-global-suppression-list.md). **nota** El formulario de solicitud de eliminación de listas de supresión global ya no se encuentra en la consola de Amazon SES porque la lista de supresión a nivel de cuenta lo ha sustituido, con motivo de todas las ventajas que se explican en esta sección. Se ha introducido la *lista de supresión para cuentas* para que los clientes puedan crear y controlar sus propias listas de supresión y reputación, por lo que la lista de supresión para cuentas se aplica únicamente a su cuenta. La interfaz de lista de supresión de nivel de cuenta de la nueva consola proporciona una forma sencilla de administrar las direcciones de la lista de supresión de nivel de cuenta, incluidas acciones masivas para agregar o quitar direcciones. Si una dirección está en la lista global de supresión, pero no en su lista de supresión de nivel de cuenta *(lo que significa que quiere realizar envíos a esa dirección)*, y así lo hace, Amazon SES seguirá intentando realizar la entrega, pero si rebota, el rebote afectará su reputación, pero nadie más recibirá rebotes porque no podrán realizar envíos a esa dirección de correo electrónico si no están utilizando su propia lista de supresión de nivel de cuenta; por lo tanto, la lista de supresión de nivel de cuenta anula la lista de supresión global únicamente para su cuenta. Consulte [Uso de la lista de supresión de nivel de cuenta de Amazon SES](sending-email-suppression-list.md). La *supresión para conjuntos de configuración* aunque no es una lista propiamente dicha, ofrece un mecanismo que le permite configurar personalizaciones de supresión e invalidaciones en la lista de supresión de cuentas a través del uso de conjuntos de configuración creados específicamente para diferentes escenarios de envío de correo electrónico. Por ejemplo, si la lista de supresión de nivel de cuenta está configurada para agregar direcciones de rebote y reclamación, pero tiene un determinado grupo demográfico de correo electrónico definido en un conjunto de configuración para el que solo le interesa agregar direcciones de reclamación, lo lograría habilitando las invalidaciones de supresión del conjunto de configuración para que las direcciones de correo electrónico se agreguen a la lista de supresión de nivel de cuenta solo para reclamaciones (no rebotes y reclamaciones como se establece en la lista de supresión de nivel de cuenta) del correo electrónico enviado con este conjunto de configuración. Con la supresión de nivel de conjunto de configuración, existen diferentes niveles de invalidación de la supresión de nivel de cuenta, incluso no utilizar ninguna supresión. Consulte [Uso de la supresión de nivel de conjunto de configuración para invalidar la lista de supresión de nivel de cuenta](sending-email-suppression-list-config-level.md). **Topics** + [Lista de supresión global de Amazon SES](sending-email-global-suppression-list.md) + [Uso de la lista de supresión de nivel de cuenta de Amazon SES](sending-email-suppression-list.md) + [Uso de la supresión de nivel de conjunto de configuración para invalidar la lista de supresión de nivel de cuenta](sending-email-suppression-list-config-level.md) + [Uso de la administración de listas](sending-email-list-management.md) + [Uso de la administración de suscripciones](sending-email-subscription-management.md) # Lista de supresión global de Amazon SES Amazon SES mantiene una *lista de supresión global* interna que es administrada en segundo plano por SES. Cuando un cliente de SES envía un correo electrónico que produce un rechazo permanente, SES agrega la dirección de correo electrónico que produjo el rebote a una lista de supresión global. La lista de supresión global es *global* en el sentido de que se aplica a todos los clientes de SES. En otras palabras, si otro cliente intenta enviar un correo electrónico a una dirección incluida en la lista de supresión global, SES acepta el mensaje pero no lo envía, ya que la dirección de correo electrónico está suprimida. La característica de solicitud de eliminación de direcciones de correo electrónico de listas de supresión global *ya no está orientada al cliente y ya no interactuará con ella* para administrar la supresión. Para sustituir esta funcionalidad, Amazon SES ofrece ahora una nueva forma de administrar la supresión poniendo a su disposición una **lista de supresión para cuentas** y **anulaciones de supresiones para conjuntos de configuración** que ofrecen un control más personalizado sobre la gestión de la supresión de correo electrónico en su propia cuenta. Para obtener más información, consulte [Uso de la lista de supresión de nivel de cuenta de Amazon SES](sending-email-suppression-list.md) y [Uso de la supresión de nivel de conjunto de configuración para invalidar la lista de supresión de nivel de cuenta](sending-email-suppression-list-config-level.md). **importante** El formulario de solicitud de supresión de direcciones de correo electrónico de la lista de supresión global ya no se encuentra en la consola de Amazon SES porque la lista de supresión a nivel de cuenta la ha sustituido. Para obtener más información acerca de cómo utilizar la lista de supresión a nivel de cuenta, consulte [Uso de la lista de supresión de nivel de cuenta de Amazon SES](sending-email-suppression-list.md). ## Consideraciones sobre la lista de supresión global Factores clave de la lista de supresión global: + La lista de supresión global es administrada en segundo plano por SES; no puede interactuar directamente con ella; sin embargo, puede anularla al utilizar su propia [lista de supresión a nivel de cuenta](sending-email-suppression-list.md). + La lista de supresión global está habilitada de forma predeterminada para todas las cuentas de SES. No se puede desactivar. + Como SES aplica la lista de supresión global a todos los clientes, no puede consultar la lista de supresión global ni agregar direcciones manualmente. + Cuando una dirección de correo electrónico produce un rechazo permanente, SES agrega la dirección a la lista de supresión global por un breve periodo. Después de ese periodo, SES elimina la dirección de la lista. Si la dirección produce otro rechazo permanente, SES la agrega de nuevo a la lista de supresión global durante un periodo más largo y la elimina al final de ese periodo. La cantidad de tiempo que una dirección permanece en la lista de supresión global aumenta cada vez que la dirección produce un rechazo permanente. Una dirección puede permanecer en la lista de supresión global durante un periodo máximo de 14 días. + Si intenta enviar un mensaje a una dirección incluida en la lista de supresión global, SES acepta el mensaje, pero no lo envía. SES genera una notificación de rebote con el valor `bounceType` de `Permanent` y el valor `bounceSubType` de `Suppressed`. Recibir este tipo de notificación de rebote es la única forma de saber si una dirección está en la lista de supresión global. No se puede consultar la lista de supresión global. + SES contabiliza los mensajes que envía a las direcciones de la lista de supresión global en el cálculo de la tasa de rebotes de su cuenta y en su cuota de envío diaria. + Al igual que en el caso de una dirección de correo electrónico que produce un rebote permanente, debe eliminar de su lista de correo las direcciones que provocan un rebote de lista de supresión a menos que esté absolutamente seguro de que la dirección es válida. + Los rebotes de lista de supresión se incluyen en la tasa de rebotes de su cuenta. Si la tasa de rebotes es demasiado alta, su cuenta podría someterse a un proceso de revisión o podría suspenderse la capacidad de su cuenta para enviar correo electrónico. **nota** Es importante entender cómo las tres listas de supresión de SES están interrelacionadas y conocer su jerarquía; para ello, consulte [Descripción general de las listas de supresión y del mecanismo de anulación de la supresión](lists-and-subscriptions.md#3-suppression-overview). # Uso de la lista de supresión de nivel de cuenta de Amazon SES Se ha introducido la lista de supresión para cuentas de Amazon SES para que los clientes puedan crear y controlar sus propias listas de supresión y administrar su reputación; de este modo, la lista de supresión para cuentas se aplica únicamente a su cuenta. La interfaz de lista de supresión de nivel de cuenta de la consola de SES proporciona una forma sencilla de administrar las direcciones de la lista de supresión de nivel de cuenta, incluidas acciones masivas para agregar o quitar direcciones. SES incluye una *lista de supresión de nivel de cuenta* que se aplica a la Cuenta de AWS en la Región de AWS actual. Puede agregar o eliminar direcciones, ya sea de manera individual o en bloque, en la lista de supresión de nivel de cuenta mediante la API v2 de SES o la consola. **nota** Para agregar o eliminar direcciones en bloque, debe tener acceso de producción. Para obtener más información sobre el entorno de pruebas, consulte [Solicitud de acceso de producción (salida del entorno de pruebas de Amazon SES)](request-production-access.md). **importante** Las listas de supresión de cuentas de SES distinguen entre mayúsculas y minúsculas. Cuando se agrega una dirección de correo electrónico a la lista de supresión, como *Usuario@Ejemplo.com*, se guarda exactamente como se recibe, conservando el uso original de mayúsculas y minúsculas. Si bien la funcionalidad de envío de correo electrónico trata como si fueran idénticas las direcciones con mayúsculas y minúsculas diferentes (por ejemplo, *Usuario@Ejemplo.com* es igual a *usuario@ejemplo.com*), las llamadas a la API para administrar las listas de supresión requieren que coincidan exactamente las mayúsculas y minúsculas. Por lo tanto, cuando utilice APIs información relacionada con la gestión de listas de supresión, asegúrese de utilizar las mayúsculas y minúsculas exactas de la dirección de correo electrónico tal como aparece en la lista de supresión. ## Consideraciones de la lista de supresión de nivel de cuenta de Amazon SES Debe tener en cuenta los siguientes factores cuando utilice la lista de supresión de nivel de cuenta: + Si comenzó a usar Amazon SES después del 25 de noviembre de 2019, su cuenta utiliza la lista de supresión de nivel de cuenta de forma predeterminada, tanto para los rebotes como para los reclamos. Si comenzó a usar SES antes de esta fecha, debe habilitar esta característica mediante la operación `PutAccountSuppressionAttributes` en la API de SES. + Si intenta enviar un mensaje a una dirección incluida en la lista de supresión en el nivel de la cuenta que tiene un motivo de supresión que coincide con el motivo de supresión elegido para la *configuración* de la supresión en el nivel de la cuenta, SES acepta el mensaje, pero no lo envía; sin embargo, si no coincide, SES lo *enviará*. Para ayudar a aclarar esto, se proporcionan los siguientes ejemplos: + Si ha establecido la configuración de supresión en el nivel de la cuenta con el motivo de supresión de *solo rebotes*, SES no intentará realizar envíos a direcciones en la lista de supresión en el nivel de la cuenta cuyo motivo de supresión sea *rebote*. Sin embargo, SES *intentará* realizar el envío a las direcciones de la lista de supresión del nivel de la cuenta con el motivo de supresión *Reclamación* (porque en este caso, no coinciden). + Si ha establecido la configuración de supresión en el nivel de la cuenta con el motivo de supresión de *rebotes y reclamaciones*, SES no intentará realizar envíos a direcciones en la lista de supresión en el nivel de la cuenta cuyo motivo de supresión sea *rebote* o *reclamación*. + *SES no tiene en cuenta los mensajes que envías a las direcciones de tu lista de direcciones suprimidas a nivel de cuenta a efectos de reputación. *BounceRate*o reputación. ComplaintRate*métricas en el espacio de nombres AWS/SES de tu cuenta. Estos mensajes se cuentan en las métricas *Rebote* o *Queja* del espacio de nombres AWS/SES. + Si una dirección está en la lista de supresión global, pero no en la lista de supresión en el nivel de la cuenta, *(lo que significa que desea enviarla)*, y la envía a esta, SES todavía intentará la entrega; sin embargo, si rebota, lo tendrá en cuenta al calcular la tasa de devolución de la cuenta y la cuota de envío diaria. + SES contabiliza los mensajes que envía a las direcciones de la lista de supresión de nivel de cuenta en el cálculo de la cuota de envío diaria. + Las direcciones de correo electrónico de la lista de supresión de nivel de cuenta permanecen allí hasta que las elimine. + Si la capacidad de la cuenta para enviar correo electrónico está suspendida, SES elimina de forma automática las direcciones de la lista de supresión correspondiente a la cuenta después de 90 días. Si la capacidad de su cuenta para enviar correo electrónico se restaura antes de que finalice este periodo de 90 días, las direcciones incluidas en la lista no se eliminan. + Gmail no proporciona datos de reclamaciones a SES. Si un destinatario utiliza el botón **Spam** del cliente web de Gmail para informar de que ha recibido un mensaje suyo como spam, no se agregará a la lista de supresión de nivel de cuenta. + Puede habilitar la lista de supresión de nivel de cuenta si la cuenta está en el entorno aislado de SES. Sin embargo, no puedes usar la [CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operación [PutSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutSuppressedDestination)o hasta que elimines tu cuenta del entorno limitado. Para obtener más información sobre el entorno de pruebas, consulte [Solicitud de acceso de producción (salida del entorno de pruebas de Amazon SES)](request-production-access.md). + Solo las devoluciones permanentes se agregan a la lista de supresión a nivel de la cuenta. Para obtener información acerca de las devoluciones permanentes y devoluciones temporales, consulte [Después de que Amazon SES envíe un correo electrónico](send-email-concepts-process.md#send-email-concepts-process-after-send). + Cuando utiliza la lista de supresión en el nivel de la cuenta, SES también agrega direcciones que producen devoluciones permanentes a la lista de supresión global. **nota** En los procedimientos de las secciones siguientes se da por sentado que ya ha instalado la AWS CLI. Para obtener más información sobre la instalación y configuración de AWS CLI, consulta la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/). ## Habilitar la lista de supresión de nivel de cuenta de Amazon SES Puede usar la [PutAccountSuppressionAttributes](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountSuppressionAttributes.html)operación de la API v2 de Amazon SES para habilitar y configurar su lista de supresión a nivel de cuenta. Para establecer esta configuración de forma rápida y fácil, utilice 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](https://docs.aws.amazon.com/cli/latest/userguide/). **Para configurar su lista de supresión a nivel de cuenta mediante el AWS CLI** + En la línea de comandos, introduzca el comando siguiente: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 put-account-suppression-attributes \ --suppressed-reasons BOUNCE COMPLAINT ``` ------ #### [ Windows ] ``` aws sesv2 put-account-suppression-attributes ` --suppressed-reasons BOUNCE COMPLAINT ``` ------ Para habilitar la lista de supresión de nivel de cuenta, debe especificar al menos un motivo para el parámetro `suppressed-reasons`. Puede especificar `BOUNCE` o `COMPLAINT`, o bien ambos, como se muestra en el ejemplo anterior. **Para configurar la lista de supresión de nivel de cuenta mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En el panel **Account-level settings (Configuración de nivel de cuenta)**, seleccione **Edit (Editar)**. 1. En **Suppression list (Lista de supresión)**, marque la casilla **Enabled (Habilitado)**. 1. En **Suppression reasons (Motivos de supresión)**, seleccione uno de los motivos por los que se deben agregar de forma automática las direcciones de correo electrónico de los destinatarios a su lista de supresión de nivel de cuenta. 1. Seleccione **Save changes (Guardar cambios)**. ## Activación de la lista de supresión de nivel de cuenta de Amazon SES para un conjunto de configuración También puede configurar la supresión de nivel de cuenta de Amazon SES para que solo se aplique a [conjuntos de configuración](using-configuration-sets.md) específicos. Cuando lo haga, las direcciones solo se añaden a la lista de supresión si especificó el conjunto de configuración al enviar el correo electrónico que causó el evento de rebote o reclamación. **Para configurar su lista de supresión a nivel de cuenta para un conjunto de configuraciones mediante el AWS CLI** + En la línea de comandos, introduzca el comando siguiente: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 put-configuration-set-suppression-options \ --configuration-set-name configSet \ --suppressed-reasons BOUNCE COMPLAINT ``` ------ #### [ Windows ] ``` aws sesv2 put-configuration-set-suppression-options ` --configuration-set-name configSet ` --suppressed-reasons BOUNCE COMPLAINT ``` ------ En el ejemplo anterior, *configSet* sustitúyalo por el nombre del conjunto de configuraciones que debe usar tu lista de supresión a nivel de cuenta. **Para configurar la lista de supresión de nivel de cuenta para un conjunto de configuración mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Configuration sets (Conjuntos de configuración)**. 1. En **Configuration sets (Conjuntos de configuración)**, elija el nombre del conjunto de configuración que desea configurar con supresión personalizada. 1. En el panel **Suppression list options (Opciones de lista de supresión)**, elija **Edit (Editar)**. 1. La sección **Suppression list options (Opciones de lista de supresión)** proporciona un conjunto de decisiones para definir la supresión personalizada, a partir de la opción de utilizar este conjunto de configuración para anular la supresión de nivel de cuenta. El [mapa lógico de supresión de nivel de conjunto de configuración](sending-email-suppression-list-config-level.md) le ayudará a comprender los efectos de las combinaciones de anulación. Estas selecciones de anulaciones de varios niveles se pueden combinar para implementar tres niveles diferentes de supresión: 1. **Use account-level suppression (Utilizar supresión de nivel de cuenta):** no anular la supresión de nivel de cuenta y no implementar ninguna supresión de nivel de conjunto de configuración; básicamente, cualquier correo electrónico enviado con este conjunto de configuración solo utilizará la supresión de nivel de cuenta. Para ello: 1. En **Suppression list settings (Configuración de lista de supresión)**, desmarque la casilla **Override account level settings (Anular la configuración de nivel de cuenta)**. 1. **Do not use any suppression (No utilizar ninguna supresión):** anular la supresión de nivel de cuenta sin habilitar ninguna supresión de nivel de conjunto de configuración; esto significa que cualquier correo electrónico enviado con este conjunto de configuración no utilizará ninguna supresión de nivel de cuenta; en otras palabras, se cancelará toda supresión. Para ello: 1. En **Suppression list settings (Configuración de lista de supresión)**, marque la casilla **Override account level settings (Anular la configuración de nivel de cuenta)**. 1. En **Suppression list (Lista de supresión)**, desmarque la casilla **Enabled (Habilitado)**. 1. **Use configuration set-level suppression (Utilizar supresión de nivel de conjunto de configuración):** anular la supresión de nivel de cuenta con configuraciones de la lista de supresión personalizada definida en este conjunto de configuración; esto significa que cualquier correo electrónico enviado con este conjunto de configuración solo utilizará su propia configuración de supresión e ignorará cualquier configuración de supresión de nivel de cuenta. Para ello: 1. En **Suppression list settings (Configuración de lista de supresión)**, marque la casilla **Override account level settings (Anular la configuración de nivel de cuenta)**. 1. En **Suppression list (Lista de supresión)**, marque **Enabled (Habilitado)**. 1. En **Specify the reason(s)... [Especificar el motivo (s)...]**, seleccione uno de los motivos de supresión que utilizará este conjunto de configuración. 1. Seleccione **Save changes (Guardar cambios)**. ## Agregar direcciones de correo electrónico individuales a la lista de supresión a nivel de cuenta de Amazon SES Puede añadir direcciones individuales a su lista de supresión a nivel de cuenta de Amazon SES mediante la [PutSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutSuppressedDestination.html)operación de la API de SES v2. No hay límite para el número de direcciones que puede agregar a la lista de supresión de nivel de cuenta. **Para añadir direcciones individuales a su lista de direcciones suprimidas a nivel de cuenta, utilice la AWS CLI** + En la línea de comandos, introduzca el comando siguiente: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 put-suppressed-destination \ --email-address recipient@example.com \ --reason BOUNCE ``` ------ #### [ Windows ] ``` aws sesv2 put-suppressed-destination ` --email-address recipient@example.com ` --reason BOUNCE ``` ------ En el ejemplo anterior, *recipient@example.com* sustitúyala por la dirección de correo electrónico que deseas añadir a tu lista de supresión a nivel de cuenta y *BOUNCE* por el motivo por el que vas a añadir la dirección a la lista de supresión (los valores aceptables son y). `BOUNCE` `COMPLAINT` **Para agregar direcciones individuales a la lista de supresión de nivel de cuenta mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En el panel **Suppression list (Lista de supresión)**, seleccione **Add email address (Agregar dirección de correo electrónico)**. 1. Escriba una dirección de correo electrónico en el campo **Email address** (Dirección de correo electrónico) y seleccione un motivo en **Suppression reason** (Motivo de supresión); si tiene que escribir más direcciones, elija **Enter another address** (Ingresar otra dirección) y repita la operación para cada una de ellas. 1. Cuando termine de ingresar las direcciones, revise los datos para verificar que sean correctos. Si decide que alguna de las direcciones ingresadas no debería formar parte de este envío, elija el botón **Remove** (Eliminar). 1. Elija **Save changes** (Guardar cambios) para agregar las direcciones de correo electrónico ingresadas a su lista de supresión de nivel de cuenta. ## Agregar direcciones de correo electrónico en bloque a la lista de supresión de nivel de cuenta de Amazon SES Para añadir direcciones de forma masiva, cargue primero su lista de contactos en un objeto de Amazon S3 y, a continuación, utilice la [CreateImportJob](#CIJ-add-bulk-API)operación de la API de Amazon SES v2. **nota** No hay límite para el número de direcciones que puede agregar a la lista de supresión de nivel de cuenta, pero hay un límite de adición en bloque de 100 000 direcciones en un objeto de Simple Storage Service (Amazon S3) por llamada a la API. No puede ejecutar más de 20 trabajos de importación simultáneos. Si su origen de datos es un bucket de S3, debe existir en la misma región a la que se está importando. Para agregar direcciones de correo electrónico en bloque a su lista de supresión de nivel de cuenta, realice los pasos siguientes. + Cargue su lista de direcciones en un objeto de Amazon S3 en formato CSV o JSON. Ejemplo de formato CSV para agregar direcciones: `recipient1@example.com,BOUNCE` `recipient2@example.com,COMPLAINT` Solo se admiten archivos JSON delimitados por saltos de línea. En este formato, cada línea es un objeto JSON completo que contiene una definición de dirección individual. Ejemplo de formato JSON para agregar direcciones: `{"emailAddress":"recipient1@example.com","reason":"BOUNCE"}` `{"emailAddress":"recipient2@example.com","reason":"COMPLAINT"}` En los ejemplos anteriores, sustituya *recipient1@example.com* y *recipient2@example.com* por las direcciones de correo electrónico que desee añadir a su lista de supresión a nivel de cuenta. Las razones aceptables por las que agrega las direcciones a la lista de supresión son `BOUNCE` y `COMPLAINT`. + Otorgue permiso a SES para utilizar su clave de AWS KMS . Si el objeto de Amazon S3 está cifrado con una AWS KMS clave, debe dar permiso a Amazon SES para usar la AWS KMS clave. SES solo puede obtener el permiso de una clave administrada por el cliente, no de una clave de KMS predeterminada. Debe otorgar permiso a SES para utilizar la clave administrada por el cliente. Para ello, agregue una instrucción a la política de la clave. Pegue la siguiente instrucción de política en la política de claves para permitir que SES utilice su clave administrada por el cliente. ``` { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" } ``` + Utilice la [CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operación en la API v2 de SES. **nota** En el ejemplo siguiente se presupone que ya ha instalado 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/). En la línea de comandos, escriba el comando siguiente: *s3bucket*Sustitúyalo por el nombre de un bucket de Amazon S3 y *s3object* por el nombre de un objeto de Amazon S3. ``` aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=PUT} --import-data-source S3Url=s3://s3bucket/s3object,DataFormat=CSV ``` **Para agregar direcciones en bloque a la lista de supresión de nivel de cuenta mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En la tabla **Suppression list (Lista de supresión)**, expanda el botón **Bulk actions (Acciones masivas)** y seleccione **Add email addresses in bulk (Agregar direcciones de correo electrónico en forma masiva)**. 1. En **Bulk action specifications (Especificaciones de acción masiva)**, seleccione entre: (a)**Choose file from S3 bucket (Elegir un archivo del bucket de S3)** o b)**Import from file (Importar desde archivo)**; se establecen procedimientos para cada método de importación: 1. **Choose file from S3 bucket (Elegir un archivo del bucket de S3)**; *si el archivo de origen ya se ha almacenado en un bucket de Amazon S3*: 1. Si conoce el URI del bucket de Amazon S3 que desea utilizar, ingréselo en el campo **Amazon S3 URI (URI de Amazon S3)**; de lo contrario, elija **Browse S3 (Examinar S3)**: 1. En **Buckets (Buckets)**, elija el nombre del bucket de S3. 1. En **Objects (Objetos)**, seleccione el nombre del archivo y, a continuación, seleccione **Choose (Elegir)**, esto lo redirigirá a **Bulk action specifications (Especificaciones de acción masiva)**. 1. (Opcional) Si desea dirigirse a la consola de Amazon S3 para ver detalles sobre su objeto de S3, elija **View (Vista)**. 1. En **File format (Formato de archivo)**, seleccione el formato del archivo que ha elegido importar de su bucket de Amazon S3. 1. Elija **Add email addresses (Agregar direcciones de correo electrónico)** para iniciar la importación de direcciones de su archivo; aparecerá una tabla debajo de la pestaña **Bulk actions (Acciones masivas)**. 1. **Import from file (Importar desde archivo)**, *si tiene un archivo de origen local para cargar en un bucket de Amazon S3 nuevo o existente*: 1. En **Import source file (Importar archivo de origen)**, seleccione **Choose file (Elegir archivo)**. 1. Seleccione el archivo JSON o CSV en el explorador de archivos y elija **Open (Abrir)**, verá el nombre, el tamaño y la fecha de su archivo debajo del botón **Choose file (Elegir archivo)**. 1. Expanda **Amazon S3 bucket (Bucket de Amazon S3)** y seleccione el bucket de S3. 1. Para cargar el archivo en un bucket nuevo, elija **Create S3 bucket (Crear bucket de S3)**, escriba un nombre en el campo **Bucket name (Nombre del bucket)** y elija **Create bucket (Crear bucket)**. 1. Elija **Add email addresses (Agregar direcciones de correo electrónico)** para iniciar la importación de direcciones de su archivo; aparecerá una tabla debajo de la pestaña **Bulk actions (Acciones masivas)**. 1. Independientemente del método de importación que haya utilizado, su ID de trabajo aparecerá en **Bucket name (Acciones masivas)**, junto con el tipo de importación, el estado y la fecha; para ver los detalles del trabajo, seleccione el ID del trabajo. 1. Seleccione la pestaña **Supression list (Lista de supresión)** y se mostrarán todas las direcciones de correo electrónico importadas correctamente, junto con el motivo de supresión y la fecha; están disponibles las siguientes opciones: 1. Seleccione una dirección de correo electrónico o marque su casilla de verificación correspondiente y elija **View report (Ver informe)** para ver los detalles. (Si se trata de una dirección que se ha agregado en forma automática a su lista de supresión debido a un rebote o reclamo, se mostrará información sobre el evento de valoración que provocó que se agregue, incluidos detalles sobre el mensaje de correo electrónico que produjo el evento desencadenador). 1. Marque la casilla de verificación correspondiente de una o más direcciones de correo electrónico que desea eliminar de la lista de supresión de cuenta y elija **Remove (Eliminar)**. ## Ver una lista de las direcciones que están en la lista de supresión de nivel de cuenta de Amazon SES Puede ver una lista de todas las direcciones de correo electrónico que figuran en la lista de direcciones suprimidas a nivel de cuenta de su cuenta mediante la [ListSuppressedDestinations](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListSuppressedDestinations.html)operación de la API de SES v2. **Para ver una lista de todas las direcciones de correo electrónico que están en la lista de supresión de nivel de cuenta** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 list-suppressed-destinations ``` El comando anterior devuelve todas las direcciones de correo electrónico que están en la lista de supresión de nivel de cuenta de la cuenta. La salida se parece al siguiente ejemplo: ``` { "SuppressedDestinationSummaries": [ { "EmailAddress": "recipient2@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2020-04-10T21:03:05Z" }, { "EmailAddress": "recipient0@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2020-04-10T21:04:26Z" }, { "EmailAddress": "recipient1@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2020-04-10T22:07:59Z" } ] } ``` + **Nota**: Si tu resultado incluye un campo «NextToken» con un valor de cadena, esto indica que hay más direcciones de correo electrónico en la lista de supresión de tu cuenta. Para ver direcciones suprimidas adicionales, emita otra solicitud a`ListSuppressedDestinations` y pase el valor de cadena devuelto en el parámetro `--next-token` así: ``` aws sesv2 list-suppressed-destinations --next-token string ``` En el comando anterior, *string* sustitúyalo por el NextToken valor devuelto. Para obtener más información, consulte [Cómo mostrar más de 1000 direcciones de correo electrónico de la lista de supresión en el nivel de la cuenta](https://aws.amazon.com/blogs/messaging-and-targeting/how-to-list-over-1000-email-addresses-from-account-level-suppression-list/). Puede usar la opción `StartDate` para mostrar únicamente las direcciones de correo electrónico que se añadieron a la lista *después de* una fecha determinada. **Para ver una lista de las direcciones que se agregaron a la lista de supresión de nivel de cuenta después de una fecha específica** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 list-suppressed-destinations --start-date 1604394130 ``` En el comando anterior, *1604394130* sustitúyalo por la marca de tiempo de Unix de la fecha de inicio. También puede usar la opción `EndDate` para mostrar únicamente las direcciones de correo electrónico que se añadieron a la lista *antes de* una fecha determinada. **Para ver una lista de las direcciones que se agregaron a la lista de supresión de nivel de cuenta antes de una fecha específica** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 list-suppressed-destinations --end-date 1611126000 ``` En el comando anterior, sustitúyala por la marca *1611126000* de tiempo de Unix de la fecha de finalización. En la línea de comandos de Linux, macOS o Unix, también puede emplear la utilidad `grep` integrada para buscar direcciones o dominios específicos. **Para buscar una dirección específica en la lista de supresión de nivel de cuenta** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 list-suppressed-destinations | grep -A2 'example.com' ``` En el comando anterior, *example.com* sustituya por la cadena de texto (como la dirección o el dominio) que desee buscar. **Para ver una lista de todas las direcciones de correo electrónico que están en la lista de supresión de nivel de cuenta con la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En el panel **Supression list (Lista de supresión)**, se mostrarán todas las direcciones de correo electrónico en su lista de supresión de nivel de cuenta, junto con el motivo de supresión y la fecha; están disponibles las siguientes opciones: 1. Seleccione una dirección de correo electrónico o marque su casilla de verificación correspondiente y elija **View report (Ver informe)** para ver los detalles. (Si se trata de una dirección que se ha agregado en forma automática a su lista de supresión debido a un rebote o reclamo, se mostrará información sobre el evento de valoración que provocó que se agregue, incluidos detalles sobre el mensaje de correo electrónico que produjo el evento desencadenador). 1. Puede personalizar la tabla de la lista de supresión al seleccionar el icono de engranaje (se mostrará un modal en el que puede personalizar el tamaño de página, el ajuste de línea y las columnas que visualizará), después de realizar las selecciones, elija **Confirm (Confirmar)**. La tabla de la lista de supresión reflejará sus opciones de visualización. ## Eliminar de forma individual direcciones de correo electrónico de la lista de supresión de nivel de cuenta de Amazon SES Si una dirección está en la lista de direcciones suprimidas de su cuenta, pero sabe que no debería figurar en la lista, puede eliminarla mediante la [DeleteSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteSuppressedDestination.html)operación de la API de SES v2. **Para eliminar direcciones individuales de tu lista de direcciones suprimidas a nivel de cuenta mediante el AWS CLI** + En la línea de comandos, introduzca el comando siguiente: ------ #### [ Linux, macOS, or Unix ] ``` aws sesv2 delete-suppressed-destination \ --email-address recipient@example.com ``` ------ #### [ Windows ] ``` aws sesv2 delete-suppressed-destination ` --email-address recipient@example.com ``` ------ En el ejemplo anterior, *recipient@example.com* sustitúyala por la dirección de correo electrónico que deseas eliminar de la lista de direcciones suprimidas a nivel de cuenta. **Para eliminar direcciones individuales de la lista de supresión de nivel de cuenta con la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. Elimine las direcciones de correo electrónico individuales mediante *(a)* la selección de la tabla o *(b)* ingresar datos: 1. *Selección de la tabla*: en la tabla **Suppression list** (Lista de supresión), seleccione la casilla correspondiente de una o varias direcciones de correo electrónico y elija **Remove** (Eliminar). 1. *Ingresar datos*: 1. En la tabla **Suppression list** (Lista de supresión), elija **Remove email address** (Eliminar dirección de correo electrónico). 1. Escriba una dirección de correo electrónico en el campo **Email address** (Dirección de correo electrónico); si tiene que ingresar más direcciones, elija **Enter another address** (Ingresar otra dirección) y repita la acción para cada una de ellas. 1. Cuando termine de ingresar las direcciones, revise los datos para verificar que sean correctos. Si decide que alguna de las direcciones ingresadas no debería formar parte de este envío, elija el botón **Remove** (Eliminar). 1. Elija **Save changes** (Guardar cambios) para eliminar las direcciones de correo electrónico ingresadas de su lista de supresión de nivel de cuenta. ## Eliminar en bloque direcciones de correo electrónico de la lista de supresión de nivel de cuenta de Amazon SES Para eliminar direcciones de forma masiva, primero cargue su lista de contactos en un objeto de Amazon S3 y, a continuación, utilice la [CreateImportJob](#CIJ-remove-bulk-API)operación de la API de SES v2. **nota** No hay límite para el número de direcciones que puede eliminar de la lista de supresión de nivel de cuenta, pero hay un límite de eliminación en bloque de 10 000 direcciones en un objeto de Amazon S3 por llamada a la API. Si su origen de datos es un bucket de S3, debe existir en la misma región a la que se está importando. Para eliminar direcciones de correo electrónico en bloque de su lista de supresión de nivel de cuenta, realice los pasos siguientes. + Cargue su lista de direcciones en un objeto de Amazon S3 en formato CSV o JSON. Ejemplo de formato CSV para eliminar direcciones: `recipient3@example.com` Solo se admiten archivos JSON delimitados por saltos de línea. En este formato, cada línea es un objeto JSON completo que contiene una definición de dirección individual. Ejemplo de formato JSON para agregar direcciones: `{"emailAddress":"recipient3@example.com"}` En los ejemplos anteriores, *recipient3@example.com* sustitúyalas por las direcciones de correo electrónico que desees eliminar de tu lista de supresión a nivel de cuenta. + Conceda permiso a SES para leer el objeto de Amazon S3. Cuando se aplica a un bucket de Amazon S3, la siguiente política otorga permiso a SES para leer dicho bucket. Para obtener más información acerca de la asociación de políticas a buckets de Amazon S3, consulte [Uso de políticas de bucket y políticas de usuario](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) en la *Guía del usuario de Amazon Simple Storage Service*. + Conceda permiso a SES para usar su clave. AWS KMS Si el objeto de Amazon S3 está cifrado con una AWS KMS clave, debe dar permiso a Amazon SES para usar la AWS KMS clave. SES solo puede obtener el permiso de una clave administrada por el cliente, no de una clave de KMS predeterminada. Debe otorgar permiso a SES para utilizar la clave administrada por el cliente. Para ello, agregue una instrucción a la política de la clave. Pegue la siguiente instrucción de política en la política de claves para permitir que SES utilice su clave administrada por el cliente. ``` { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" } ``` + Utilice la [CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operación en la API v2 de SES. **nota** En el ejemplo siguiente se presupone que ya ha instalado 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/). En la línea de comandos, escriba el comando siguiente: *s3bucket*Sustitúyalo por el nombre del bucket de Amazon S3 y *s3object* por el nombre del objeto de Amazon S3. ``` aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=DELETE} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV ``` **Para eliminar direcciones en bloque de la lista de supresión de nivel de cuenta mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En la tabla **Suppression list (Lista de supresión)**, expanda el botón **Bulk actions (Acciones masivas)** y seleccione **Remove email addresses in bulk (Eliminar direcciones de correo electrónico de forma masiva)**. 1. En **Bulk action specifications** (Especificaciones de acción en bloque), seleccione entre: (a) **Choose file from S3 bucket** (Elegir un archivo del bucket de S3) o b) **Import from file** (Importar desde archivo); se establecen procedimientos para cada método de importación: 1. **Choose file from S3 bucket (Elegir un archivo del bucket de S3)**; *si el archivo de origen ya se ha almacenado en un bucket de Amazon S3*: 1. Si conoce el URI del bucket de Amazon S3 que desea utilizar, ingréselo en el campo **Amazon S3 URI (URI de Amazon S3)**; de lo contrario, elija **Browse S3 (Examinar S3)**: 1. En **Buckets (Buckets)**, elija el nombre del bucket de S3. 1. En **Objects (Objetos)**, seleccione el nombre del archivo y, a continuación, seleccione **Choose (Elegir)**, esto lo redirigirá a **Bulk action specifications (Especificaciones de acción masiva)**. 1. (Opcional) Si desea dirigirse a la consola de Amazon S3 para ver detalles sobre su objeto de S3, elija **View (Vista)**. 1. En **File format (Formato de archivo)**, seleccione el formato del archivo que ha elegido importar desde su bucket de Amazon S3. 1. Elija **Remove email addresses (Eliminar direcciones de correo electrónico)** para iniciar la importación de direcciones de su archivo; aparecerá una tabla debajo de la pestaña **Bulk actions (Acciones masivas)**. 1. **Import from file (Importar desde archivo)**, *si tiene un archivo de origen local para cargar en un bucket de Amazon S3 nuevo o existente*: 1. En **Import source file (Importar archivo de origen)**, seleccione **Choose file (Elegir archivo)**. 1. Seleccione el archivo JSON o CSV en el explorador de archivos y elija **Open (Abrir)**, verá el nombre, el tamaño y la fecha de su archivo debajo del botón **Choose file (Elegir archivo)**. 1. Expanda **Amazon S3 bucket (Bucket de Amazon S3)** y seleccione el bucket de S3. 1. Para cargar el archivo en un bucket nuevo, elija **Create S3 bucket (Crear bucket de S3)**, escriba un nombre en el campo **Bucket name (Nombre del bucket)** y elija **Create bucket (Crear bucket)**. 1. Elija **Remove email addresses (Eliminar direcciones de correo electrónico)** para iniciar la importación de direcciones de su archivo; aparecerá una tabla debajo de la pestaña **Bulk actions (Acciones masivas)**. 1. Independientemente del método de importación que haya utilizado, su ID de trabajo aparecerá en **Bucket name (Acciones masivas)**, junto con el tipo de importación, el estado y la fecha; para ver los detalles del trabajo, seleccione el ID del trabajo. 1. Seleccione la pestaña **Supression list (Lista de supresión)** y dejarán de mostrarse todas las direcciones de correo electrónico importadas correctamente que se han eliminado de la lista de supresión. ## Visualización de una lista de trabajos de importación de la cuenta Puede ver una lista de todas las direcciones de correo electrónico que figuran en la lista de supresión a nivel de cuenta de su cuenta mediante la [ListImportJobs](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListImportJobs.html)operación de la API de Amazon SES v2. **Para ver una lista de todos los trabajos de importación de la cuenta** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 list-import-jobs ``` El comando anterior devuelve todos los trabajos de importación de la cuenta. La salida se parece al siguiente ejemplo: ``` { "ImportJobs": [ { "CreatedTimestamp": 2020-07-31T06:06:55Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "755380d7-fbdb-4ed2-a9a3-06866220f5b5" }, { "CreatedTimestamp": "2020-07-30T18:45:32Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "DELETE" } }, "JobStatus": "COMPLETED", "JobId": "076683bd-a7ee-4a40-9754-4ad1161ba8b6" }, { "CreatedTimestamp": "2020-08-05T16:45:18Z", "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "6e261869-bd30-4b33-b1f2-9e035a83a395" } ] } ``` **Para ver una lista de todos los trabajos de importación de la cuenta mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En el panel **Supressión list (Lista de supresión)**, seleccione la pestaña **Bulk actions (Acciones masivas)**. 1. Todos los trabajos de importación aparecerán en la tabla **Bulk actions (Acciones masivas)** junto con el tipo, el estado y la fecha de importación. 1. Para ver los detalles del trabajo, seleccione el ID de trabajo y aparecerán los siguientes paneles: 1. **Bulk action status (Estado de acción masiva)**: muestra el estado general de los trabajos, la hora y la fecha en que se completaron, cuántos registros se importaron y el recuento de los registros que no se han podido importar correctamente. 1. **Bulk action details (Detalles de acción masiva)**: muestra el ID de trabajo, si se utilizó para agregar o eliminar direcciones, si el formato de archivo era JSON o CSV, el URI del bucket de Amazon S3 donde se almacenó el archivo masivo y la fecha y hora de creación de la acción masiva. ## Obtención de información acerca de un trabajo de importación de la cuenta Puede obtener información sobre un trabajo de importación para la cuenta mediante la [GetImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetImportJob.html)operación de la API v2 de Amazon SES. **Para obtener información acerca de un trabajo de importación de la cuenta** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 get-import-job --job-id JobId ``` El comando anterior devuelve información acerca de un trabajo de importación de la cuenta. La salida se parece al siguiente ejemplo: ``` { "ImportDataSource": { "S3Url": "s3://bucket/object", "DataFormat": "CSV" }, "ProcessedRecordsCount": 2, "FailureInfo": { "FailedRecordsS3Url": "s3presignedurl" }, "JobStatus": "COMPLETED", "JobId": "jobid", "CreatedTimestamp": "2020-08-12T17:05:15Z", "FailedRecordsCount": 1, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "CompletedTimestamp": "2020-08-12T17:06:42Z" } ``` **Para obtener información sobre un trabajo de importación de la cuenta mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En el panel **Supressión list (Lista de supresión)**, seleccione la pestaña **Bulk actions (Acciones masivas)**. 1. Todos los trabajos de importación aparecerán en la tabla **Bulk actions (Acciones masivas)** junto con el tipo, el estado y la fecha de importación. 1. Para ver los detalles del trabajo, seleccione el ID de trabajo y aparecerán los siguientes paneles: 1. **Bulk action status (Estado de acción masiva)**: muestra el estado general de los trabajos, la hora y la fecha en que se completaron, cuántos registros se importaron y el recuento de los registros que no se han podido importar correctamente. 1. **Bulk action details (Detalles de acción masiva)**: muestra el ID de trabajo, si se utilizó para agregar o eliminar direcciones, si el formato de archivo era JSON o CSV, el URI del bucket de Amazon S3 donde se almacenó el archivo masivo y la fecha y hora de creación de la acción masiva. ## Desactivar la lista de supresión de nivel de cuenta de Amazon SES Puede utilizar la [PutAccountSuppressionAttributes](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountSuppressionAttributes.html)operación de la API v2 de SES para deshabilitar de forma efectiva la lista de supresión a nivel de cuenta eliminando los valores del `suppressed-reasons` atributo. **Para inhabilitar la lista de supresión a nivel de cuenta, utilice la AWS CLI** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 put-account-suppression-attributes --suppressed-reasons ``` **Para desactivar la lista de supresión de nivel de cuenta mediante la consola de SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Suppression list (Lista de supresión)**. 1. En el panel **Account-level settings (Configuración de nivel de cuenta)**, seleccione **Edit (Editar)**. 1. En **Suppression list (Lista de supresión)**, desmarque la casilla **Enabled (Habilitado)**. 1. Seleccione **Save changes (Guardar cambios)**. # Uso de la supresión de nivel de conjunto de configuración para invalidar la lista de supresión de nivel de cuenta Aunque la lista de supresión de nivel de cuenta está configurada para toda la cuenta, puede personalizarla de forma individual para distintos conjuntos de configuración invalidándola con la supresión de nivel de conjunto de configuración. Este nivel más detallado le permite utilizar configuraciones de supresión personalizadas para diferentes grupos de envío de correo electrónico que ha asignado a sus propios conjuntos de configuración. Por ejemplo, supongamos que la lista de supresión de nivel de cuenta está configurada para agregar direcciones de rebote y reclamación, pero tiene un determinado grupo demográfico de correo electrónico definido en un conjunto de configuración para el que solo le interesa agregar direcciones de reclamaciones; lo lograría habilitando estas invalidaciones de supresión del conjunto de configuración para que las direcciones de correo electrónico se agreguen a la lista de supresión de nivel de cuenta solo para reclamaciones (no rebotes y reclamaciones como se establece en la lista de supresión de nivel de cuenta) desde el correo electrónico enviado con este conjunto de configuración. Con la supresión de nivel de conjunto de configuración, existen diferentes niveles de invalidación de la supresión de nivel de cuenta, incluso no utilizar ninguna supresión. Para ayudar a comprender estos distintos niveles de supresión que se pueden establecer en los siguientes procedimientos de la consola, el siguiente mapa de relaciones ilustra el conjunto de decisiones que puede tomar para habilitar o desactivar varios niveles de invalidaciones, que, según su combinación, se pueden utilizar para implementar tres niveles diferentes de supresión: + **Sin invalidaciones (predeterminado)**: el conjunto de configuración utiliza los ajustes de la lista de supresión de nivel de cuenta. + **Invalidar la configuración de nivel de cuenta**: esto anulará cualquier configuración de lista de supresión de nivel de cuenta; el correo electrónico enviado con este conjunto de configuración no utilizará ninguna configuración de supresión. + **Invalidar la configuración de nivel de cuenta con la supresión de nivel de conjunto de configuración habilitada**: el correo electrónico enviado con este conjunto de configuración solo utilizará las condiciones de supresión habilitadas para él (rebotes, reclamaciones o rebotes y reclamaciones). Independientemente de la configuración de la lista de supresión de nivel de cuenta, la invalidará. **nota** Para cualquier condición de supresión *no* especificada en el nivel del conjunto de configuraciones, el comportamiento de supresión recurrirá a la lista de supresión global, ya que se ha anulado la configuración en el nivel de cuenta. ![\[Flowchart showing configuration set-level suppression logic with override options.\]](http://docs.aws.amazon.com/es_es/ses/latest/dg/images/config_set_suppression_logic.png) Tenga en cuenta que la supresión de nivel de conjunto de configuración no es una *lista* de supresión real, ‎es su lugar, es simplemente un mecanismo para invalidar la lista de supresión de nivel de cuenta con configuraciones de supresión personalizadas definidas en un conjunto de configuración; esto significa que cualquier correo electrónico enviado con el conjunto de configuración solo utilizará su propia configuración de supresión e ignorará cualquier configuración de supresión de nivel de cuenta. En otras palabras, la supresión de nivel de conjunto de configuración interactúa con la lista de supresión a nivel de cuenta simplemente cambiando (invalidando) los motivos de supresión que determinan qué direcciones de correo electrónico se agregan a la lista de supresión de nivel de cuenta. ## Habilitar la supresión de nivel de conjunto de configuración **Para habilitar la supresión de nivel de conjunto de configuración mediante la nueva consola de Amazon SES:** 1. Inicie sesión en la consola Amazon SES Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. En el panel de navegación, en **Configuration (Configuración)**, elija **Configuration sets (Conjuntos de configuración)**. 1. En **Configuration sets (Conjuntos de configuración)**, elija el nombre del conjunto de configuración que desea configurar con supresión personalizada. 1. En el panel **Suppression list options (Opciones de lista de supresión)**, elija **Edit (Editar)**. 1. La sección **Suppression list options (Opciones de lista de supresión)** proporciona un conjunto de decisiones para definir la supresión personalizada, a partir de la opción de utilizar este conjunto de configuración para anular la supresión de nivel de cuenta. El [mapa lógico de supresión de nivel de conjunto de configuración](#sending-email-suppression-list-config-level) le ayudará a comprender los efectos de las combinaciones de anulación. Estas selecciones de anulaciones de varios niveles se pueden combinar para implementar tres niveles diferentes de supresión: 1. **Use account-level suppression (Utilizar supresión de nivel de cuenta):** no anular la supresión de nivel de cuenta y no implementar ninguna supresión de nivel de conjunto de configuración; básicamente, cualquier correo electrónico enviado con este conjunto de configuración solo utilizará la supresión de nivel de cuenta. Para ello: 1. En **Suppression list settings (Configuración de lista de supresión)**, desmarque la casilla **Override account level settings (Anular la configuración de nivel de cuenta)**. 1. **Do not use any suppression (No utilizar ninguna supresión):** anular la supresión de nivel de cuenta sin habilitar ninguna supresión de nivel de conjunto de configuración; esto significa que cualquier correo electrónico enviado con este conjunto de configuración no utilizará ninguna supresión de nivel de cuenta; en otras palabras, se cancelará toda supresión. Para ello: 1. En **Suppression list settings (Configuración de lista de supresión)**, marque la casilla **Override account level settings (Anular la configuración de nivel de cuenta)**. 1. En **Suppression list (Lista de supresión)**, desmarque la casilla **Enabled (Habilitado)**. 1. **Use configuration set-level suppression** (Utilizar supresión de nivel de conjunto de configuración): invalide la lista de supresión de nivel de cuenta con configuraciones de supresión personalizadas definidas en este conjunto de configuración; esto significa que cualquier correo electrónico enviado con este conjunto de configuración solo utilizará su propia configuración de supresión e ignorará cualquier configuración de supresión de nivel de cuenta. Para ello: 1. En **Suppression list settings (Configuración de lista de supresión)**, marque la casilla **Override account level settings (Anular la configuración de nivel de cuenta)**. 1. En **Suppression list (Lista de supresión)**, marque **Enabled (Habilitado)**. 1. En **Specify the reason(s)... [Especificar el motivo (s)...]**, seleccione uno de los motivos de supresión que utilizará este conjunto de configuración. 1. Seleccione **Save changes (Guardar cambios)**. # Uso de la administración de listas Amazon SES ofrece funciones de administración de listas, lo que significa que los clientes pueden administrar sus propias listas de correo, conocidas como listas de contactos. Una *lista de contactos* es una lista que le permite almacenar todos sus contactos que se han suscrito a uno o varios temas concretos. Un *contacto* es un usuario final que recibe sus mensajes de correo electrónico. Un *tema* es un grupo de interés, un tema o una etiqueta de una lista. Las listas pueden tener varios temas. Al usar la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html) de la API v2 de Amazon SES, puede recuperar una lista de todos los ‎contactos que se han suscrito a u‎n tema concreto, a los que puede enviar mensajes de correo electrónico mediante 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 obtener más información acerca de la administración de suscripciones, consulte [Uso de la administración de suscripciones](sending-email-subscription-management.md). ## Información general acerca de la administración de listas Debe tener en cuenta los siguientes factores cuando utilice la administración de listas: + Puede especificar temas de lista al crear la lista. + Solo se permite una lista de contactos por Cuenta de AWS. + Una lista puede tener un máximo de 20 temas. + Puede actualizar una lista de contactos existente, lo que incluye agregar nuevos temas a la lista, agregar o eliminar contactos de una lista y actualizar las preferencias de contacto de una lista o un tema. + Puede actualizar los metadatos del tema, como el nombre para mostrar o la descripción del tema. + Puede obtener una lista de contactos de una lista de contactos, contactos suscritos a un tema, contactos cuya suscripción a un tema se ha cancelado y contactos cuya suscripción a todos los temas de la lista se ha cancelado. + Puede importar las ‎listas de contactos existentes en SES mediante la API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html). + SES emitirá un evento de rebote si se envía un mensaje a un contacto de la lista de contactos cuya suscripción se haya cancelado. Para obtener más información, consulte [Uso de la administración de suscripciones](sending-email-subscription-management.md). + Cada contacto puede tener atributos asociados que puede utilizar para almacenar información acerca de ese contacto. ## Configuración de la administración de listas Puede utilizar las siguientes operaciones para configurar las capacidades de administración de listas. Para obtener la lista completa de la lista de contactos y las operaciones de contactos, consulte la [Referencia de la API v2 de Amazon SES](https://docs.aws.amazon.com/ses/latest/APIReference-V2/Welcome.html). ### Creación de una lista de contactos Puede utilizar la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html) en la API v2 de SES para crear una lista de contactos. Para establecer esta configuración de forma rápida y fácil, utilice 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/). **Para crear una lista de contactos mediante el AWS CLI** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 create-contact-list --cli-input-json file://CONTACT-LIST-JSON ``` En el comando anterior, *CONTACT-LIST-JSON* sustitúyalo por la ruta al archivo JSON de la [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContactList.html)solicitud. Un archivo JSON de entrada `CreateContactList` de ejemplo para la solicitud es como el siguiente: ``` { "ContactListName": "ExampleContactListName", "Description": "Creating a contact list example", "Topics": [ { "TopicName": "Sports", "DisplayName": "Sports Newsletter", "Description": "Sign up for our free newsletter to receive updates on all sports.", "DefaultSubscriptionStatus": "OPT_OUT" }, { "TopicName": "Cycling", "DisplayName": "Cycling newsletter", "Description": "Never miss a cycling update by subscribing to our newsletter.", "DefaultSubscriptionStatus": "OPT_IN" }, { "TopicName": "NewProducts", "DisplayName": "New products", "Description": "Hear about new products by subscribing to this mailing list.", "DefaultSubscriptionStatus": "OPT_IN" }, { "TopicName": "DailyUpdates", "DisplayName": "Daily updates", "Description": "Start your day with sport updates, Monday through Friday.", "DefaultSubscriptionStatus": "OPT_OUT" } ] } ``` ### Creación de un contacto Puede utilizar la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html) en la API v2 de SES para crear un contacto. Para establecer esta configuración de forma rápida y fácil, utilice 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 un contacto mediante el AWS CLI** + En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 create-contact --cli-input-json file://CONTACT-JSON ``` En el comando anterior, *CONTACT-JSON* sustitúyalo por la ruta al archivo JSON de la [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateContact.html)solicitud. Un archivo JSON de entrada `CreateContact` de ejemplo para la solicitud es como el siguiente: ``` { "ContactListName": "ExampleContactListName", "EmailAddress": "example@amazon.com", "UnsubscribeAll": false, "TopicPreferences": [ { "TopicName": "Sports", "SubscriptionStatus": "OPT_IN" } ], "AttributesData": "{\"Name\": \"John\", \"Location\": \"Seattle\"}" } ``` En el ejemplo anterior, un valor `UnsubscribeAll` de `false` muestra que el contacto no ha cancelado la suscripción de todos los temas, donde un valor de `true` significaría que se ha cancelado la suscripción del contacto de todos los temas. `TopicPreferences` incluye información acerca del estado de suscripción del contacto a los temas. En el ejemplo anterior, el contacto ha optado por el tema "*Sports*" (Deportes) y recibirá todos los mensajes de correo electrónico para el tema "*Sports*" (Deportes). `AttributesData` es un campo JSON donde puede poner los metadatos acerca de nuestro contacto. Debe ser un objeto JSON válido. ### Importación en bloque de contactos a su lista de contactos Puede agregar direcciones manualmente en bloque si carga primero los ‎contactos en un objeto de Amazon S3 seguido de la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) en la API v2 de SES o mediante la consola de SES. Para obtener más información, consulte [Agregar direcciones de correo electrónico en bloque a la lista de supresión de nivel de cuenta](sending-email-suppression-list.md#sending-email-suppression-list-manual-add-bulk). Debe crear una lista de contactos antes de importar los contactos. **nota** Puedes añadir hasta 1 millón de contactos a una lista de contactos cada uno ImportJob. Para agregar contactos en bloque a su lista de contactos, realice los pasos siguientes. + Cargue sus contactos en un objeto de Amazon S3 en formato CSV o JSON. **CSV format** (Formato CSV) La primera línea del archivo que se carga en Amazon S3 debe ser una línea de encabezado. El objeto `topicPreferences` se debe aplanar para el formato CSV. Cada tema en `topicPreferences` tendrá un campo de encabezado independiente. Ejemplo de formato CSV para agregar contactos en bloque a una lista de contactos: ``` emailAddress,unsubscribeAll,attributesData,topicPreferences.Sports,topicPreferences.Cycling example1@amazon.com,false,{"Name": "John"},OPT_IN,OPT_OUT example2@amazon.com,true,,OPT_OUT,OPT_OUT ``` **Formato JSON** Solo se admiten archivos JSON delimitados por saltos de línea. En este formato, cada línea es un objeto JSON completo que contiene la información de un contacto. Ejemplo de formato JSON para agregar contactos en bloque a una lista de contactos: ``` { "emailAddress": "example1@amazon.com", "unsubscribeAll": false, "attributesData": "{\"Name\":\"John\"}", "topicPreferences": [ { "topicName": "Sports", "subscriptionStatus": "OPT_IN" }, { "topicName": "Cycling", "subscriptionStatus": "OPT_OUT" } ] } { "emailAddress": "example2@amazon.com", "unsubscribeAll": true, "topicPreferences": [ { "topicName": "Sports", "subscriptionStatus": "OPT_OUT" }, { "topicName": "Cycling", "subscriptionStatus": "OPT_OUT" } ] } ``` En los ejemplos anteriores, sustituya *example1@amazon.com* y por *example2@amazon.com* las direcciones de correo electrónico que desee añadir a la lista de contactos. Reemplace los valores de `attributesData` por los valores específicos del contacto. Además, sustituya *Sports* y *Cycling* por la `topicName` que corresponda a su contacto. Los aceptables `topicPreferences` son *OPT\$1IN* y*OPT\$1OUT*. Los siguientes atributos se admiten al cargar sus contactos en un objeto de Amazon S3 en formato CSV o JSON: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/ses/latest/dg/sending-email-list-management.html) + Conceda permiso a SES para leer el objeto de Amazon S3. Cuando se aplica a un bucket de Amazon S3, la siguiente política otorga permiso a SES para leer dicho bucket. Para obtener más información acerca de la asociación de políticas a buckets de Amazon S3, consulte [Uso de políticas de bucket y políticas de usuario](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) en la *Guía del usuario de Amazon Simple Storage Service*. + Conceda permiso a SES para usar su AWS KMS clave. Si el objeto de Amazon S3 está cifrado con una AWS KMS clave, debe conceder permiso a Amazon SES para usar la clave de KMS. SES solo puede obtener el permiso de una clave administrada por el cliente, no de una clave de KMS predeterminada. Debe otorgar permiso a SES para utilizar la clave administrada por el cliente. Para ello, agregue una instrucción a la política de la clave. Pegue la siguiente instrucción de política en la política de claves para permitir que SES utilice su clave administrada por el cliente. ``` { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" } ``` + Utilice la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html) en la API v2 de SES. **nota** En el ejemplo siguiente se presupone que ya ha instalado 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/). En la línea de comandos, escriba el comando siguiente: *s3bucket*Sustitúyalo por el nombre del bucket de Amazon S3 y *s3object* por el nombre del objeto de Amazon S3. ``` aws sesv2 create-import-job --import-destination ContactListDestination={ContactListName=ExampleContactListName,ContactListImportAction=PUT} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV ``` ## Tutorial de administración de listas con ejemplos El siguiente tutorial proporciona ejemplos de cómo puede utilizar la administración de listas para mostrar los contactos, utilizar `ListManagementOptions` para especificar una lista de contactos y un nombre de tema en el correo electrónico y cómo insertar enlaces de cancelación de suscripción. 1. **Listar los contactos mediante la** operación AWS CLI: puede utilizar la [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)operación para recuperar una lista de todos sus contactos que se han suscrito a un tema en particular, junto con la [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)operación, que le permite enviarles correos electrónicos. En la línea de comandos, introduzca el comando siguiente: ``` aws sesv2 list-contacts --cli-input-json file://LIST-CONTACTS-JSON ``` En el comando anterior, *LIST-CONTACTS-JSON* sustitúyalo por la ruta al archivo JSON de la [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html)solicitud. Un archivo JSON de entrada `ListContacts` de ejemplo para la solicitud es como el siguiente: ``` { "ContactListName": "ExampleContactListName", "Filter": { "FilteredStatus": "OPT_IN", "TopicFilter": { "TopicName": "Cycling", "UseDefaultIfPreferenceUnavailable": true } }, "PageSize": 50 } ``` `FilteredStatus` muestra el estado de suscripción por el que desea filtrar, que es `OPT_IN` o `OPT_OUT`. `TopicFilter` es un filtro opcional que especifica el tema del que desea obtener resultados, que en el ejemplo anterior es "*Cycling*" (Ciclismo). `UseDefaultIfPreferenceUnavailable` puede tener un valor de `true` o `false`. Si es `true`, se usará la preferencia de tema predeterminada si el contacto no tiene ninguna preferencia explícita para un tema. Si es `false`, solo se tienen en cuenta los contactos con una preferencia establecida explícita para el filtrado. 1. **Enviar correo con `ListManagementOptions` habilitado**: después de mostrar los contactos en la lista utilizando la operación [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListContacts.html) anterior, 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 correos electrónicos a cada uno de los contactos mediante el encabezado [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) para especificar la lista de contactos y el nombre del tema. Para utilizar `ListManagementOptions` con la operación `SendEmail`, incluya [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) y [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) al que pertenece el correo electrónico (`topicName` es opcional): ``` ListManagementOptions: String contactListName String topicName ``` Si incluye `ListManagementOptions` en la solicitud `SendEmail` a una dirección de correo electrónico de destinatario que no está en la lista de contactos, se creará un contacto en la lista automáticamente. SES emitirá un evento de rebote para un mensaje que se envía a un contacto cuya suscripción se ha cancelado en la lista de contactos, lo que significa que no tendrá que actualizar las solicitudes `SendEmail` para evitar el envío a contactos cuya suscripción se ha cancelado. 1. **Indicar la ubicación de los enlaces de cancelación de suscripción**: al utilizar [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) tiene la opción de permitir que SES agregue enlaces de pie de página de cancelación de suscripción en el correo electrónico mediante el marcador de posición `{{amazonSESUnsubscribeUrl}}` para especificar dónde debe insertar SES la URL de cancelación de suscripción. Solo se admite el reemplazo de marcadores de posición para los tipos de contenido HTML y TEXT. Puede incluir el marcador de posición dos veces como máximo. Si se utiliza más de dos veces, solo se reemplazan las dos primeras coincidencias. Para obtener más información, consulte [Uso de la administración de suscripciones](sending-email-subscription-management.md). Otra opción, si utiliza la interfaz de SMTP para enviar un correo electrónico, puede usar el encabezado `X-SES-LIST-MANAGEMENT-OPTIONS` para especificar una lista y un nombre de tema. Para especificar una lista y un nombre de tema durante el envío de correo electrónico mediante la interfaz SMTP, agregue el siguiente encabezado de correo electrónico al mensaje: `X-SES-LIST-MANAGEMENT-OPTIONS: {contactListName}; topic={topicName}` # Uso de la administración de suscripciones Amazon SES proporciona una capacidad de administración de suscripciones, en la que Amazon SES habilita automáticamente los enlaces de cancelación de suscripción en cada correo electrónico saliente cuando especifica `contactListName` y `topicName` dentro de [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) en la solicitud de 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). Si un contacto cancela la suscripción a un tema o una lista en particular, Amazon SES no permite el envío de correo electrónico al contacto para ese tema o esa lista en el futuro. **nota** La administración de suscripciones de Amazon SES cumple con los *requisitos para remitentes que envíen correo masivo* exigidos por muchos proveedores de servicios de correo electrónico; consulte la *sección 2* de [An Overview of Bulk Sender Changes](https://aws.amazon.com//blogs/messaging-and-targeting/an-overview-of-bulk-sender-changes-at-yahoo-gmail/) para obtener más información. La administración de suscripciones está disponible para aquellos que utilizan [Easy DKIM en Amazon SES](send-email-authentication-dkim-easy.md), pero Amazon SES no puede agregar los vínculos de cancelación de suscripción a su correo electrónico para los remitentes que firman los mensajes de correo electrónico antes de llamar a Amazon SES. Para obtener información sobre la administración de listas y sobre cómo utilizarla, incluida la recuperación de una lista de todos los contactos que se han suscrito a un tema concreto, consulte [Uso de la administración de listas](sending-email-list-management.md). ## Información general acerca de la administración de suscripciones Debe tener en cuenta los siguientes factores cuando utilice la administración de suscripciones: + Amazon SES administrará por completo las suscripciones. Esto significa que Amazon SES recibe correos electrónicos y solicitudes de cancelación de suscripción de la página web de cancelación de suscripción y, a continuación, actualiza las preferencias del contacto en su lista. Puede recibir notificaciones de cancelación de suscripción mediante notificaciones de conjunto de configuración. Para obtener más información acerca de los conjuntos de configuración, consulte [Uso de conjuntos de configuración en Amazon SES](using-configuration-sets.md). + Debe especificar la lista de contactos mientras envía el correo electrónico. La administración de suscripciones a través de los enlaces del encabezado `List-Unsubscribe` y el pie de página `ListManagementOptions` se gestionarán en consecuencia. + Amazon SES agrega compatibilidad con los estándares de encabezado `List-Unsubscribe`, que permitirán a los clientes de correo electrónico y a los proveedores de la bandeja de entrada mostrar un enlace de cancelación de suscripción en la parte superior del correo electrónico *si lo admiten*, no todos los proveedores de servicio de correo electrónico admiten estos encabezados. + Los encabezados `List-Unsubscribe` siguen el comportamiento que se muestra a continuación: + Si un contacto hace clic en el enlace de cancelar suscripción en un correo electrónico que tiene la lista de contactos y el tema especificados, solo se cancelará la suscripción del contacto de ese tema específico. + Si no se especifica el tema, se cancelará la suscripción del contacto de todos los temas de la lista. + Los contactos se llevarán a una página de destino para cancelar la suscripción cuando hagan clic en el enlace correspondiente en el pie de página del correo electrónico. + La página de destino para cancelar la suscripción proporcionará a los contactos una opción para actualizar sus preferencias, lo que significa `OPT_IN` o `OPT_OUT`, para todos los temas de una lista en particular. La página de destino también ofrece la opción de cancelar la suscripción de todos los temas de la lista. + Si utiliza [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html), debe incluir un marcador de posición `{{amazonSESUnsubscribeUrl}}` en los correos electrónicos para indicar dónde debe insertar Amazon SES la URL de cancelación de suscripción. Puede incluir el marcador de posición dos veces como máximo. Si se utiliza más de dos veces, solo se reemplazan las dos primeras coincidencias. + Los enlaces del encabezado `List-Unsubscribe` y el pie de página `ListManagementOptions` se agregan solo si el correo electrónico se envía a un único destinatario. + Para los correos electrónicos de transacciones en los que no desea que los contactos puedan cancelar la suscripción, puede omitir el campo [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html) con la solicitud de [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html). ## Consideraciones sobre el encabezado de cancelación de suscripción La administración de suscripciones mediante un enlace de cancelación de suscripción está habilitada cuando el correo electrónico contiene los siguientes encabezados: `List-Unsubscribe` `List-Unsubscribe-Post` Cuando utiliza la administración de suscripciones de Amazon SES, [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html), Amazon SES invalidará estos encabezados si están presentes en el correo electrónico. Los destinatarios que cancelen la suscripción haciendo clic en el enlace producido por estos encabezados tendrán una experiencia diferente según el cliente de correo electrónico o el proveedor de la bandeja de entrada porque algunos proveedores no reconocen los encabezados `List-Unsubscribe` y `List-Unsubscribe-Post`; el correo electrónico enviado a los destinatarios utilizando dichos proveedores no verá el enlace Cancelar suscripción. Los destinatarios cuyo cliente de correo electrónico reconozca estos encabezados verán el enlace Cancelar suscripción y podrán cancelar la suscripción a través del enlace pero no tendrán la opción de elegir los temas de los que quieren cancelar la suscripción. Simplemente se cancelará la del tema para el que se envió el correo electrónico. Para obtener más información sobre el encabezado `List-Unsubscribe`, consulte [RFC 2369](https://tools.ietf.org/html/rfc2369) y para el encabezado `List-Unsubscribe-Post`, consulte [RFC 8058](https://tools.ietf.org/html/rfc8058). **nota** Amazon SES admite la *cancelación de suscripciones con un clic* de conformidad con los *requisitos para remitentes que envían correo masivo* exigidos por muchos proveedores de servicios de correo electrónico. Para obtener más información, consulte [Using one-click unsubscribe with Amazon SES](https://aws.amazon.com//blogs/messaging-and-targeting/using-one-click-unsubscribe-with-amazon-ses/). ## Adición de un enlace de cancelación de suscripción en el pie de página Tendrá que utilizar el marcador de posición `{{amazonSESUnsubscribeUrl}}` en correos electrónicos con plantilla y sin plantilla para especificar dónde debe insertar Amazon SES la URL de cancelación de suscripción. Solo se admite el reemplazo de marcadores de posición para los tipos de contenido HTML y TEXT. Puede incluir el marcador de posición dos veces como máximo. Si se utiliza más de dos veces, solo se reemplazan las dos primeras coincidencias. **nota** El `{{amazonSESUnsubscribeUrl}}` marcador de posición solo se puede usar si [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListManagementOptions.html)se especifica como encabezado mientras se usa la [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)operación o si se especifica X-SES-LIST-MANAGEMENT -OPTIONS como encabezado mientras se usa la interfaz SMTP. (No se debe confundir con los encabezados `List-Unsubscribe` o `List-Unsubscribe-Post` que no dependen de `ListManagementOptions` y se pueden utilizar por sí mismos.)