使用清單管理功能

使用 建立聯絡人清單 AWS CLI

• 在命令列中輸入以下命令：

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

  在上述命令中，以 CreateContactList 請求的 JSON 檔案路徑取代 CONTACT-LIST-JSON。

  請求的 CreateContactList 輸入 JSON 檔案範例如下：

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

使用 建立聯絡人 AWS CLI

• 在命令列中輸入以下命令：

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

  在上述命令中，以 CreateContact 請求的 JSON 檔案路徑取代 CONTACT-JSON。

  請求的 CreateContact 輸入 JSON 檔案範例如下:

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

  在上述範例中，false 的值 UnsubscribeAll 顯示聯絡人尚未取消訂閱所有主題，而值 true 表示聯絡人已取消訂閱所有主題。

  TopicPreferences 包含聯絡人主題訂閱狀態的相關資訊。在上述範例中，聯絡人已選擇加入「運動」主題，且會收到「運動」主題的所有電子郵件。

  AttributesData 是一個 JSON 欄位，可以在其中放置關於聯絡人的任何中繼資料。它必須是有效的 JSON 物件。

1. 使用 列出聯絡人 AWS CLI – 您可以使用 ListContacts操作來擷取已訂閱特定主題的所有聯絡人清單，以及 SendEmail操作，這可讓您傳送電子郵件給他們。

   在命令列中輸入以下命令：

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

   在上述命令中，以 ListContacts 請求的 JSON 檔案路徑取代 LIST-CONTACTS-JSON。

   請求的 ListContacts 輸入 JSON 檔案範例如下:

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

   FilteredStatus 會顯示您要篩選的訂閱狀態，也就是 OPT_IN 或 OPT_OUT。

   TopicFilter 是選用的篩選器，可指定你需要結果的主題，在上方例子中即為「Cycling」。

   UseDefaultIfPreferenceUnavailable 可以有 true 或 false 的值。如為 true，當聯絡人對某個主題沒有任何明確的偏好設定，便會使用主題預設偏好設定。如為 false，則只會篩選具有明確設定偏好設定的聯絡人。

2. 啟用 ListManagementOptions 傳送郵件 – 使用以上 ListContacts 作業列出您的聯絡人後，您可以使用 SendEmail 作業將電子郵件傳送給您的每個聯絡人，方法是利用 ListManagementOptions 標頭指定您的聯絡人清單和主題名稱。

   要使用 ListManagementOptions 與 SendEmail 作業，包括電子郵件隸屬的 contactListName 和 topicName (topicName是選擇性的):

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   如果您將 SendEmail 請求傳給不在聯絡人清單上的收件人電子郵件地址，且請求中包含 ListManagementOptions，系統便會自動在您的清單上建立聯絡人。

   如果將電子郵件傳送給聯絡人清單上未訂閱的聯絡人，Amazon SES 會將電子郵件退信，這表示您不需要更新 SendEmail 請求以避免傳送給已取消訂閱的聯絡人。

3. 表示取消訂閱連結的位置 – 利用 ListManagementOptions 時，您可以選擇啟用 Amazon SES 在您的電子郵件中添加取消訂閱頁尾連結，使用{{amazonSESUnsubscribeUrl}} 預留位置，以指定 SES 需要插入取消訂閱 URL 的位置。預留位置取代功能僅支援 HTML 與 TEXT 內容類型。您最多可以包含預留位置兩次。如果使用兩次以上，只會取代一開始的兩次。如需詳細資訊，請參閱使用訂閱管理功能。

   或者，若您使用 SMTP 介面傳送電子郵件，您也可以使用 X-SES-LIST-MANAGEMENT-OPTIONS 標頭來指定清單和主題名稱。

   若要在使用 SMTP 介面傳送電子郵件時指定清單和主題名稱，請在電子郵件中新增下列電子郵件標題：

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