Criação de conjuntos de configurações em SES - Amazon Simple Email Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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):

    • Configuration set name (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 — marque a caixa de seleção Usar um domínio de redirecionamento personalizado para usar um domínio de redirecionamento personalizado para lidar com o rastreamento de abertura e clique desse conjunto de configurações, em vez de usar um dos SES domínios.

      • Custom redirect domain (Domínio de redirecionamento personalizado): com um domínio de redirecionamento personalizado, você pode inserir um subdomínio personalizado na caixa (opcional) ou selecionar um domínio verificado na lista.

      nota

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

      • Os domínios de redirecionamento devem ser configurados antes de escolher essa opção. Para obter instruções sobre como selecionar um domínio personalizado para lidar com rastreamento de aberturas e cliques, consulte Configurar domínios personalizados para lidar com rastreamento de abertura e clique.

      • Depois, para escolher por usar um domínio de redirecionamento personalizado, você deve indicá-lo ao criar seu conjunto de configurações ou, posteriormente, editando suas opções de rastreamento para o conjunto de configurações.

    • Advanced delivery options (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.

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

      • Enabled (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 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" }, "DeliveryOptions": { "TlsPolicy": "REQUIRE", "SendingPoolName": "sending pool" }, "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.