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

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

  Contoh file JSON CreateContactList input 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

  Di perintah sebelumnya, ganti CONTACT-JSON dengan jalur ke file JSON Anda untuk permintaan Anda. CreateContact

  Contoh file JSON CreateContact input 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, dan 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 menempatkan metadata apa pun tentang kontak kami. Ini harus menjadi objek JSON valid.

1. Daftar kontak dengan menggunakan AWS CLI - Dengan menggunakan ListContactsoperasi untuk mengambil daftar semua kontak Anda yang telah berlangganan topik tertentu, bersama dengan SendEmailoperasi, yang mengizinkan Anda untuk mengirimkan mereka email.

   Di baris perintah, masukkan perintah berikut:

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

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

   Contoh file JSON ListContacts input untuk permintaan adalah sebagai berikut:

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

   FilteredStatusMenunjukkan status langganan yang ingin Anda filter, antara OPT_IN atauOPT_OUT.

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

   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 mencantumkan 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, termasuk contactListNamedan topicNameyang email milik (topicNameadalah opsional):

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

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

   Amazon SES akan mementalkan email jika dikirim ke kontak yang tidak berlangganan di 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 memanfaatkan ListManagementOptionsAnda memiliki opsi untuk mengaktifkan Amazon 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.

   Sebagai alternatif, 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}