Utilizzo della gestione degli elenchi

Per creare un elenco di contatti utilizzando AWS CLI

• Nella riga di comando, inserisci il comando seguente:

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

  Nel comando precedente, sostituisci CONTACT-LIST-JSON con il percorso del file JSON per il tuo CreateContactList richiesta.

  Un esempio di file JSON di input CreateContactList per la richiesta è il seguente:

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

Per creare un contatto utilizzando AWS CLI

• Nella riga di comando, inserisci il comando seguente:

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

  Nel comando precedente, sostituisci CONTACT-JSON con il percorso del file JSON per il tuo CreateContact richiesta.

  Un esempio di file JSON di input CreateContact per la richiesta è il seguente:

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

  Nell'esempio precedente, un valore UnsubscribeAll di false indica che il contatto non ha annullato la sottoscrizione a tutti gli argomenti, laddove un valore di true significherebbe che il contatto ha annullato la sottoscrizione a tutti gli argomenti.

  TopicPreferences include informazioni sullo stato della sottoscrizione del contatto agli argomenti. Nell'esempio precedente, il contatto ha scelto l'argomento "Sports" e riceverà tutti i messaggi di posta elettronica relativi all'argomento "Sports".

  AttributesData è un campo JSON in cui è possibile inserire qualsiasi tipo di metadati sul nostro contatto. Deve essere un oggetto JSON valido.

1. Elenca i contatti utilizzando AWS CLI — Puoi usare ListContacts operazione per recuperare un elenco di tutti i tuoi contatti che si sono iscritti a un determinato argomento, insieme a SendEmail operazione, che consente di inviare loro e-mail.

   Nella riga di comando, inserisci il comando seguente:

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

   Nel comando precedente, sostituisci LIST-CONTACTS-JSON con il percorso del file JSON per il tuo ListContacts richiesta.

   Un esempio di file JSON di input ListContacts per la richiesta è il seguente:

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

   FilteredStatus mostra lo stato della sottoscrizione per il quale si desidera filtrare, ovvero OPT_IN o OPT_OUT.

   TopicFilter è un filtro facoltativo che specifica l'argomento per cui si desidera ottenere risultati e, nell'esempio precedente, è "Cycling".

   UseDefaultIfPreferenceUnavailable può avere un valore di true o false. Se true, verrà utilizzata la preferenza predefinita dell'argomento se il contatto non dispone di alcuna preferenza esplicita per un argomento. Se false, solo i contatti con una preferenza impostata esplicitamente vengono considerati per il filtraggio.

2. Invia posta con ListManagementOptions abilitato: dopo aver elencato i contatti nell'elenco utilizzando il precedente comando ListContacts, è possibile utilizzare il comando SendEmail per inviare e-mail a ciascun contatto utilizzando l'intestazione ListManagementOptions per specificare l'elenco dei contatti e il nome dell'argomento.

   Per utilizzare ListManagementOptions con il comando SendEmail, includere contactListName e topicName a cui appartiene l'e-mail (topicName è facoltativo):

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   Se includi ListManagementOptions nella richiesta SendEmail a un indirizzo e-mail del destinatario che non è presente nell'elenco dei contatti, verrà creato automaticamente un contatto nell'elenco.

   SES emetterà un bounce event per un messaggio inviato a un contatto non iscritto nell'elenco dei contatti, il che significa che non sarà necessario aggiornare il SendEmail richieste per evitare l'invio ai contatti che hanno annullato l'iscrizione.

3. Indica la posizione dei link di annullamento dell'iscrizione — Quando si utilizza ListManagementOptions hai la possibilità di consentire a SES di aggiungere link per l'annullamento dell'iscrizione nella tua email utilizzando il {{amazonSESUnsubscribeUrl}} segnaposto per specificare dove SES deve inserire l'URL di annullamento dell'iscrizione. La sostituzione dei placeholder è supportata solo per i tipi di contenuto HTML e TEXT. È possibile includere il placeholder al massimo due volte. Se usato più di due volte, vengono sostituite solo le prime due occorrenze. Per ulteriori informazioni, consulta Utilizzo della gestione delle sottoscrizioni.

   In alternativa, puoi utilizzare l'intestazione X-SES-LIST-MANAGEMENT-OPTIONS per specificare un elenco e un nome di argomento durante l'invio di e-mail utilizzando l'interfaccia SMTP.

   Per specificare il nome di un elenco e di un argomento durante l'invio di e-mail utilizzando l'interfaccia SMTP, aggiungere la seguente intestazione di posta elettronica al messaggio:

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