Menggunakan pengelolaan daftar

Untuk membuat daftar kontak dengan menggunakan AWS CLI

• Di baris perintah, masukkan perintah berikut:

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

  Pada perintah sebelumnya, ganti CONTACT-LIST-JSON dengan path ke file JSON Anda untuk permintaan Anda. CreateContactList

  Contoh CreateContactList input file JSON untuk permintaan adalah sebagai berikut:

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

Untuk membuat kontak dengan menggunakan AWS CLI

• Di baris perintah, masukkan perintah berikut:

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

  Pada perintah sebelumnya, ganti CONTACT-JSON dengan path ke file JSON Anda untuk permintaan Anda. CreateContact

  Contoh CreateContact input file JSON untuk permintaan adalah sebagai berikut:

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

  Dalam contoh di atas, UnsubscribeAll nilai false menunjukkan bahwa kontak belum berhenti berlangganan dari semua topik, di mana nilai true berarti kontak telah berhenti berlangganan dari semua topik.

  TopicPreferencesmencakup informasi tentang status langganan kontak ke topik. Dalam contoh sebelumnya, kontak telah memilih topik "Olahraga" dan akan menerima semua email ke topik "Olahraga”.

  AttributesDataIni adalah bidang JSON tempat Anda dapat meletakkan metadata apa pun tentang kontak kami. Ini harus menjadi objek JSON valid.

1. Daftar kontak dengan menggunakan AWS CLI — Anda dapat menggunakan ListContactsoperasi untuk mengambil daftar semua kontak Anda yang telah berlangganan topik tertentu, dalam hubungannya dengan SendEmailoperasi, yang memungkinkan Anda untuk mengirim mereka email.

   Di baris perintah, masukkan perintah berikut:

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

   Pada perintah sebelumnya, ganti LIST-CONTACTS-JSON dengan path ke file JSON Anda untuk permintaan Anda. ListContacts

   Contoh ListContacts input file JSON untuk permintaan adalah sebagai berikut:

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

   Ini FilteredStatus menunjukkan status langganan yang ingin Anda filter, yaitu salah satu OPT_IN atauOPT_OUT.

   TopicFilterIni adalah filter opsional yang menentukan topik mana yang Anda inginkan hasilnya, dan dalam contoh di atas, yaitu "Bersepeda.”

   UseDefaultIfPreferenceUnavailabledapat memiliki nilai true ataufalse. Jika true, preferensi default topik akan digunakan jika kontak tidak memiliki preferensi eksplisit untuk topik. Jika false, hanya kontak dengan preferensi yang diatur secara eksplisit dipertimbangkan untuk pemfilteran.

2. Kirim email dengan ListManagementOptions diaktifkan - Setelah daftar kontak dalam daftar Anda menggunakan ListContactsoperasi di atas, Anda dapat menggunakan SendEmailoperasi untuk mengirim email ke setiap kontak Anda dengan memanfaatkan ListManagementOptionsheader untuk menentukan daftar kontak dan nama topik Anda.

   Untuk digunakan ListManagementOptions dengan SendEmail operasi, sertakan contactListNamedan topicNameyang menjadi milik email (opsional): topicName

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   Jika Anda memasukkan ListManagementOptions dalam SendEmail permintaan Anda ke alamat email penerima yang tidak ada dalam daftar kontak Anda, maka kontak akan dibuat di daftar Anda secara otomatis.

   SES akan mengeluarkan peristiwa bouncing untuk pesan yang dikirim ke kontak yang berhenti berlangganan pada daftar kontak Anda, yang berarti Anda tidak perlu memperbarui SendEmail permintaan Anda untuk menghindari pengiriman ke kontak yang telah berhenti berlangganan.

3. Tunjukkan lokasi untuk tautan berhenti berlangganan Anda - Saat menggunakan, ListManagementOptionsAnda memiliki opsi untuk mengaktifkan SES untuk menambahkan tautan footer berhenti berlangganan di email Anda menggunakan {{amazonSESUnsubscribeUrl}} placeholder untuk menentukan di mana SES perlu memasukkan URL berhenti berlangganan. Penggantian placeholder didukung hanya untuk tipe konten HTML dan TEXT. Anda dapat menyertakan placeholder maksimum dua kali. Jika digunakan lebih dari dua kali, hanya dua kejadian pertama yang diganti. Untuk informasi selengkapnya, lihat Menggunakan manajemen berlangganan.

   Atau, jika Anda menggunakan antarmuka SMTP untuk mengirim email, Anda dapat menggunakan X-SES-LIST-MANAGEMENT-OPTIONS header untuk menentukan daftar dan nama topik.

   Untuk menentukan daftar dan nama topik saat mengirim email menggunakan antarmuka SMTP, tambahkan header email berikut pada pesan Anda:

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