Utilisation de la gestion des listes

Pour créer une liste de contacts à l'aide de l'AWS CLI

• Sur la ligne de commande, entrez la commande suivante :

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

  Dans la commande précédente, remplacez CONTACT-LIST-JSON par le chemin de votre fichier JSON pour votre demande CreateContactList.

  Un exemple de fichier JSON d'entrée CreateContactList pour la demande est le suivant :

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

Pour créer un contact à l'aide de l'AWS CLI

• Sur la ligne de commande, entrez la commande suivante :

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

  Dans la commande précédente, remplacez CONTACT-JSON par le chemin de votre fichier JSON pour votre demande CreateContact.

  Un exemple de fichier JSON d'entrée CreateContact pour la demande est le suivant :

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

  Dans l'exemple ci-dessus, une valeur UnsubscribeAll de false indique que le contact ne s'est pas désabonné de toutes les rubriques, tandis qu'une valeur de true signifierait que le contact s'est désabonné de toutes les rubriques.

  TopicPreferences inclut des informations sur le statut d'abonnement du contact aux rubriques. Dans l'exemple précédent, le contact a opté pour la rubrique « Sports » et recevra tous les e-mails la concernant.

  AttributesData est un champ JSON dans lequel vous pouvez placer des métadonnées sur notre contact. Il doit s'agir d'un objet JSON valide.

1. Répertorier les contacts en utilisant AWS CLI – Vous pouvez utiliser l'opération ListContacts pour récupérer une liste de tous vos contacts qui se sont abonnés à une rubrique particulière, parallèlement à l'opérationSendEmail , qui vous permet de leur envoyer des e-mails.

   Sur la ligne de commande, entrez la commande suivante :

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

   Dans la commande précédente, remplacez LIST-CONTACTS-JSON par le chemin de votre fichier JSON pour votre demande ListContacts.

   Un exemple de fichier JSON d'entrée ListContacts pour la demande est le suivant :

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

   Le paramètre FilteredStatus affiche l'état d'abonnement pour lequel vous souhaitez appliquer un filtre, qui est soit OPT_IN, soit OPT_OUT.

   Le filtre TopicFilter est un filtre facultatif qui spécifie la rubrique pour laquelle vous souhaitez obtenir des résultats, à savoir « Cyclisme » dans l'exemple ci-dessus.

   UseDefaultIfPreferenceUnavailable peut avoir la valeur true ou false. S'il s'agit de true, la préférence de rubrique par défaut sera utilisée si le contact n'a aucune préférence explicite pour une rubrique. S'il s'agit de false, seuls les contacts qui ont une préférence explicitement définie sont pris en compte pour le filtrage.

2. Envoyer un e-mail avec ListManagementOptions activé – Après avoir répertorié les contacts dans votre liste à l'aide de l'opération ListContacts ci-dessus, vous pouvez utiliser l'opération SendEmail pour envoyer des e-mails à chacun de vos contacts à l'aide de l'en-tête ListManagementOptions afin de spécifier votre liste de contacts et votre nom de rubrique.

   Pour utiliser ListManagementOptions avec l'opération SendEmail, incluez contactListName et topicName auxquels appartient l'e-mail (topicNameest facultatif) :

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   Si vous incluez ListManagementOptions dans votre demande SendEmail à une adresse e-mail de destinataire qui ne figure pas sur votre liste de contacts, un contact sera automatiquement créé dans votre liste.

   Amazon SES renverra un e-mail à l'expéditeur s'il est envoyé à un contact désabonné de votre liste de contacts, ce qui signifie que vous n'aurez pas besoin de mettre à jour vos demandes SendEmail pour éviter de les envoyer à des contacts qui se sont désabonnés.

3. Indiquer l'emplacement de vos liens de désabonnement – Lorsque vous utilisez ListManagementOptions, vous avez la possibilité d'autoriser Amazon SES à ajouter des liens de bas de page de désabonnement dans votre e-mail à l'aide de l'espace réservé {{amazonSESUnsubscribeUrl}} pour spécifier où SES doit insérer l'URL de désabonnement. Le remplacement des espaces réservés n'est pris en charge que pour les types de contenu HTML et TEXT. Vous pouvez inclure l'espace réservé deux fois maximum. S'il est utilisé plus de deux fois, seules les deux premières occurrences sont remplacées. Pour de plus amples informations, veuillez consulter Utilisation de la gestion des abonnements.

   Vous pouvez également utiliser l'en-tête X-SES-LIST-MANAGEMENT-OPTIONS pour spécifier une liste et un nom de rubrique si vous utilisez l'interface SMTP pour envoyer des e-mails.

   Pour spécifier une liste et un nom de rubrique lors de l'envoi d'e-mails à l'aide de l'interface SMTP, ajoutez l'en-tête d'e-mail suivant à votre message :

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