Como usar a lista de supressão do Amazon SES por conta - Amazon Simple Email Service

Como usar a lista de supressão do Amazon SES por conta

A lista de supressão no nível da conta do Amazon SES foi introduzida para que os clientes possam criar e controlar suas próprias listas de supressão e reputação, portanto, a lista de supressão no nível da conta se aplica somente à sua conta. A interface da lista de supressão por conta no console do SES fornece uma maneira fácil de gerenciar endereços em sua lista de supressão por conta, incluindo ações em massa para adicionar ou remover endereços. Se um endereço estiver na lista de supressão global, mas não estiver na lista de supressão no nível da conta (o que significa que você deseja enviar para o respectivo endereço), e você fizer um envio para esse endereço, o SES ainda tentará fazer a entrega. Porém, se ele for devolvido, a devolução afetará sua própria reputação, mas ninguém mais receberá devoluções porque eles não podem enviar para esse endereço de e-mail se não estiverem usando a própria lista de supressão por conta; portanto, a lista de supressão no nível da substituir a lista de supressão global exclusivamente para sua conta.

A lista de supressão no nível da conta do SES é aplicada à sua Conta da AWS na Região da AWS atual. Você pode adicionar ou remover, individualmente ou em massa, endereços da lista de supressão no nível da conta usando o console ou a API v2 do SES.

nota

Para adicionar ou remover endereços em massa, você deve ter acesso de produção. Para saber mais sobre a sandbox, consulte Saída da sandbox do Amazon SES.

Considerações sobre a lista de supressão do Amazon SES por conta

Você deve considerar os seguintes fatores ao usar a lista de supressão no nível da conta:

  • Se você começou a usar o Amazon SES após 25 de novembro de 2019, sua conta usa a lista de supressão no nível da conta por padrão tanto para devoluções como para reclamações. Se tiver começado a usar o SES antes dessa data, é necessário habilitar esse recurso usando a operação PutAccountSuppressionAttributes na API do SES.

  • Se tentar enviar uma mensagem para um endereço que está na lista de supressão no nível da conta, o SES aceitará a mensagem, mas ela não será enviada.

  • O SES não contabiliza as mensagens enviadas para endereços na lista de supressão no nível da conta nas taxas de devolução ou de reclamação da sua conta.

  • O SES contabiliza nas taxas de devolução ou de reclamação da sua conta as mensagens enviadas para endereços que não estão sua na lista de supressão no nível da conta, mas que estão na lista de supressão global.

  • O SES contabiliza as mensagens enviadas para endereços na lista de supressão no nível da conta na sua cota de envio diário.

  • Os endereços de e-mail na lista de supressão no nível da conta são mantidos ali até que você os remova.

  • Se a capacidade de envio de e-mails da sua conta for pausada, o SES excluirá automaticamente os endereços na lista de supressão no nível da conta após 90 dias. Se a capacidade da conta de enviar e-mails for restaurada antes do término desse período de 90 dias, os endereços da lista não serão excluídos.

  • O Gmail não fornece dados de reclamação para o SES. Se um destinatário usar o botão Spam no cliente Web do Gmail para denunciar uma mensagem recebida de você como spam, ele não será adicionado à lista de supressão no nível da conta.

  • Você poderá habilitar a lista de supressão no nível da conta se a sua conta estiver no sandbox do SES. No entanto, não é possível usar a operação da API PutSuppressedDestination ou CreateImportJob até que a conta seja removida da sandbox. Para saber mais sobre a sandbox, consulte Saída da sandbox do Amazon SES.

  • Quando você usa a lista de supressão no nível da conta, o SES adiciona endereços que também resultam em devoluções definitivas ou reclamações à lista de supressão global.

Como habilitar a lista de supressão do Amazon SES por conta

É possível usar a operação PutAccountSuppressionAttributes na API v2 do Amazon SES para habilitar e configurar a lista de supressão por conta. É possível definir essa configuração de forma rápida e fácil usando a AWS CLI. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Como configurar a lista de supressão no nível da conta usando a AWS CLI

  • Na linha de comando, insira o seguinte comando:

    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 a lista de supressão no nível da conta, é necessário especificar pelo menos um motivo para o parâmetro suppressed-reasons. É possível especificar BOUNCE ou COMPLAINT ou ambos, conforme mostrado no exemplo anterior.

Como configurar a lista de supressão no nível da conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. No painel Account-level settings (Configurações no nível da conta), escolha Edit (Editar).

  4. Em Suppression list, desmarque a caixa Enabled.

  5. Em Suppression reasons (Motivos da supressão), selecione um dos motivos pelos quais os endereços de e-mail do destinatário devem ser adicionados automaticamente à sua lista de supressão no nível da conta.

  6. Selecione Save changes.

Como habilitar a lista de supressão do Amazon SES por conta para um conjunto de configurações

Também é possível configurar a supressão por conta do Amazon SES para que ela seja aplicável exclusivamente a conjuntos de configuração específicos. Quando fizer isso, os endereços serão adicionados à lista de supressão somente se você tiver especificado o conjunto de configurações quando enviar o e-mail que gerou a devolução ou a reclamação.

nota

O procedimento a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Definir a lista de supressão no nível da conta para uma configuração definida usando a AWS CLI

  • Na linha de comando, insira o seguinte comando:

    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

    No exemplo anterior, substitua configSet pelo nome do conjunto de configurações que deve usar a lista de supressão no nível da conta.

Para configurar a lista de supressão no nível da conta para um conjunto de configurações usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Configuration sets (Conjuntos de configurações).

  3. Em Configuration sets (Conjuntos de configurações), escolha o nome do conjunto de configurações que deseja configurar com supressão personalizada.

  4. No painel Supression list options (Opções de lista de supressão), escolha Edit (Editar).

  5. A seção Supression list options (Opções de lista de supressão) fornece um conjunto de decisões para definir a supressão personalizada, começando com a opção de usar esse conjunto de configurações para substituir a supressão no nível da conta. O configuration set-level suppression logic map (mapa lógico de supressão no nível do conjunto de configurações) ajudará você a entender os efeitos das combinações de substituição. Essas seleções em várias camadas de substituições podem ser combinadas para implementar três níveis diferentes de supressão:

    1. Use account-level supression (Usar supressão no nível da conta): Não substituir a supressão no nível da conta e não implementar nenhuma supressão no nível do conjunto de configurações - basicamente, qualquer e-mail enviado usando esse conjunto de configurações usará apenas a supressão no nível da conta. Para fazer isso:

      1. Em Suppression list settings (Configurações da lista de supressão), desmarque a caixa Override account level settings (Substituir configurações no nível de conta).

    2. Do not use any suppression (Não usar nenhuma supressão): Substituir sua supressão no nível da conta sem habilitar nenhuma supressão no nível do conjunto de configurações - isso significa que qualquer e-mail enviado usando este conjunto de configurações não usará nenhuma supressão no nível da conta; em outras palavras, toda a supressão é cancelada. Para fazer isso:

      1. Em Suppression list settings (Configurações da lista de supressão), marque a caixa Override account level settings (Substituir configurações no nível de conta).

      2. Em Suppression list (Lista de supressão), desmarque a caixa Enabled (Habilitada).

    3. Use configuration set-level suppression (Usar a supressão no nível do conjunto de configurações): Substitui a supressão no nível da conta por configurações de lista de supressão personalizadas definidas neste conjunto de configurações - isso significa que qualquer e-mail enviado usando esse conjunto de configurações usará apenas suas próprias configurações de supressão e ignorará qualquer configuração de supressão no nível da conta. Para fazer isso:

      1. Em Suppression list settings (Configurações da lista de supressão), marque a caixa Override account level settings (Substituir configurações no nível de conta).

      2. Em Suppression list (Lista de supressão), marque Enabled (Habilitada).

      3. Em Specify the reason(s)… (Especificar o(s) motivo(s)..., selecione um dos motivos de supressão para esse conjunto de configurações usar.

  6. Selecione Save changes.

Como adicionar endereços de e-mail individuais à lista de supressão do Amazon SES por conta

É possível adicionar endereços individuais à lista de supressão no nível da conta do Amazon SES usando a operação PutSuppressedDestination na API v2 do SES. Não há limite para o número de endereços que você pode adicionar à lista de supressão no nível da conta.

nota

O procedimento a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Como adicionar endereços individuais à lista de supressão no nível da conta usando a AWS CLI

  • Na linha de comando, insira o seguinte comando:

    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

    No exemplo anterior, substitua destinatário@exemplo.com pelo endereço de e-mail que você deseja adicionar à lista de supressão no nível da conta e substitua BOUNCE pelo motivo pelo qual o endereço está sendo adicionado à lista de supressão (os valores aceitáveis são BOUNCE e COMPLAINT).

Como adicionar endereços individuais à lista de supressão no nível da conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. No painel Suppression list (Lista de supressão), escolha Add email address (Adicionar endereço de e-mail).

  4. Digite um endereço de e-mail no campo Email address (Endereço de e-mail) seguido da seleção de um motivo em Suppresion reason (Motivo da supressão). Se precisar inserir mais endereços, escolha Enter another address (Inserir outro endereço) e repita a operação para cada endereço adicional.

  5. Quando terminar de inserir endereços, revise a precisão de suas entradas. Se decidir que alguma de suas entradas não deve integrar esse envio, escolha o botão Remove (Remover).

  6. Escolha Save changes (Salvar as alterações) para adicionar os endereços de e-mail inseridos à sua lista de supressão por conta.

Adicionar endereços de e-mail em massa à lista de supressão no nível da conta do Amazon SES

Você pode adicionar endereços em massa primeiramente carregando sua lista de contatos para um objeto do Amazon S3 e depois usando a operação CreateImportJob na API v2 do Amazon SES.

nota

Não há limite para o número de endereços que você pode adicionar à lista de supressão no nível da conta, mas há um limite de adição em lote de 100.000 de endereços em um objeto do Amazon S3 por chamada de API.

Para adicionar endereços de e-mail em lote à lista de supressão no nível da conta, conclua as etapas a seguir.

  • Carregue a lista de endereços em um objeto do Amazon S3 no formato CSV ou JSON.

    Exemplo de formato CSV para adicionar endereços:

    recipient1@example.com,BOUNCE

    recipient2@example.com,COMPLAINT

    Somente arquivos JSON delimitados por nova linha são suportados. Nesse formato, cada linha é um objeto JSON completo que contém uma definição de endereço individual.

    Exemplo de formato JSON para adicionar endereços:

    {"emailAddress":"recipient1@example.com","reason":"BOUNCE"}

    {"emailAddress":"recipient2@example.com","reason":"COMPLAINT"}

    No exemplo anterior, substitua destinatário1@exemplo.com e destinatário2@exemplo.com pelos endereços de e-mail que você deseja adicionar à lista de supressão no nível da conta. Os motivos aceitáveis pelos quais você está adicionando os endereços à lista de supressão são BOUNCE e COMPLAINT.

  • Conceda permissão ao SES para ler o objeto do Amazon S3.

    Quando aplicada a um bucket do Amazon S3, a seguinte política concede ao SES permissão de leitura desse bucket. Para obter mais informações sobre como anexar políticas aos buckets do Amazon S3, consulte Uso de políticas de bucket e políticas de usuário no Guia do usuário do Amazon Simple Storage Service.

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • Conceda permissão ao SES para usar sua chave do AWS KMS.

    Se o objeto do Amazon S3 for criptografado com uma chave do AWS KMS, você precisa conceder ao Amazon SES permissão para usar a chave do AWS KMS. O SES só pode obter permissão de uma chave gerenciada pelo cliente, não de uma chave padrão do KMS. Você precisa conceder permissão ao SES para usar a chave gerenciada pelo cliente, adicionando uma instrução à política da chave.

    Cole a seguinte instrução de política na política de chave para permitir que o SES use sua chave gerenciada pelo cliente.

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • Use a operação CreateImportJob na API v2 do SES.

nota

O exemplo a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Na linha de comando, insira o seguinte comando: Substitua s3Bucket pelo nome do bucket do Amazon S3 e s3object pelo nome do objeto do Amazon S3.

aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=PUT} --import-data-source S3Url=s3://s3bucket/s3object,DataFormat=CSV

Para adicionar endereços de e-mail em massa à sua lista de supressão por conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. Na tabela Suppression list (Lista de supressão), expanda o botão Bulk actions (Ações em massa) e selecione Add email addresses in bulk (Adicionar endereços de e-mail em massa).

  4. Em Bulk action specifications (Especificações da ação em massa), selecione (a) Choose file from S3 bucket (Escolher arquivo do bucket do S3) ou (b) Import from file (Importar do arquivo). Os procedimentos são indicados para cada método de importação:

    1. Choose file from S3 bucket (Escolher arquivo do bucket do S3) - Se seu arquivo de origem já estiver armazenado em um bucket do Amazon S3:

      1. Se você sabe o URI do bucket do Amazon S3 que deseja usar, insira-o no campo Amazon S3 URI (URI do Amazon S3); caso contrário, escolha Browse S3 (Procurar no S3):

        1. Em Buckets, selecione o nome do bucket do S3.

        2. Em Objects (Objetos), selecione o nome do arquivo e selecione Choose (Escolher). Você será direcionado de volta para Bulk action specifications (Especificações da ação em massa).

        3. (Opcional) Se você quiser ser levado ao console do Amazon S3 para exibir detalhes sobre o seu objeto do S3, escolha View (Exibir).

      2. Em File format (Formato do arquivo), selecione o formato do arquivo que você escolheu para importar do bucket do Amazon S3.

      3. Escolha Add e-mail addresses (Adicionar endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.

    2. Import from file (Importar do arquivo) - se você tiver um arquivo de origem local para carregar em um bucket do Amazon S3 novo ou existente:

      1. Em Import source file (Importar arquivo de origem), selecione Choose file (Escolher arquivo).

      2. Selecione o arquivo JSON ou CSV no navegador de arquivos e escolha Open (Abrir). Você verá o nome, o tamanho e a data do seu arquivo exibidos sob o botão Choose file (Escolher arquivo).

      3. Expanda Amazon S3 bucket (Bucket do Amazon S3) e selecione o bucket do S3.

        1. Para carregar seu arquivo em um novo bucket, escolha Create S3 bucket (Criar bucket do S3), insira um nome no campo Bucket name (Nome do bucket) e escolha Create bucket (Criar bucket).

      4. Escolha Add e-mail addresses (Adicionar endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.

  5. Independentemente do método de importação que você usou, seu ID de trabalho será listado em Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data. Para exibir os detalhes do trabalho, selecione o ID do trabalho.

  6. Selecione a guia Suppression list (Lista de supressão) e todos os endereços de e-mail importados com êxito serão exibidos com o motivo da supressão e a data de adição. As seguintes opções estão disponíveis:

    1. Selecione um endereço de e-mail ou marque a caixa de seleção correspondente e escolha View report (Exibir relatório) para exibir seus detalhes. (Se for um endereço que foi adicionado automaticamente à sua lista de supressão devido a uma devolução ou reclamação, serão exibidas informações sobre o evento de feedback que fez com que ele fosse adicionado, incluindo detalhes sobre a mensagem de e-mail que produziu o evento de acionamento.)

    2. Marque a caixa de seleção correspondente de um ou mais endereços de e-mail que você deseja remover da sua lista de supressão da conta e escolha Remove (Remover).

Visualizar uma lista dos endereços que estão na lista de supressão no nível da conta do Amazon SES

Você pode visualizar uma lista de todos os endereços de e-mail que estão na lista de supressão no nível da conta da sua conta usando a operação ListSuppressedDestinations na API v2 do SES.

nota

O procedimento a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Como visualizar uma lista de todos os endereços de e-mail que estão na lista de supressão no nível da conta

  • Na linha de comando, insira o seguinte comando:

    aws sesv2 list-suppressed-destinations

O comando anterior retorna todos os endereços de e-mail que estão na lista de supressão no nível da conta da sua conta. A saída será semelhante ao seguinte exemplo:

{ "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" } ] }
  • Observação: se sua saída incluir um campo “NextToken” com um valor de string, isso indica que há endereços de e-mail adicionais na lista de supressão para sua conta. Para exibir endereços suprimidos adicionais, emita outra solicitação para ListSuppressedDestinations e passe o valor da string retornado no parâmetro da --next-token da seguinte forma:

    aws sesv2 list-suppressed-destinations --next-token string

    No comando anterior, substitua string pelo valor retornado do NextToken.

Você pode usar a opção StartDate para mostrar apenas os endereços de e-mail que foram adicionados à lista após uma determinada data.

Como visualizar uma lista dos endereços que foram adicionados à lista de supressão no nível da conta após uma data específica

  • Na linha de comando, insira o seguinte comando:

    aws sesv2 list-suppressed-destinations --start-date 1604394130

    No comando anterior, substitua 1604394130 pelo timestamp Unix da data de início.

Você também pode usar a opção EndDate para mostrar apenas os endereços de e-mail que foram adicionados à lista antes de uma determinada data.

Como visualizar uma lista dos endereços que foram adicionados à lista de supressão no nível da conta antes de uma data específica

  • Na linha de comando, insira o seguinte comando:

    aws sesv2 list-suppressed-destinations --end-date 1611126000

    No comando anterior, substitua 1611126000 pelo timestamp Unix da data final.

Na linha de comando do Linux, macOS ou Unix, você também pode usar o utilitário interno grep para procurar endereços ou domínios específicos.

Como pesquisar um endereço específico na lista de supressão no nível da conta

  • Na linha de comando, insira o seguinte comando:

    aws sesv2 list-suppressed-destinations | grep -A2 'example.com'

    No comando anterior, substitua example.com pela string de texto (como o endereço ou o domínio) que você deseja pesquisar.

Como visualizar uma lista de todos os endereços de e-mail que estão na lista de supressão no nível da conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. Selecione a guia Suppression list e todos os endereços de e-mail importados com êxito serão exibidos com o motivo da supressão e a data de adição. As seguintes opções estão disponíveis:

    1. Selecione um endereço de e-mail ou marque a caixa de seleção correspondente e escolha View report (Exibir relatório) para exibir seus detalhes. (Se for um endereço que foi adicionado automaticamente à sua lista de supressão devido a uma devolução ou reclamação, serão exibidas informações sobre o evento de feedback que fez com que ele fosse adicionado, incluindo detalhes sobre a mensagem de e-mail que produziu o evento de acionamento.)

    2. Você pode personalizar a tabela da lista de supressão escolhendo o ícone de engrenagem - um modal será apresentado, onde você pode personalizar o tamanho da página, a quebra de linha e as colunas a visualizar - depois de fazer suas seleções, escolha Confirm (Confirmar). A tabela da lista de supressão refletirá suas opções de exibição.

Remover endereços de e-mail individuais da lista de supressão do Amazon SES no nível da conta

Se um endereço estiver na lista de supressão para a sua conta, mas você souber que ele não deveria estar na lista, é possível removê-lo usando a operação DeleteSuppressedDestination na API v2 do SES.

nota

O procedimento a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Como remover endereços individuais da lista de supressão no nível da conta usando a AWS CLI

  • Na linha de comando, insira o seguinte comando:

    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

    No exemplo anterior, substitua destinatário@exemplo.com pelo endereço de e-mail que você deseja adicionar à lista de supressão no nível da conta.

Como remover endereços individuais da lista de supressão no nível da conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. Remova endereços de e-mail individuais mediante (a) seleção de tabela ou (b) entrada digitada:

    1. Seleção na tabela: na tabela Suppression list (Lista de supressão), marque a caixa de seleção correspondente a um ou mais endereços de e-mail e escolha Remove (Remover).

    2. Digitação no campo:

      1. Na tabela Suppression list (Lista de supressão), escolha Remove email address (Remover endereço de e-mail).

      2. Digite um endereço de e-mail no campo Email address (Endereço de e-mail). Se precisar inserir mais endereços, escolha Enter another address (Inserir outro endereço) e repita a operação para cada endereço adicional.

      3. Quando terminar de inserir endereços, revise a precisão de suas entradas. Se decidir que alguma de suas entradas não deve integrar esse envio, escolha o botão Remove (Remover).

      4. Escolha Save changes (Salvar as alterações) para remover os endereços de e-mail inseridos da sua lista de supressão por conta.

Remover endereços de e-mail em massa da lista de supressão do Amazon SES no nível da conta

Você pode remover endereços em massa primeiramente carregando sua lista de contatos para um objeto do Amazon S3 e depois usando a operação CreateImportJob na API v2 do SES.

nota

Não há limite para o número de endereços que você pode remover da lista de supressão no nível de conta, mas há um limite de exclusão em massa de 10.000 de endereços em um objeto do Amazon S3 por chamada de API.

Para remover endereços de e-mail em massa da lista de supressão no nível da conta, conclua as etapas a seguir.

  • Carregue sua lista de endereços em um objeto do Amazon S3 no formato CSV ou JSON.

    Exemplo de formato CSV para remoção de endereços:

    recipient3@example.com

    Somente arquivos JSON delimitados por nova linha são suportados. Nesse formato, cada linha é um objeto JSON completo que contém uma definição de endereço individual.

    Exemplo de formato JSON para adicionar endereços:

    {"emailAddress":"recipient3@example.com"}

    Nos exemplos anteriores, substitua destinatário3@exemplo.com pelos endereços de e-mail que você deseja remover da lista de supressão no nível da conta.

  • Conceda permissão ao SES para ler o objeto do Amazon S3.

    Quando aplicada a um bucket do Amazon S3, a seguinte política concede ao SES permissão de leitura desse bucket. Para obter mais informações sobre como anexar políticas aos buckets do Amazon S3, consulte Uso de políticas de bucket e políticas de usuário no Guia do usuário do Amazon Simple Storage Service.

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • Conceda permissão ao SES para usar sua chave do AWS KMS.

    Se o objeto do Amazon S3 for criptografado com uma chave do AWS KMS, você precisa conceder ao Amazon SES permissão para usar a chave do AWS KMS. O SES só pode obter permissão de uma chave gerenciada pelo cliente, não de uma chave padrão do KMS. Você precisa conceder permissão ao SES para usar a chave gerenciada pelo cliente, adicionando uma instrução à política da chave.

    Cole a seguinte instrução de política na política de chave para permitir que o SES use sua chave gerenciada pelo cliente.

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • Use a operação CreateImportJob na API v2 do SES.

nota

O exemplo a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Na linha de comando, insira o seguinte comando: Substitua s3Bucket pelo nome do bucket do Amazon S3 e s3object pelo nome do objeto do Amazon S3.

aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=DELETE} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV

Para remover endereços de e-mail em massa da sua lista de supressão por conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. Na tabela Suppression list (Lista de supressão), expanda o botão Bulk actions (Ações em massa) e selecione Remove e-mail addresses in bulk (Remover endereços de e-mail em massa).

  4. Em Bulk action specifications (Especificações da ação em massa), selecione (a) Choose file from S3 bucket (Escolher arquivo do bucket do S3) ou (b) Import from file (Importar do arquivo). Os procedimentos indicados para cada método de importação estão abaixo:

    1. Choose file from S3 bucket (Escolher arquivo do bucket do S3) - Se seu arquivo de origem já estiver armazenado em um bucket do Amazon S3:

      1. Se você sabe o URI do bucket do Amazon S3 que deseja usar, insira-o no campo Amazon S3 URI (URI do Amazon S3); caso contrário, escolha Browse S3 (Procurar no S3):

        1. Em Buckets, selecione o nome do bucket do S3.

        2. Em Objects (Objetos), selecione o nome do arquivo e selecione Choose (Escolher). Você será direcionado de volta para Bulk action specifications (Especificações da ação em massa).

        3. (Opcional) Se você quiser ser levado ao console do Amazon S3 para exibir detalhes sobre o seu objeto do S3, escolha View (Exibir).

      2. Em File format (Formato do arquivo), selecione o formato do arquivo que você escolheu para importar do seu bucket do Amazon S3.

      3. Escolha Remove e-mail addresses (Remover endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.

    2. Import from file (Importar do arquivo) - se você tiver um arquivo de origem local para carregar em um bucket do Amazon S3 novo ou existente:

      1. Em Import source file (Importar arquivo de origem), selecione Choose file (Escolher arquivo).

      2. Selecione o arquivo JSON ou CSV no navegador de arquivos e escolha Open (Abrir). Você verá o nome, o tamanho e a data do seu arquivo exibidos sob o botão Choose file (Escolher arquivo).

      3. Expanda Amazon S3 bucket (Bucket do Amazon S3) e selecione o bucket do S3.

        1. Para carregar seu arquivo em um novo bucket, escolha Create S3 bucket (Criar bucket do S3), insira um nome no campo Bucket name (Nome do bucket) e escolha Create bucket (Criar bucket).

      4. Escolha Remove e-mail addresses (Remover endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.

  5. Independentemente do método de importação que você usou, seu ID de trabalho será listado em Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data. Para exibir os detalhes do trabalho, selecione o ID do trabalho.

  6. Selecione a guia Suppression list (Lista de supressão) e todos os endereços de e-mail importados com êxito que foram removidos da sua lista de supressão não serão mais exibidos.

Visualização de uma lista de trabalhos de importação para a conta

Você pode visualizar uma lista de todos os endereços de e-mail que estão na lista de supressão no nível da conta da sua conta usando a operação ListImportJobs na API v2 do Amazon SES.

nota

O procedimento a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Para exibir uma lista de todos os trabalhos de importação da conta

  • Na linha de comando, insira o seguinte comando:

    aws sesv2 list-import-jobs

O comando anterior retorna todos os trabalhos de importação da conta. A saída será semelhante ao seguinte exemplo:

{ "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 exibir uma lista de todos os trabalhos de importação para a conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. No painel Suppression list (Lista de supressão), selecione a guia Bulk actions (Ações em massa).

  4. Todos os trabalhos de importação serão listados na tabela Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data.

  5. Para exibir detalhes da tarefa, selecione o ID do trabalho e os seguintes painéis são exibidos:

    1. Bulk action status (Status da ação em massa): mostra o status geral dos trabalhos, a hora e a data em que foram concluídas, quantos registros foram importados e a contagem de todos os registros que não foram importados com êxito.

    2. Bulk action details (Detalhes da ação em massa): mostra o ID do trabalho, se ele foi usado para adicionar ou remover endereços, se o formato do arquivo era JSON ou CSV, o URI do bucket do Amazon S3 onde o arquivo em massa foi armazenado e a hora e a data em que a ação em massa foi criada.

Obtenção de informações sobre um trabalho de importação para a conta

Você pode obter informações sobre um trabalho de importação para a conta usando a operação GetImportJob na API v2 do Amazon SES.

nota

O procedimento a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Para obter informações sobre um trabalho de importação para a conta

  • Na linha de comando, insira o seguinte comando:

    aws sesv2 get-import-job --job-id JobId

O comando anterior retorna informações sobre um trabalho de importação para a conta. A saída será semelhante ao seguinte exemplo:

{ "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 obter informações sobre um trabalho de importação para a conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. No painel Suppression list (Lista de supressão), selecione a guia Bulk actions (Ações em massa).

  4. Todos os trabalhos de importação serão listados na tabela Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data.

  5. Para exibir detalhes da tarefa, selecione o ID do trabalho e os seguintes painéis são exibidos:

    1. Bulk action status (Status da ação em massa): mostra o status geral dos trabalhos, a hora e a data em que foram concluídas, quantos registros foram importados e a contagem de todos os registros que não foram importados com êxito.

    2. Bulk action details (Detalhes da ação em massa): mostra o ID do trabalho, se ele foi usado para adicionar ou remover endereços, se o formato do arquivo era JSON ou CSV, o URI do bucket do Amazon S3 onde o arquivo em massa foi armazenado e a hora e a data em que a ação em massa foi criada.

Como desabilitar a lista de supressão do Amazon SES por conta

Você pode usar a operação PutAccountSuppressionAttributes na API v2 do SES para desabilitar efetivamente a lista de supressão no nível da conta removendo os valores do atributo suppressed-reasons.

nota

O procedimento a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Como desabilitar a lista de supressão no nível da conta usando a AWS CLI

  • Na linha de comando, insira o seguinte comando:

    aws sesv2 put-account-suppression-attributes --suppressed-reasons

Como desabilitar a lista de supressão no nível da conta usando o console do SES:

  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).

  3. No painel Account-level settings (Configurações no nível da conta), escolha Edit (Editar).

  4. Em Suppression list (Lista de supressão), desmarque a caixa Enabled (Habilitada).

  5. Selecione Save changes.