Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menggunakan template untuk mengirim email yang dipersonalisasi dengan Amazon SES API
Anda dapat menggunakan operasi CreateTemplateAPI untuk membuat template email. Templat ini mencakup baris subjek, serta bagian teks dan HTML dari badan email. Bagian subjek dan badan juga dapat berisi nilai unik yang dipersonalisasi untuk setiap penerima.
Ada beberapa batasan dan pertimbangan lainnya saat menggunakan fitur ini:
-
Anda dapat membuat hingga 20.000 template email di masing-masingWilayah AWS.
-
Setiap templat dapat berukuran hingga 500KB, termasuk bagian teks dan HTML.
-
Anda dapat menyertakan jumlah variabel pengganti yang tidak terbatas di setiap templat.
-
Anda dapat mengirim email ke hingga 50 tujuan di setiap panggilan ke operasi
SendBulkTemplatedEmail
. Tujuan mencakup daftar penerima, serta penerima CC dan BCC. Jumlah tujuan yang dapat Anda kontak dalam satu panggilan ke API mungkin dibatasi oleh laju pengiriman maksimum akun Anda. Untuk informasi lebih lanjut, lihat Mengelola batas pengiriman Amazon SES Anda.
Bagian ini mencakup prosedur untuk membuat templat email dan untuk mengirim email yang dipersonalisasi.
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 Pengguna AWS Command Line Interface.
Bagian 1: Siapkan notifikasi peristiwa kegagalan rendering
Jika Anda mengirim email berisi konten personalisasi yang tidak valid, Amazon SES mungkin menerima pesan tersebut, namun tidak dapat mengirimkannya. Karena alasan ini, jika Anda berencana untuk mengirim email yang dipersonalisasi, Anda harus mengonfigurasi Amazon SES untuk mengirim notifikasi peristiwa Rendering Gagal melalui Amazon SNS. Ketika Anda menerima notifikasi peristiwa Kegagalan Rendering, Anda dapat mengidentifikasi pesan yang berisi konten yang tidak valid, memperbaiki masalah, dan mengirim pesan kembali.
Prosedur di bagian ini bersifat opsional, namun sangat disarankan.
Untuk mengonfigurasi notifikasi peristiwa Kegagalan Rendering
-
Buat topik Amazon SNS. Untuk prosedur, lihat Buat Topik di Panduan Developer Amazon Simple Notification Service.
-
Langganan topik Amazon SNS. Misalnya, jika Anda ingin menerima notifikasi Kegagalan Rendering melalui email, berlangganan titik akhir email (yaitu, alamat email Anda) ke topik tersebut.
Untuk prosedur, lihat Berlangganan Topik di Panduan Developer Amazon Simple Notification Service.
-
Selesaikan prosedur di Siapkan tujuan peristiwa Amazon SNS untuk penerbitan peristiwa untuk menyiapkan set konfigurasi Anda untuk mempublikasikan peristiwa Kegagalan Rendering ke topik Amazon SNS Anda.
Bagian 2: Buat templat email
Di bagian ini, Anda menggunakan operasi CreateTemplate API untuk membuat template email baru dengan atribut personalisasi.
Prosedur ini menganggap Anda telah menginstal dan mengonfigurasi AWS CLI. Untuk informasi selengkapnya tentang menginstal dan mengonfigurasi AWS CLI, lihat Panduan Pengguna AWS Command Line Interface.
Untuk membuat templat
-
Di editor teks, buat file baru. Tempel kode berikut ke file.
{ "Template": { "TemplateName": "MyTemplate", "SubjectPart": "Greetings, {{name}}!", "HtmlPart": "<h1>Hello {{name}},</h1><p>Your favorite animal is {{favoriteanimal}}.</p>", "TextPart": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}." } }
Kode ini berisi properti berikut:
-
TemplateName— Nama template. Ketika Anda mengirim email, Anda merujuk ke nama ini.
-
SubjectPart— Baris subjek email. Properti ini mungkin berisi tanda pengganti. Tanda ini menggunakan format berikut:
{{tagname}}
. Ketika Anda mengirim email, Anda dapat menentukan nilai untuktagname
untuk setiap tujuan.Contoh sebelumnya mencakup dua tanda:
{{name}}
dan{{favoriteanimal}}
. -
HtmlPart- Tubuh HTML email. Properti ini mungkin berisi tanda pengganti.
-
TextPart- Tubuh teks email. Penerima yang klien emailnya tidak menampilkan email HTML akan melihat versi email ini. Properti ini mungkin berisi tanda pengganti.
-
-
Sesuaikan contoh sebelumnya sesuai dengan kebutuhan Anda, lalu simpan file sebagai
mytemplate.json
. -
Di baris perintah, ketik perintah berikut untuk membuat templat baru menggunakan perintah operasi API
CreateTemplate
:aws ses create-template --cli-input-json file://mytemplate.json
Bagian 3: Kirim email yang dipersonalisasi
Setelah membuat templat email, Anda dapat menggunakannya untuk mengirim email. Ada dua operasi API yang dapat Anda gunakan untuk mengirim email menggunakan templat: SendTemplatedEmail
, dan SendBulkTemplatedEmail
. Operasi SendTemplatedEmail
berguna untuk mengirim email yang disesuaikan ke tujuan tunggal (penerima "Kepada," "CC," dan "BCC" yang akan menerima email yang sama). Operasi SendBulkTemplatedEmail
berguna untuk mengirim email yang unik ke beberapa tujuan dalam satu panggilan ke API Amazon SES. Bagian ini menyediakan contoh cara menggunakan AWS CLI untuk mengirim email menggunakan kedua operasi ini.
Mengirim email yang ditemplat ke satu tujuan
Anda dapat menggunakan operasi SendTemplatedEmail
untuk mengirim email ke satu tujuan. Semua penerima di objek Destination
akan menerima email yang sama.
Untuk mengirim email yang ditemplat ke satu tujuan
-
Di editor teks, buat file baru. Tempel kode berikut ke file.
{ "Source":"Mary Major <mary.major@example.com>", "Template": "MyTemplate", "ConfigurationSetName": "ConfigSet", "Destination": { "ToAddresses": [ "alejandro.rosalez@example.com" ] }, "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }" }
Kode ini berisi properti berikut:
-
Sumber – Alamat email pengirim.
-
Templat – Nama templat yang akan diterapkan ke email.
-
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 lebih lanjut, lihat Bagian 1: Siapkan notifikasi peristiwa kegagalan rendering.
-
Tujuan – Alamat penerima. Anda dapat menyertakan beberapa alamat "Kepada", "CC," dan "BCC". Saat Anda menggunakan operasi
SendTemplatedEmail
, semua penerima menerima email yang sama. -
TemplateData- String JSON yang lolos yang berisi pasangan kunci-nilai. Kunci sesuai dengan variabel di templat (misalnya,
{{name}}
). Nilai-nilai menunjukkan konten yang menggantikan variabel di email.
-
-
Ubah nilai dalam kode di langkah sebelumnya untuk memenuhi kebutuhan Anda, lalu simpan file sebagai
myemail.json
. -
Di baris perintah, ketik perintah berikut untuk mengirim email:
aws ses send-templated-email --cli-input-json file://myemail.json
Mengirim email yang ditemplat ke beberapa tujuan
Anda dapat menggunakan operasi SendBulkTemplatedEmail
untuk mengirim email ke beberapa tujuan dalam satu panggilan ke API. Amazon SES mengirimkan email yang unik ke satu atau beberapa penerima di setiap objek Destination
.
Untuk mengirim email yang ditemplat ke beberapa tujuan
-
Di editor teks, buat file baru. Tempel kode berikut ke file.
{ "Source":"Mary Major <mary.major@example.com>", "Template":"MyTemplate", "ConfigurationSetName": "ConfigSet", "Destinations":[ { "Destination":{ "ToAddresses":[ "anaya.iyengar@example.com" ] }, "ReplacementTemplateData":"{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }" }, { "Destination":{ "ToAddresses":[ "liu.jie@example.com" ] }, "ReplacementTemplateData":"{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }" }, { "Destination":{ "ToAddresses":[ "shirley.rodriguez@example.com" ] }, "ReplacementTemplateData":"{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }" }, { "Destination":{ "ToAddresses":[ "richard.roe@example.com" ] }, "ReplacementTemplateData":"{}" } ], "DefaultTemplateData":"{ \"name\":\"friend\", \"favoriteanimal\":\"unknown\" }" }
Kode ini berisi properti berikut:
-
Sumber – Alamat email pengirim.
-
Templat – Nama templat yang akan diterapkan ke email.
-
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 lebih lanjut, lihat Bagian 1: Siapkan notifikasi peristiwa kegagalan rendering.
-
Tujuan – Array yang berisi satu Tujuan atau lebih.
-
Tujuan – Alamat penerima. Anda dapat menyertakan beberapa alamat "Kepada", "CC," dan "BCC". Saat Anda menggunakan operasi
SendBulkTemplatedEmail
, semua penerima di dalam objekDestination
yang sama menerima email yang sama. -
ReplacementTemplateData- Sebuah objek JSON yang berisi pasangan kunci-nilai. Kunci sesuai dengan variabel di templat (misalnya,
{{name}}
). Nilai-nilai menunjukkan konten yang menggantikan variabel di email.
-
-
DefaultTemplateData- Sebuah objek JSON yang berisi pasangan kunci-nilai. Kunci sesuai dengan variabel di templat (misalnya,
{{name}}
). Nilai-nilai menunjukkan konten yang menggantikan variabel di email. Objek ini berisi data fallback. Jika objekDestination
berisi sebuah objek JSON kosong di propertiReplacementTemplateData
, nilai-nilai di propertiDefaultTemplateData
digunakan.
-
-
Ubah nilai dalam kode di langkah sebelumnya untuk memenuhi kebutuhan Anda, lalu simpan file sebagai
mybulkemail.json
. -
Di baris perintah, ketik perintah berikut untuk mengirim banyak email:
aws ses send-bulk-templated-email --cli-input-json file://mybulkemail.json