Your favorite animal is {{favoriteanimal}}.
" } } ``` Kode ini berisi properti berikut: + **TemplateName**— Nama sumber `Template` daya. Ketika Anda mengirim email, Anda merujuk ke nama ini. + **TemplateContent**— Sebuah wadah untuk atribut berikut: + **Subjek** - Baris subjek email. Properti ini mungkin berisi tanda pengganti. Tanda ini menggunakan format berikut: `{{tagname}}`. Ketika Anda mengirim email, Anda dapat menentukan nilai untuk `tagname` untuk setiap tujuan. + **Html—Tubuh** HTML dari email. Properti ini mungkin berisi tanda pengganti. Contoh sebelumnya mencakup dua tanda: `{{name}}` dan `{{favoriteanimal}}`. + **Teks** — Tubuh teks email. Penerima yang klien emailnya tidak menampilkan konten HTML akan melihat versi email ini. Properti ini juga dapat berisi tag pengganti. 1. Sesuaikan contoh sebelumnya sesuai dengan kebutuhan Anda, lalu simpan file sebagai *mytemplate.json*. 1. Pada baris perintah, ketik perintah berikut untuk membuat template baru menggunakan operasi API [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: ``` aws sesv2 create-email-template --cli-input-json file://mytemplate.json ``` ## Bagian 3: Kirim email yang dipersonalisasi Anda dapat menggunakan dua operasi API SES v2 berikut untuk mengirim email menggunakan *templat tersimpan atau templat* *sebaris*: + [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)Operasi ini berguna untuk mengirim email yang disesuaikan ke objek tujuan tunggal. [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html)Objek API v2 dapat berisi *ToAddresses*, *CcAddresses*, dan *BccAddresses*properti. Ini dapat digunakan dalam kombinasi apa pun dan dapat berisi satu atau lebih alamat email yang akan menerima email yang sama. + [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html)Operasi ini berguna untuk mengirim email unik ke beberapa objek tujuan dalam satu panggilan ke API v2. Bagian ini memberikan contoh bagaimana menggunakan AWS CLI untuk mengirim email template menggunakan kedua operasi pengiriman ini. ### Mengirim email template ke objek tujuan tunggal Anda dapat menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)operasi untuk mengirim email ke satu atau beberapa penerima yang ditentukan dalam satu objek tujuan. Semua penerima di objek [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) akan menerima email yang sama. **Untuk mengirim email template ke objek tujuan tunggal** 1. Bergantung pada apakah Anda ingin menggunakan templat *tersimpan atau templat* *sebaris*, pilih contoh kode masing-masing untuk ditempelkan ke editor teks, sesuaikan sesuai kebutuhan. ------ #### [ Stored template code example ] Perhatikan bahwa template yang Anda buat pada langkah sebelumnya *MyTemplate*, sedang direferensikan sebagai nilai untuk `TemplateName` parameter. ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }" } }, "ConfigurationSetName": "ConfigSet" } ``` Kode ini berisi properti berikut: + **FromEmailAddress**— Alamat email pengirim. + **Tujuan** - Objek yang berisi penerima email yang ditentukan dalam *ToAddresses*, *CcAddresses*, dan *BccAddresses*properti. Ini dapat digunakan dalam kombinasi apa pun dan dapat berisi satu atau lebih alamat email yang akan menerima email yang sama. + **TemplateContent**— Sebuah wadah untuk atribut berikut: + **Subjek** - Baris subjek email. Properti ini mungkin berisi tanda pengganti. Tanda ini menggunakan format berikut: `{{tagname}}`. Ketika Anda mengirim email, Anda dapat menentukan nilai untuk `tagname` untuk setiap tujuan. + **Html—Tubuh** HTML dari email. Properti ini mungkin berisi tanda pengganti. Contoh sebelumnya mencakup dua tanda: `{{name}}` dan `{{favoriteanimal}}`. + **Teks** — Tubuh teks email. Penerima yang klien emailnya tidak menampilkan konten HTML akan melihat versi email ini. Properti ini juga dapat berisi tag pengganti. + **TemplateData**— String JSON yang lolos yang berisi pasangan kunci-nilai. Kunci sesuai dengan variabel yang didefinisikan dalam `TemplateContent` properti dalam file ini, misalnya,`{{name}}`. Nilai mewakili konten yang menggantikan variabel. + **ConfigurationSetName**— Nama konfigurasi yang akan digunakan saat mengirim email. **catatan** Kami merekomendasikan bahwa Anda menggunakan satu set konfigurasi yang dikonfigurasi untuk mempublikasikan Rendering kegagalan peristiwa untuk Amazon SNS. Untuk informasi selengkapnya, lihat [(Opsional) Bagian 1: Mengatur pemberitahuan acara Kegagalan Rendering](#send-personalized-email-set-up-notifications). ------ 1. Sesuaikan contoh sebelumnya sesuai dengan kebutuhan Anda, lalu simpan file sebagai *myemail.json*. 1. Pada baris perintah, ketik perintah API v2 berikut untuk mengirim email: ``` aws sesv2 send-email --cli-input-json file://myemail.json ``` ### Mengirim email template ke beberapa objek tujuan Anda dapat menggunakan [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html)operasi untuk mengirim email ke beberapa objek tujuan dalam satu panggilan ke SES v2 API. SES mengirimkan email unik ke penerima atau penerima di setiap [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html)objek. **Untuk mengirim email template ke beberapa objek tujuan** 1. Bergantung pada apakah Anda ingin menggunakan templat *tersimpan atau templat* *sebaris*, pilih contoh kode masing-masing untuk ditempelkan ke editor teks, sesuaikan sesuai kebutuhan. ------ #### [ Stored template code example ] Perhatikan bahwa template yang Anda buat pada langkah sebelumnya *MyTemplate*, sedang direferensikan sebagai nilai untuk `TemplateName` parameter. ``` { "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" } ``` Kode ini berisi properti berikut: + **FromEmailAddress**— Alamat email pengirim. + **DefaultContent**— Sebuah objek JSON yang berisi `TemplateContent` dan `TemplateData` objek. + **TemplateContent**— Sebuah wadah untuk atribut berikut: + **Subjek** - Baris subjek email. Properti ini mungkin berisi tanda pengganti. Tanda ini menggunakan format berikut: `{{tagname}}`. Ketika Anda mengirim email, Anda dapat menentukan nilai untuk `tagname` untuk setiap tujuan. + **Html—Tubuh** HTML dari email. Properti ini mungkin berisi tanda pengganti. Contoh sebelumnya mencakup dua tanda: `{{name}}` dan `{{favoriteanimal}}`. + **Teks** — Tubuh teks email. Penerima yang klien emailnya tidak menampilkan konten HTML akan melihat versi email ini. Properti ini juga dapat berisi tag pengganti. + **TemplateData**— Berisi pasangan kunci-nilai yang akan digunakan jika `ReplacementEmailContent` objek berisi objek JSON kosong,`{}`, di properti. `ReplacementTemplateData` + **BulkEmailEntries**— Array yang berisi satu atau lebih `Destination` objek. + **Tujuan** - Objek yang berisi penerima email yang ditentukan dalam *ToAddresses*, *CcAddresses*, dan *BccAddresses*properti. Ini dapat digunakan dalam kombinasi apa pun dan dapat berisi satu atau lebih alamat email yang akan menerima email yang sama. + **ReplacementTemplateData**— String JSON yang lolos yang berisi pasangan kunci-nilai. Kunci sesuai dengan variabel yang didefinisikan dalam `TemplateContent` properti dalam file ini, misalnya,`{{name}}`. Nilai-nilai menunjukkan konten yang menggantikan variabel di email. (Jika string JSON di sini kosong, ditunjukkan oleh`{}`, pasangan kunci-nilai didefinisikan dalam `TemplateData` properti dalam `DefaultContent` objek akan digunakan.) + **ConfigurationSetName**— Nama konfigurasi yang akan digunakan saat mengirim email. **catatan** Kami merekomendasikan bahwa Anda menggunakan satu set konfigurasi yang dikonfigurasi untuk mempublikasikan Rendering kegagalan peristiwa untuk Amazon SNS. Untuk informasi selengkapnya, lihat [(Opsional) Bagian 1: Mengatur pemberitahuan acara Kegagalan Rendering](#send-personalized-email-set-up-notifications). ------ 1. Ubah nilai dalam kode di langkah sebelumnya untuk memenuhi kebutuhan Anda, lalu simpan file sebagai *mybulkemail.json*. 1. Pada baris perintah, ketik perintah API v2 berikut untuk mengirim email massal: ``` aws sesv2 send-bulk-email --cli-input-json file://mybulkemail.json ``` # Personalisasi email lanjutan Jika Anda menggunakan *template tersimpan*, yaitu, Anda telah membuat [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html)sumber daya di Amazon SES dengan menggunakan `CreateEmailTemplate` operasi dengan SES v2 API, Anda dapat memanfaatkan sistem Handlebars untuk membuat templat yang menyertakan fitur lanjutan, seperti atribut bersarang, iterasi array, pernyataan kondisional dasar, dan pembuatan paral sebaris. Bagian ini menyediakan contoh fitur ini. Handlebar mencakup fitur tambahan di luar yang didokumentasikan di bagian ini. Untuk informasi lebih lanjut, lihat [Bantuan Bawaan](https://handlebarsjs.com/guide/builtin-helpers.html) di [handlebarsjs.com](http://handlebarsjs.com). **catatan** SES tidak luput dari konten HTML saat merender template HTML untuk pesan. Ini berarti jika Anda menyertakan data yang dimasukkan pengguna, seperti dari formulir kontak, Anda harus menghindarinya di sisi klien. **Topics** + [ ## Menguraikan atribut yang di-nest ](#send-personalized-email-advanced-nested) + [ ## Pengulangan melalui daftar ](#send-personalized-email-advanced-iterating) + [ ## Menggunakan pernyataan persyaratan dasar ](#send-personalized-email-advanced-conditionals) + [ ## Membuat parsial inline ](#send-personalized-email-advanced-inline-partials) ## Menguraikan atribut yang di-nest Handlebar mencakup dukungan untuk jalur yang di-nest sehingga mempermudah pengaturan data pelanggan yang rumit, dan kemudian data tersebut dapat dirujuk di templat email Anda. Misalnya, Anda dapat mengatur data penerima ke dalam beberapa kategori umum. Dalam setiap kategori tersebut, Anda dapat menyertakan informasi detail. Contoh kode berikut menunjukkan contoh struktur untuk satu penerima: ``` { "meta":{ "userId":"51806220607" }, "contact":{ "firstName":"Anaya", "lastName":"Iyengar", "city":"Bengaluru", "country":"India", "postalCode":"560052" }, "subscription":[ { "interest":"Sports" }, { "interest":"Travel" }, { "interest":"Cooking" } ] } ``` Di templat email, Anda dapat merujuk ke atribut yang di-nest dengan memberikan nama atribut induk, diikuti oleh titik (.), diikuti dengan nama atribut yang Anda ingin sertakan nilainya. Misalnya, jika Anda menggunakan struktur data yang ditampilkan di contoh sebelumnya, dan Anda ingin menyertakan nama depan setiap penerima di templat email, masukkan teks berikut di templat email Anda: `Hello {{contact.firstName}}!` Handlebar dapat mengurai jalur yang di-nest beberapa tingkat, yang berarti Anda memiliki fleksibilitas dalam penyusunan data templat. ## Pengulangan melalui daftar Fungsi bantuan `each` mengulang melalui item di array. Kode berikut adalah contoh templat email yang menggunakan fungsi bantuan `each` untuk membuat daftar terperinci dari setiap kepentingan penerima. ``` { "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}}" } } ``` **penting** Di contoh kode sebelumnya, nilai-nilai atribut `HtmlPart` dan `TextPart` memiliki jeda baris agar contoh lebih mudah dibaca. File JSON untuk templat Anda tidak dapat berisi jeda baris dalam nilai-nilai ini. Jika Anda menyalin dan menempel contoh ini ke file JSON Anda sendiri, hapus jeda baris dan spasi ekstra dari bagian `HtmlPart` dan `TextPart` sebelum melanjutkan. Setelah Anda membuat templat, Anda dapat menggunakan operasi `SendEmail` atau `SendBulkEmail` untuk mengirim email ke penerima menggunakan templat ini. Selama setiap penerima memiliki setidaknya satu nilai di objek `Interests`, penerima menerima email yang berisi daftar kepentingan terperinci mereka. Contoh berikut menunjukkan file JSON yang dapat digunakan untuk mengirim email ke beberapa penerima menggunakan templat sebelumnya: ``` { "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}}"
}
}
```
**penting**
Di contoh kode sebelumnya, nilai-nilai atribut `HtmlPart` dan `TextPart` memiliki jeda baris agar contoh lebih mudah dibaca. File JSON untuk templat Anda tidak dapat berisi jeda baris dalam nilai-nilai ini. Jika Anda menyalin dan menempel contoh ini ke file JSON Anda sendiri, hapus jeda baris dan spasi ekstra dari bagian `HtmlPart` dan `TextPart` sebelum melanjutkan.
Contoh berikut menunjukkan file JSON yang dapat digunakan untuk mengirim email ke beberapa penerima menggunakan templat sebelumnya:
```
{
"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}}"
}
}
```
**penting**
Di contoh kode sebelumnya, nilai-nilai atribut `HtmlPart` dan `TextPart` memiliki jeda baris agar contoh lebih mudah dibaca. File JSON untuk templat Anda tidak dapat berisi jeda baris dalam nilai-nilai ini. Jika Anda menyalin dan menempel contoh ini ke file JSON Anda sendiri, hapus jeda baris dan spasi ekstra dari bagian ini.
# Mengelola templat email
Selain [membuat template email](send-personalized-email-api.md), Anda juga dapat menggunakan Amazon SES v2 API untuk memperbarui atau menghapus template yang ada, untuk daftar semua template yang ada, atau untuk melihat konten template.
Bagian ini berisi prosedur untuk menggunakan AWS CLI untuk melakukan tugas-tugas yang terkait dengan template SES.
**catatan**
Prosedur di bagian ini menganggap bahwa Anda telah menginstal dan mengonfigurasi AWS CLI. Untuk informasi selengkapnya tentang menginstal dan mengonfigurasi AWS CLI, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/).
## Melihat daftar templat email
Anda dapat menggunakan operasi [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 untuk melihat daftar semua template email yang ada.
**Untuk melihat daftar templat email**
+ Di baris perintah, masukkan perintah berikut:
```
aws sesv2 list-email-templates
```
Jika ada template email yang ada di akun SES Anda di Wilayah saat ini, perintah ini mengembalikan respons yang menyerupai contoh berikut:
```
{
"TemplatesMetadata": [
{
"Name": "SpecialOffers",
"CreatedTimestamp": "2020-08-05T16:04:12.640Z"
},
{
"Name": "NewsAndUpdates",
"CreatedTimestamp": "2019-10-03T20:03:34.574Z"
}
]
}
```
Jika Anda belum membuat templat apa pun, perintah tersebut mengembalikan objek `TemplatesMetadata` dengan tanpa anggota.
## Melihat konten templat email tertentu
Anda dapat menggunakan operasi [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 untuk melihat konten template email tertentu.
**Untuk melihat konten templat email**
+ Di baris perintah, masukkan perintah berikut:
```
aws sesv2 get-email-template --template-name MyTemplate
```
Pada perintah sebelumnya, ganti *MyTemplate* dengan nama template yang ingin Anda lihat.
Jika nama template yang Anda berikan cocok dengan template yang ada di akun SES Anda, perintah ini mengembalikan respons yang menyerupai contoh berikut:
```
{
"Template": {
"TemplateName": "TestMessage",
"SubjectPart": "Amazon SES Test Message",
"TextPart": "Hello! This is the text part of the message.",
"HtmlPart": "\n\nHello!
\nHello!
\n