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

1. Buat topik Amazon SNS. Untuk prosedur, lihat Buat Topik di Panduan Developer Amazon Simple Notification Service.

2. 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.

3. 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

1. 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 untuk tagname 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.

2. Sesuaikan contoh sebelumnya sesuai dengan kebutuhan Anda, lalu simpan file sebagai mytemplate.json.

3. 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

1. Di editor teks, buat file baru. Tempel kode berikut ke file.

   {
     "Source":"Mary Major <[e-mail]>",
     "Template": "MyTemplate",
     "ConfigurationSetName": "ConfigSet",
     "Destination": {
       "ToAddresses": [ "[e-mail]"
       ]
     },
     "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.

2. Ubah nilai dalam kode di langkah sebelumnya untuk memenuhi kebutuhan Anda, lalu simpan file sebagai myemail.json.

3. 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

1. Di editor teks, buat file baru. Tempel kode berikut ke file.

   {
     "Source":"Mary Major <[e-mail]>",
     "Template":"MyTemplate",
     "ConfigurationSetName": "ConfigSet",
     "Destinations":[
       {
         "Destination":{
           "ToAddresses":[
             "[e-mail]"
           ]
         },
         "ReplacementTemplateData":"{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }"
       },
       {
         "Destination":{ 
           "ToAddresses":[
             "[e-mail]"
           ]
         },
         "ReplacementTemplateData":"{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }"
       },
       {
         "Destination":{
           "ToAddresses":[
             "[e-mail]"
           ]
         },
         "ReplacementTemplateData":"{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }"
       },
       {
         "Destination":{
           "ToAddresses":[
             "[e-mail]"
           ]
         },
         "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 objek Destination 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 objek Destination berisi sebuah objek JSON kosong di properti ReplacementTemplateData, nilai-nilai di properti DefaultTemplateData digunakan.

2. Ubah nilai dalam kode di langkah sebelumnya untuk memenuhi kebutuhan Anda, lalu simpan file sebagai mybulkemail.json.

3. Di baris perintah, ketik perintah berikut untuk mengirim banyak email:

   aws ses send-bulk-templated-email --cli-input-json file://mybulkemail.json