Uso do gerenciamento de listas

Para criar uma lista de contatos usando o AWS CLI

• Na linha de comando, insira o seguinte comando:

  aws sesv2 create-contact-list --cli-input-json file://CONTACT-LIST-JSON

  No comando anterior, CONTACT-LIST-JSON substitua pelo caminho para o arquivo JSON da sua CreateContactListsolicitação.

  Um exemplo de arquivo JSON de entrada CreateContactList para a solicitação é o seguinte:

  {
      "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"
       }
      ]
  }

Para criar um contato usando o AWS CLI

• Na linha de comando, insira o seguinte comando:

  aws sesv2 create-contact --cli-input-json file://CONTACT-JSON

  No comando anterior, CONTACT-JSON substitua pelo caminho para o arquivo JSON da sua CreateContactsolicitação.

  Um exemplo de arquivo JSON de entrada CreateContact para a solicitação é o seguinte:

  {
      "ContactListName": "ExampleContactListName",
      "EmailAddress": "example@amazon.com",
      "UnsubscribeAll": false,
      "TopicPreferences": [
          {
              "TopicName": "Sports",
              "SubscriptionStatus": "OPT_IN"
          }
      ],
      "AttributesData": "{\"Name\": \"John\", \"Location\": \"Seattle\"}"
  }

  No exemplo acima, um valor UnsubscribeAll de false mostra que o contato não cancelou a assinatura de todos os tópicos. Já um valor de true significaria que o contato cancelou a assinatura de todos os tópicos.

  TopicPreferences inclui informações sobre o status de assinatura de tópicos do contato. No exemplo anterior, o contato optou pelo tópico “Esportes” e receberá todos os e-mails do tópico “Esportes”.

  O AttributesData é um campo JSON onde você pode colocar qualquer metadado sobre o nosso contato. Ele deve ser um objeto JSON válido.

1. Liste contatos usando o AWS CLI — Você pode usar a ListContactsoperação para recuperar uma lista de todos os seus contatos que se inscreveram em um tópico específico, em conjunto com a SendEmailoperação, que permite enviar e-mails para eles.

   Na linha de comando, insira o seguinte comando:

   aws sesv2 list-contacts --cli-input-json file://LIST-CONTACTS-JSON

   No comando anterior, LIST-CONTACTS-JSON substitua pelo caminho para o arquivo JSON da sua ListContactssolicitação.

   Um exemplo de arquivo JSON de entrada ListContacts para a solicitação é o seguinte:

   {
       "ContactListName": "ExampleContactListName",
       "Filter": {
           "FilteredStatus": "OPT_IN",
           "TopicFilter": {
               "TopicName": "Cycling",
               "UseDefaultIfPreferenceUnavailable": true
           }
       },
       "PageSize": 50
   }

   O FilteredStatus mostra o status da assinatura para a qual você deseja filtrar, que é OPT_IN ou OPT_OUT.

   O TopicFilter é um filtro opcional que especifica o tópico para o qual você deseja resultados e, no exemplo acima, é “Ciclismo”.

   UseDefaultIfPreferenceUnavailable pode ter um valor de true ou false. Se true, a preferência padrão do tópico será usada se o contato não tiver nenhuma preferência explícita para um tópico. Se false, apenas os contatos com uma preferência definida explicitamente serão considerados para filtragem.

2. Enviar e-mail com ListManagementOptions habilitado: depois de listar os contatos em sua lista usando a operação ListContacts acima, você pode usar a operação SendEmailpara enviar e-mails a cada um de seus contatos utilizando o cabeçalho ListManagementOptions para especificar a lista de contatos e o nome do tópico.

   Para usar ListManagementOptions com a operação SendEmail, inclua o contactListName e o topicName aos quais o e-mail pertence (o topicName é opcional):

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   Se você incluir ListManagementOptions na solicitação SendEmail para o endereço de e-mail de um destinatário que não esteja em sua lista de contatos, será criado um contato em sua lista automaticamente.

   O Amazon SES devolverá um e-mail se ele for enviado para um contato da sua lista que cancelou a assinatura, o que significa que você não precisa atualizar as solicitações de SendEmail para evitar o envio a contatos que fizeram o cancelamento.

3. Indique o local para os links de cancelamento de assinatura: ao utilizar ListManagementOptions você tem a opção de permitir que o Amazon SES adicione links de rodapé de cancelamento de assinatura no e-mail usando o espaço reservado {{amazonSESUnsubscribeUrl}} para especificar onde o SES precisa inserir o URL de cancelamento. A substituição de espaço reservado é suportada apenas com os tipos de conteúdo HTML e TEXT. Você pode incluir o espaço reservado duas vezes no máximo. Se for usado mais de duas vezes, apenas as duas primeiras ocorrências são substituídas. Para obter mais informações, consulte Uso de o gerenciamento de assinaturas.

   Como alternativa, se estiver usando a interface SMTP para enviar um e-mail, você pode usar o cabeçalho X-SES-LIST-MANAGEMENT-OPTIONS para especificar um nome de lista e de tópico.

   Para especificar um nome de lista e tópico ao enviar e-mail usando a interface SMTP, adicione o seguinte cabeçalho de e-mail à sua mensagem:

   X-SES-LIST-MANAGEMENT-OPTIONS: {contactListName}; topic={topicName}