목록 관리 사용

를 사용하여 연락처 목록을 생성하려면 AWS CLI

• 명령줄에 다음 명령을 입력합니다.

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

  위의 명령에서 CONTACT-LIST-JSON을 CreateContactList 요청에 대한 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

  위의 명령에서 CONTACT-JSON을 CreateContact 요청에 대한 JSON 파일 경로로 바꿉니다.

  요청에 대한 CreateContact 입력 JSON 파일의 예는 다음과 같습니다.

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

  위 예제에서 UnsubscribeAll 값이 false이면 해당 연락처가 모든 주제의 구독을 취소하지 않았음을 나타냅니다. 여기서 값이 true이면 연락처가 모든 주제의 구독을 취소했음을 의미합니다.

  TopicPreferences에는 연락처의 주제 구독 상태에 대한 정보가 포함되어 있습니다. 앞의 예에서 연락처는 'Sports' 주제를 선택했으며 'Sports' 주제에 대한 모든 이메일을 받게 됩니다.

  AttributesData는 연락처에 대한 모든 메타데이터를 넣을 수 있는 JSON 필드입니다. 유효한 JSON 객체여야 합니다.

1. 를 사용하여 연락처 나열 AWS CLI - ListContacts 작업을 사용하여 특정 주제를 구독한 모든 연락처 목록을 SendEmail 작업과 함께 검색할 수 있으며, 이를 통해 이메일을 보낼 수 있습니다.

   명령줄에 다음 명령을 입력합니다.

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

   위의 명령에서 LIST-CONTACT-JSON을 ListContacts 요청에 대한 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 헤더를 통해 연락처 목록과 주제 이름을 지정함으로써 각 연락처에 이메일을 보낼 수 있습니다.

   SendEmail 작업에 ListManagementOptions를 사용하려면 이메일이 속한 contactListName 및 topicName을 포함합니다(topicName은 선택 사항임).

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   연락처 목록에 없는 수신자 이메일 주소에 SendEmail 요청의 ListManagementOptions를 포함하면 목록에 자동으로 연락처가 만들어집니다.

   Amazon SES는 연락처 목록에 있는 구독 취소된 연락처로 이메일을 전송하면 반송합니다. 즉, 구독이 취소된 연락처로 전송되지 않도록 SendEmail 요청을 업데이트할 필요가 없습니다.

3. 구독 취소 링크의 위치 지정 – ListManagementOptions를 사용할 때 Amazon SES가 구독 취소 URL을 삽입해야 하는 위치를 지정하기 위해 {{amazonSESUnsubscribeUrl}} 자리 표시자를 사용하여 SES가 이메일에 구독 취소 바닥글 링크를 추가할 수 있도록 하는 옵션이 있습니다. HTML 및 TEXT 콘텐츠 형식에 대해서만 자리 표시자 교체가 지원됩니다. 자리 표시자를 최대 두 번 포함할 수 있습니다. 두 번 이상 사용하는 경우 처음 두 건만 교체됩니다. 자세한 내용은 구독 관리 사용 단원을 참조하십시오.

   또는 SMTP 인터페이스를 사용하여 이메일을 보내는 경우 X-SES-LIST-MANAGEMENT-OPTIONS 헤더를 사용하여 목록과 주제 이름을 지정할 수 있습니다.

   SMTP 인터페이스를 사용하여 이메일을 보내는 동안 목록과 주제 이름을 지정하려면 메시지에 다음 이메일 헤더를 추가합니다.

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