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

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

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

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

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. 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 (_).

   • Grupo de IPs de envio: quando você envia e-mails usando esse conjunto de configurações, as mensagens são enviadas dos endereços IP dedicados no grupo 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 aberturas e cliques para e-mails enviados com esse conjunto de configurações.

     • Domínio de redirecionamento personalizado: selecione um domínio verificado na lista Escolher 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 Entrega de Conteúdo (CDN). Isso é explicado em Configurar domínios personalizados para lidar com rastreamento de abertura e clique.

       • Em seguida, para usar seu domínio de redirecionamento personalizado para rastreamento de aberturas e cliques, 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, a opção Visualizar registros DNS aparecerá no contêiner de Detalhes gerais do conjunto de configurações. Se você expandi-lo, verá o registro CNAME que contém o domínio de rastreamento que está sendo usado no seu Região da AWS. Por exemplo, se o seu subdomínio personalizado se chamar marketing.example.com e tiver sido criado na Região da AWS us-east-1, a expansão de Visualizar registros DNS revelaria um registro CNAME com os seguintes valores: Nome = marketing.example.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 sua CDN conforme explicado em Configurar domínios personalizados para lidar com rastreamento de abertura e clique ou pode fazer isso primeiro e usar os valores do registro CNAME daqui para usar na configuração da CDN.

     • Política HTTPS: selecione uma opção de política HTTPS para o protocolo dos links de rastreamento de aberturas e cliques para seu domínio de redirecionamento personalizado:

       • Opcional: (comportamento padrão) os links de rastreamento de aberturas serão agrupados usando HTTP. Os links de rastreamento de cliques serão agrupados usando o protocolo original do link.

       • Obrigatório: os links de rastreamento de aberturas e cliques serão agrupados usando HTTPS.

       • Obrigatório para aberturas: os links de rastreamento de aberturas serão agrupados usando HTTPS. 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.

     • Transport Layer Security (TLS): para exigir que o SES estabeleça uma conexão segura com o servidor de e-mail de recebimento e envie e-mails usando o protocolo TLS, selecione a caixa de seleção Obrigatório.

       nota

       O SES é compatível com o TLS 1.2 e recomenda o 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 para o SES tentar a 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 do que o padrão SES 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 converter minutos em segundos, multiplique por 60, por exemplo, 7 minutos x 60 = 420 segundos.

       • Para converter horas em segundos, multiplique por 3.600, por exemplo, 2 horas x 3.600 = 7.200 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.)

     • Habilitado: marque essa caixa de seleção para habilitar 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 Criar destinos de eventos do Amazon SES.

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

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

1. Criar um arquivo JSON de entrada da CLI

   Use sua ferramenta de edição de arquivos favorita para criar um arquivo JSON com as chaves a seguir, além dos valores que são válidos para seu ambiente, ou use o comando aws sesv2 create-configuration-set da API v2 do SES com a opção --generate-cli-skeleton sem nenhum valor especificado a fim de imprimir um exemplo de estrutura JSON para 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

   • É necessário incluir a notação file:// no início do caminho do arquivo JSON.

   • O caminho para o arquivo JSON deve seguir a convenção apropriada para o sistema operacional de base no qual 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.