Your favorite animal is {{favoriteanimal}}.
" } } ``` 이 코드는 다음 속성을 포함하고 있습니다. + **TemplateName** - `Template` 리소스의 이름입니다. 이메일을 보낼 때 이 이름을 참조합니다. + **TemplateContent** - 다음 속성을 위한 컨테이너입니다. + **제목** - 이메일의 제목입니다. 이 속성에는 대체 태그가 포함될 수 있습니다. 이 태그는 `{{tagname}}` 형식을 사용합니다. 이메일을 보낼 때 각 대상에 대해 `tagname`의 값을 지정할 수 있습니다. + **Html** – 이메일의 HTML 본문입니다. 이 속성에는 대체 태그가 포함될 수 있습니다. 이전 예에는 `{{name}}` 및 `{{favoriteanimal}}`이라는 두 가지 태그가 포함됩니다. + **Text** – 이메일의 텍스트 본문입니다. 이메일 클라이언트가 HTML 콘텐츠를 표시하지 않는 수신자는 이 이메일 버전을 볼 수 있습니다. 이 속성에는 대체 태그도 포함될 수 있습니다. 1. 위의 예를 필요에 맞게 사용자 지정한 다음 파일을 *mytemplate.json*으로 저장합니다. 1. 명령줄에 다음 명령을 입력하여 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html) v2 API 작업을 통해 새 템플릿을 생성합니다. ``` aws sesv2 create-email-template --cli-input-json file://mytemplate.json ``` ## 3부: 맞춤형 이메일 보내기 다음 두 가지 SES v2 API 작업을 사용하여 *저장된 템플릿* 또는 *인라인 템플릿*을 사용하여 이메일을 보낼 수 있습니다. + [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) 작업은 사용자 지정 이메일을 단일 대상 객체로 보내는 데 유용합니다. v2 API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) 객체에는 *ToAddresses*, *CcAddresses* 및 *BccAddresses* 속성이 포함될 수 있습니다. 이러한 주소는 모든 조합으로 사용할 수 있으며 동일한 이메일을 수신할 하나 이상의 이메일 주소를 포함할 수 있습니다. + [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html) 작업은 v2 API에 대한 단일 직접 호출로 여러 대상 객체에 고유의 이메일을 보내는 데 유용합니다. 이 섹션에서는를 사용하여 이러한 AWS CLI 두 전송 작업을 모두 사용하여 템플릿이 지정된 이메일을 보내는 방법의 예를 제공합니다. ### 단일 대상 객체에 템플릿 이메일 전송 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) 작업을 사용하여 단일 대상 객체에 정의된 하나 이상의 수신자에게 이메일을 보낼 수 있습니다. [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) 객체의 모든 수신자는 동일한 이메일을 수신합니다. **단일 대상 객체로 템플릿 이메일을 전송하려면** 1. *저장된 템플릿*을 사용할지 *인라인 템플릿*을 사용할지에 따라 텍스트 편집기에 붙여넣을 각 코드 예제를 선택하여 필요에 따라 사용자 지정합니다. ------ #### [ Stored template code example ] 이전 단계인 *MyTemplate*에서 생성한 템플릿은 `TemplateName` 파라미터의 값으로 참조됩니다. ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }" } }, "ConfigurationSetName": "ConfigSet" } ``` 이 코드는 다음 속성을 포함하고 있습니다. + **FromEmailAddress** - 발신자의 이메일 주소입니다. + **대상** - *ToAddresses*, *CcAddresses* 및 *BccAddresses* 속성에 정의된 이메일 수신자가 포함된 객체입니다. 이러한 주소는 모든 조합으로 사용할 수 있으며 동일한 이메일을 수신할 하나 이상의 이메일 주소를 포함할 수 있습니다. + **TemplateContent** - 다음 속성을 위한 컨테이너입니다. + **제목** - 이메일의 제목입니다. 이 속성에는 대체 태그가 포함될 수 있습니다. 이 태그는 `{{tagname}}` 형식을 사용합니다. 이메일을 보낼 때 각 대상에 대해 `tagname`의 값을 지정할 수 있습니다. + **Html** – 이메일의 HTML 본문입니다. 이 속성에는 대체 태그가 포함될 수 있습니다. 이전 예에는 `{{name}}` 및 `{{favoriteanimal}}`이라는 두 가지 태그가 포함됩니다. + **Text** – 이메일의 텍스트 본문입니다. 이메일 클라이언트가 HTML 콘텐츠를 표시하지 않는 수신자는 이 이메일 버전을 볼 수 있습니다. 이 속성에는 대체 태그도 포함될 수 있습니다. + **TemplateData** – 키-값 페어를 포함하는 이스케이프된 JSON 문자열입니다. 키는 `{{name}}`과 같이 이 파일의 `TemplateContent` 속성에 정의된 변수에 해당합니다. 값은 변수를 대체하는 콘텐츠를 나타냅니다. + **ConfigurationSetName** – 이메일 전송 시 사용할 구성 세트의 이름입니다. **참고** 렌더링 오류 이벤트를 Amazon SNS에 게시하도록 구성된 구성 세트를 사용하는 것이 좋습니다. 자세한 내용은 [(선택 사항) 1부: 렌더링 오류 이벤트 알림 설정](#send-personalized-email-set-up-notifications) 단원을 참조하십시오. ------ 1. 위의 예를 필요에 맞게 사용자 지정한 다음 파일을 *myemail.json*으로 저장합니다. 1. 명령줄에 v2 API 명령을 입력하여 이메일을 보냅니다. ``` aws sesv2 send-email --cli-input-json file://myemail.json ``` ### 여러 대상 객체에 템플릿 이메일 전송 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html) 작업을 사용하여 SES v2 API에 대한 단일 직접 호출에서 여러 대상 객체로 이메일을 전송할 수 있습니다. SES는 각 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) 객체의 수신자 또는 수신자들에게 고유한 이메일을 전송합니다. **여러 대상 객체에 템플릿 이메일 전송** 1. *저장된 템플릿*을 사용할지 *인라인 템플릿*을 사용할지에 따라 텍스트 편집기에 붙여넣을 각 코드 예제를 선택하여 필요에 따라 사용자 지정합니다. ------ #### [ Stored template code example ] 이전 단계인 *MyTemplate*에서 생성한 템플릿은 `TemplateName` 파라미터의 값으로 참조됩니다. ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"friend\", \"favoriteanimal\":\"unknown\" }" } }, "BulkEmailEntries": [ { "Destination": { "ToAddresses": [ "anaya.iyengar@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }" } } }, { "Destination": { "ToAddresses": [ "liu.jie@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }" } } }, { "Destination": { "ToAddresses": [ "shirley.rodriguez@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }" } } }, { "Destination": { "ToAddresses": [ "richard.roe@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{}" } } } ], "ConfigurationSetName": "ConfigSet" } ``` 이 코드는 다음 속성을 포함하고 있습니다. + **FromEmailAddress** - 발신자의 이메일 주소입니다. + **DefaultContent** - `TemplateContent` 및 `TemplateData` 객체를 포함하는 JSON 객체입니다. + **TemplateContent** - 다음 속성을 위한 컨테이너입니다. + **제목** - 이메일의 제목입니다. 이 속성에는 대체 태그가 포함될 수 있습니다. 이 태그는 `{{tagname}}` 형식을 사용합니다. 이메일을 보낼 때 각 대상에 대해 `tagname`의 값을 지정할 수 있습니다. + **Html** – 이메일의 HTML 본문입니다. 이 속성에는 대체 태그가 포함될 수 있습니다. 이전 예에는 `{{name}}` 및 `{{favoriteanimal}}`이라는 두 가지 태그가 포함됩니다. + **Text** – 이메일의 텍스트 본문입니다. 이메일 클라이언트가 HTML 콘텐츠를 표시하지 않는 수신자는 이 이메일 버전을 볼 수 있습니다. 이 속성에는 대체 태그도 포함될 수 있습니다. + **TemplateData** - `ReplacementEmailContent` 객체의 `ReplacementTemplateData` 속성에 빈 JSON 객체(`{}`)가 포함된 경우 사용할 키-값 페어를 포함합니다. + **BulkEmailEntries** - 하나 이상의 `Destination` 객체를 포함하는 배열입니다. + **대상** - *ToAddresses*, *CcAddresses* 및 *BccAddresses* 속성에 정의된 이메일 수신자가 포함된 객체입니다. 이러한 주소는 모든 조합으로 사용할 수 있으며 동일한 이메일을 수신할 하나 이상의 이메일 주소를 포함할 수 있습니다. + **ReplacementTemplateData** – 키-값 페어를 포함하는 이스케이프된 JSON 문자열입니다. 키는 `{{name}}`과 같이 이 파일의 `TemplateContent` 속성에 정의된 변수에 해당합니다. 값은 이메일의 변수를 대체하는 콘텐츠를 나타냅니다. (여기서 JSON 문자열이 비어 있는 경우(`{}`) `DefaultContent` 객체 내의 `TemplateData` 속성에 정의된 키-값 페어가 사용됩니다.) + **ConfigurationSetName** – 이메일 전송 시 사용할 구성 세트의 이름입니다. **참고** 렌더링 오류 이벤트를 Amazon SNS에 게시하도록 구성된 구성 세트를 사용하는 것이 좋습니다. 자세한 내용은 [(선택 사항) 1부: 렌더링 오류 이벤트 알림 설정](#send-personalized-email-set-up-notifications) 단원을 참조하십시오. ------ 1. 이전 단계의 코드의 값을 변경하여 사용자의 요구 사항을 충족시킨 다음 *mybulkemail.json* 파일로 저장합니다. 1. 명령줄에 v2 API 명령을 입력하여 대량 이메일을 보냅니다. ``` aws sesv2 send-bulk-email --cli-input-json file://mybulkemail.json ``` # 고급 이메일 맞춤 설정 *저장된 템플릿*을 사용하는 경우, 즉 SES v2 API와 함께 `CreateEmailTemplate` 작업을 사용하여 Amazon SES에서 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html) 리소스를 생성한 경우, 핸들바 시스템을 활용하여 중첩 속성, 배열 반복, 기본 조건문, 인라인 부분 생성과 같은 고급 기능을 포함하는 템플릿을 생성할 수 있습니다. 이 섹션에서는 이러한 기능의 예를 제공합니다. Handlebars에는 이 섹션에 설명되어 있는 기능 외의 추가 기능이 포함됩니다. 자세한 내용은 [handlebarsjs.com](http://handlebarsjs.com)에서 [Built-In Helpers](https://handlebarsjs.com/guide/builtin-helpers.html)를 참조하세요. **참고** SES는 메시지의 HTML 템플릿을 렌더링할 때 HTML 콘텐츠를 이스케이프하지 않습니다. 즉, 연락처 양식과 같이 사용자 입력 데이터를 포함하는 경우 클라이언트 측에서 이스케이프해야 합니다. **Topics** + [중첩 속성 분석](#send-personalized-email-advanced-nested) + [목록 살펴보기](#send-personalized-email-advanced-iterating) + [기본 조건문 사용](#send-personalized-email-advanced-conditionals) + [인라인 부분 생성](#send-personalized-email-advanced-inline-partials) ## 중첩 속성 분석 Handlebars에는 복잡한 고객 데이터를 쉽게 구성할 수 있는 중첩 경로 지원이 포함되고 이메일 템플릿의 그 데이터를 참조합니다. 예를 들어 수신자 데이터를 여러 일반 범주로 조직할 수 있습니다. 각 범주 내에 세부 정보를 포함할 수 있습니다. 다음 코드 예에는 단일 수신자에 대한 이 구조의 예가 나옵니다. ``` { "meta":{ "userId":"51806220607" }, "contact":{ "firstName":"Anaya", "lastName":"Iyengar", "city":"Bengaluru", "country":"India", "postalCode":"560052" }, "subscription":[ { "interest":"Sports" }, { "interest":"Travel" }, { "interest":"Cooking" } ] } ``` 이메일 템플릿에서 상위 속성의 이름 뒤에 마침표(.)와 값을 포함할 속성의 이름을 제공하여 중첩 속성을 참조할 수 있습니다. 예를 들어 앞의 예에 표시된 데이터 구조를 사용하고 이메일 템플릿에 각 수신자의 이름을 포함하려는 경우 이메일 템플릿에 `Hello {{contact.firstName}}!` 텍스트를 포함합니다. Handlebars는 여러 수준 깊이로 중첩된 경로를 구문 분석할 수 있기 때문에 유연하게 템플릿 데이터를 구성할 수 있습니다. ## 목록 살펴보기 `each` 보조 도구 함수는 어레이로 항목을 살펴봅니다. 다음 코드는 `each` 헬퍼 함수를 사용하여 항목화된 각 수신자의 관심사 목록을 생성하는 이메일 템플릿의 예입니다. ``` { "Template": { "TemplateName": "Preferences", "SubjectPart": "Subscription Preferences for {{contact.firstName}} {{contact.lastName}}", "HtmlPart": "You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
", "TextPart": "Your Preferences\n\nYou have indicated that you are interested in receiving information about the following subjects:\n {{#each subscription}} - {{interest}}\n {{/each}} \nYou can change these settings at any time by visiting the Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}" } } ``` **중요** 앞의 코드 예에는 예를 이해하기 쉽도록 `HtmlPart` 및 `TextPart` 속성의 값에 줄 바꿈이 포함되어 있습니다. 템플릿의 JSON 파일에는 이러한 값 내에 줄바꿈이 포함될 수 없습니다. 이 예를 복사하여 자체 JSON 파일에 붙여 넣으면 진행하기 전에 `HtmlPart` 및 `TextPart` 섹션에서 줄 바꿈 및 추가 공백을 제거합니다. 템플릿을 생성한 후 `SendEmail` 또는 `SendBulkEmail` 작업을 사용하여 수신자에게 이 템플릿으로 이메일을 보낼 수 있습니다. 각 수신자가 `Interests` 객체에 최소 하나의 값이 있는 한 항목화된 관심사 목록이 포함되는 이메일을 수신합니다. 다음 예는 앞의 템플릿을 사용하여 여러 수신자에게 이메일을 보내는 데 사용할 수 있는 JSON 템플릿을 보여 줍니다. ``` { "Source":"Sender NameDear {{contact.firstName}},
{{#if subscription}}You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
{{else}}Please update your subscription preferences by visiting
the
Preference Center.
{{/if}}",
"TextPart": "Your Preferences\n\nDear {{contact.firstName}},\n\n
{{#if subscription}}
You have indicated that you are interested in receiving
information about the following subjects:\n
{{#each subscription}}
- {{interest}}\n
{{/each}}
\nYou can change these settings at any time by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{else}}
Please update your subscription preferences by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{/if}}"
}
}
```
**중요**
앞의 코드 예에는 예를 이해하기 쉽도록 `HtmlPart` 및 `TextPart` 속성의 값에 줄 바꿈이 포함되어 있습니다. 템플릿의 JSON 파일에는 이러한 값 내에 줄바꿈이 포함될 수 없습니다. 이 예를 복사하여 자체 JSON 파일에 붙여 넣으면 진행하기 전에 `HtmlPart` 및 `TextPart` 섹션에서 줄 바꿈 및 추가 공백을 제거합니다.
다음 예는 앞의 템플릿을 사용하여 여러 수신자에게 이메일을 보내는 데 사용할 수 있는 JSON 템플릿을 보여 줍니다.
```
{
"Source":"Sender Name You have listed the following people as your friends: This is the HTML part of the message. This is the HTML part of the message.Hello {{> fullName}}!
{{#each friends}}
",
"TextPart": "{{#* inline \"fullName\"}}
{{firstName}}{{#if lastName}} {{lastName}}{{/if}}
{{/inline~}}\n
Hello {{> fullName}}! You have listed the following people
as your friends:\n
{{#each friends}}
- {{> fullName}}\n
{{/each}}"
}
}
```
**중요**
앞의 코드 예에는 예를 이해하기 쉽도록 `HtmlPart` 및 `TextPart` 속성의 값에 줄 바꿈이 포함되어 있습니다. 템플릿의 JSON 파일에는 이러한 값 내에 줄바꿈이 포함될 수 없습니다. 이 예를 복사하여 자체 JSON 파일에 붙여 넣으면 진행하기 전에 이 섹션들에서 줄 바꿈 및 추가 공백을 제거합니다.
# 이메일 템플릿 관리
[이메일 템플릿 만들기](send-personalized-email-api.md) 외에도 Amazon SES v2 API를 사용하여 기존 템플릿을 업데이트 또는 삭제하거나, 기존 템플릿을 모두 나열하거나, 템플릿의 내용을 볼 수도 있습니다.
이 단원에는 AWS CLI 를 사용하여 SES 템플릿과 관련된 작업을 수행하는 절차가 포함되어 있습니다.
**참고**
이 섹션의 절차는 또한 AWS CLI을(를) 이미 설치하여 구성한 상태를 전제로 설명합니다. 설치 및 구성에 대한 자세한 내용은 [AWS Command Line Interface 사용 설명서를](https://docs.aws.amazon.com/cli/latest/userguide/) AWS CLI참조하세요.
## 이메일 템플릿 목록 보기
[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html) SES v2 API 작업을 사용하여 기존의 모든 이메일 템플릿 목록을 볼 수 있습니다.
**이메일 템플릿 목록을 보려면**
+ 명령줄에 다음 명령을 입력합니다.
```
aws sesv2 list-email-templates
```
현재 리전의 SES 계정에 기존 이메일 템플릿이 있는 경우 이 명령은 다음 예제와 유사한 응답을 반환합니다.
```
{
"TemplatesMetadata": [
{
"Name": "SpecialOffers",
"CreatedTimestamp": "2020-08-05T16:04:12.640Z"
},
{
"Name": "NewsAndUpdates",
"CreatedTimestamp": "2019-10-03T20:03:34.574Z"
}
]
}
```
템플릿을 생성하지 않았으면 명령은 멤버 없이 `TemplatesMetadata` 객체를 반환합니다.
## 특정 이메일 템플릿의 내용 보기
[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html) SES v2 API 작업을 사용하여 특정 이메일 템플릿의 내용을 볼 수 있습니다.
**이메일 템플릿의 내용 보기**
+ 명령줄에 다음 명령을 입력합니다.
```
aws sesv2 get-email-template --template-name MyTemplate
```
위의 명령에서 *MyTemplate*을 보려는 템플릿의 이름으로 바꿉니다.
제공한 템플릿 이름이 SES 계정에 있는 템플릿과 일치하는 경우 이 명령은 다음 예와 유사한 응답을 반환합니다.
```
{
"Template": {
"TemplateName": "TestMessage",
"SubjectPart": "Amazon SES Test Message",
"TextPart": "Hello! This is the text part of the message.",
"HtmlPart": "\n\nHello!
\nHello!
\n