Criação de conjuntos de configurações em SES

Você pode usar o SES console, a CreateConfigurationSet ação na Amazon SES API v2 ou o aws sesv2 create-configuration-set comando na Amazon SES CLI v2 para criar um novo conjunto de configurações. Esta seção mostra como criar conjuntos de configurações usando o SES console e o Amazon SES CLI v2.

Para criar um conjunto de configurações (console)

Para criar um conjunto de configurações usando o SES console, siga estas etapas:

1. Faça login no AWS Management Console e abra o SES console da Amazon 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. Escolha Create Route (Criar rota).

4. Insira os seguintes detalhes na seção General details (Detalhes gerais):

   • Nome do conjunto de configurações — O nome do seu conjunto de configurações. O nome pode conter até 64 caracteres alfanuméricos, incluindo apenas letras, números, hifens (-) e sublinhas (_).

   • Envio de pool de IP — Quando você envia e-mail usando esse conjunto de configurações, as mensagens são enviadas dos endereços IP dedicados no pool atribuído. Selecione um grupo de IPs na lista.

     nota

     O padrão (ses-default-dedicated-pool) contém endereços IP dedicados que não foram atribuídos a nenhum outro pool. Para saber mais sobre grupos de IPs, consulte Atribuir grupos de IP.

   • Opções de rastreamento

     • Usar um domínio de redirecionamento personalizado — Marque a caixa de seleção para usar um domínio de redirecionamento personalizado para lidar com o rastreamento de abertura e clique de e-mails enviados com esse conjunto de configurações.

     • Domínio de redirecionamento personalizado — Selecione um domínio verificado na lista Escolha um domínio verificado para ser seu domínio de redirecionamento personalizado. Você também pode inserir um subdomínio no campo Inserir um subdomínio.

       nota

       Os domínios de redirecionamento personalizados podem ser especificados da seguinte forma:

       • Primeiro, você deve criar e verificar um domínio de redirecionamento personalizado no qual Região da AWS deseja enviar e rastrear e-mails, bem como configurar uma rede de distribuição de conteúdo (CDN). Isso é explicado emConfigurar domínios personalizados para lidar com rastreamento de abertura e clique.

       • Em seguida, para usar seu domínio de redirecionamento personalizado para rastreamento de abertura e clique, você deve indicá-lo ao criar ou editar seu conjunto de configurações aqui nesta etapa.

       • Por fim, depois de especificar seu domínio de redirecionamento personalizado, DNSos registros de visualização aparecerão no contêiner Detalhes gerais do conjunto de configurações. Se você expandi-lo, verá o CNAME registro que contém o domínio de rastreamento que está sendo usado no seu Região da AWS. Por exemplo, se seu subdomínio personalizado se chama marketing.example.com e foi criado no Região da AWS us-east-1, a expansão dos DNSregistros View revelaria um CNAME registro com os seguintes valores: Nome = marketing.exemplo.com e Valor = r.us-east-1.awstrack.me.

         Você pode usar essas informações simplesmente como uma confirmação de que escolheu o domínio de rastreamento correto na tabela ao configurar o seu, CDN conforme explicado emConfigurar domínios personalizados para lidar com rastreamento de abertura e clique, ou pode fazer isso primeiro e usar os valores de CNAME registro aqui para usar em sua CDN configuração.

     • HTTPSpolítica — Selecione uma opção HTTPS de política para o protocolo dos links de rastreamento abertos e clique para seu domínio de redirecionamento personalizado:

       • Opcional — (comportamento padrão) Os links de rastreamento abertos serão agrupados usandoHTTP. Os links de rastreamento de cliques serão agrupados usando o protocolo original do link.

       • Obrigatório — Os links de rastreamento de abertura e clique serão agrupados usandoHTTPS.

       • Obrigatório para aberturas — Os links de rastreamento abertos serão agrupados usandoHTTPS. Os links de rastreamento de cliques serão agrupados usando o protocolo original do link.

   • Opções avançadas de entrega — Escolha a seta à esquerda para expandir a seção de opções avançadas de entrega.

     • Segurança da camada de transporte (TLS) — SES Para exigir o estabelecimento de uma conexão segura com o servidor de e-mail receptor e o envio de e-mails usando o TLS protocolo, marque a caixa de seleção Obrigatório.

       nota

       SESsuporta TLS 1.2 e recomenda TLS 1.3. Para saber mais, consulte Segurança da infraestrutura no SES.

     • Duração máxima da entrega — Para especificar um limite de tempo SES para a tentativa de entrega de e-mail por meio desse conjunto de configurações, insira um valor em segundos que varia de 300 a 50.400.

       nota

       Definir um limite máximo de entrega personalizado (menor que o SES padrão de 14 horas) pode ser útil em casos como e-mails urgentes (como aqueles que contêm um one-time-password), e-mails transacionais e e-mails que você deseja garantir que não sejam entregues fora do horário comercial.

       dica

       • Para calcular minutos a segundos, multiplique por 60, por exemplo, 7 minutos* 60 = 420 segundos.

       • Para calcular horas e segundos, multiplique por 3600, por exemplo, 2 horas * 3600 = 7200 segundos.

5. Insira os seguintes detalhes na seção Reputation options (Opções de reputação):

   • Métricas de reputação — Usadas para rastrear métricas de rejeição e reclamação em CloudWatch e-mails enviados usando esse conjunto de configurações. (Cobranças adicionais se aplicam, consulte Preço por métrica para CloudWatch.)

     • Ativado — Marque essa caixa de seleção para ativar as métricas de reputação para o conjunto de configurações.

6. 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.

7. A seção Virtual Deliverability Manager options (Opções do Virtual Deliverability Manager) oferece uma maneira de definir configurações personalizadas de como esse conjunto de configurações usará o rastreamento de engajamento e a entrega compartilhada otimizada, substituindo a forma como elas foram definidas no Virtual Deliverability Manager no nível da conta:

   1. Para desabilitar o rastreamento de engajamento e a entrega compartilhada otimizada para esse conjunto de configurações:

      1. Marque a caixa Override account level settings (Substituir configurações no nível da conta).

      2. Verifique se a opção Enabled (Habilitado) está desmarcada tanto para Engagement tracking (Rastreamento de engajamento) como para Optimized shared delivery (Entrega compartilhada otimizada) e selecione Save changes (Salvar alterações).

   2. Para habilitar ou desabilitar o rastreamento de engajamento e a entrega compartilhada otimizada (ou ambos) para esse conjunto de configurações:

      1. Marque a caixa Override account level settings (Substituir configurações no nível da conta).

      2. Marque ou desmarque a opção Enabled (Habilitado) para Engagement tracking (Rastreamento de engajamento) ou Optimized shared delivery (Entrega compartilhada otimizada) (ou para ambos) e selecione Save changes (Salvar alterações).

   3. Para voltar às configurações no nível da conta do Virtual Deliverability Manager para o rastreamento de engajamento e a entrega compartilhada otimizada para este conjunto de configurações:

      1. Desmarque a caixa Override account level settings (Substituir configurações no nível da conta) e selecione Save changes (Salvar alterações).

8. Opcionalmente, você pode adicionar uma ou mais etiquetas nas seção Tags (Etiquetas). Repita as etapas a seguir para cada etiqueta que você deseja adicionar ao conjunto de configurações.

   1. Selecione Add new tag (Adicionar nova etiqueta).

   2. Insira a etiqueta Key (Chave).

   3. Insira a etiqueta Value (Valor) (opcional).

   Para remover uma etiqueta que você inseriu, escolha Remove (Remover) para essa etiqueta. Você pode adicionar no máximo 50 etiquetas.

9. Selecione Create set (Criar conjunto) para criar seu conjunto de configurações.

Agora que criou o conjunto de configurações, você tem a opção de definir destinos de eventos para ele, o que permite a publicação de eventos acionada com base nos tipos de evento especificados para o destino do evento. Um conjunto de configurações pode ter vários destinos de eventos com diversos tipos de eventos definidos. Consulte Criação de destinos para SES eventos na Amazon.

Criar um conjunto de configurações (AWS CLI)

Você pode criar um conjunto de configurações usando um JSON arquivo como entrada para o aws sesv2 create-configuration-set comando no AWS CLI.

1. Criar um JSON arquivo CLI de entrada

   Use sua ferramenta de edição de arquivos favorita para criar um JSON arquivo com as seguintes chaves, além de valores válidos para seu ambiente, ou use o aws sesv2 create-configuration-set comando SES API v2 com a --generate-cli-skeleton opção sem valor especificado para imprimir uma JSON estrutura de amostra na saída padrão.

   Este exemplo usa um arquivo denominado create-configuration-set.json:

   {
       "ConfigurationSetName": "sample-configuration-set",
       "TrackingOptions": {
           "CustomRedirectDomain": "some.domain.com",
           "HttpsPolicy": "REQUIRE"
       },
       "DeliveryOptions": {
           "TlsPolicy": "REQUIRE",
           "SendingPoolName": "sending pool",
           "MaxDeliverySeconds": 300            
       },
       "ReputationOptions": {
           "ReputationMetricsEnabled": true,
           "LastFreshStart": timestamp
       },
       "SendingOptions": {
           "SendingEnabled": true
       },
       "Tags": [
           {
               "Key": "tag key",
               "Value": "tag value"
           }
       ],
       "SuppressionOptions": {
           "SuppressedReasons": ["BOUNCE","COMPLAINT"]
       }
   }

   nota

   • Você deve incluir a file:// notação no início do caminho do JSON arquivo.

   • O caminho para o JSON arquivo deve seguir a convenção apropriada para o sistema operacional básico em que você está executando o comando. Por exemplo, o Windows usa a barra invertida (\) para se referir ao caminho do diretório e o Linux usa a barra (/).

2. Execute o seguinte comando, usando o arquivo que você criou como entrada.

   aws sesv2 create-configuration-set --cli-input-json file://create-configuration-set.json

nota

Para revisar a AWS CLI referência desse comando, consulte create-configuration-set.