Menggunakan template untuk mengirim email yang dipersonalisasi dengan Amazon SES API - Layanan Email Sederhana Amazon
Bagian 1: Siapkan notifikasiBagian 2: Buat templat emailBagian 3: Kirim email yang dipersonalisasi

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 CreateTemplateAPIoperasi untuk membuat template email. Template ini mencakup baris subjek, dan teks dan HTML bagian 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-masing Wilayah AWS.

  • Setiap template dapat berukuran hingga 500 KB, termasuk teks dan HTML bagian-bagiannya.

  • 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, termasuk CC dan BCC penerima. Jumlah tujuan yang dapat Anda hubungi dalam satu panggilan API mungkin dibatasi oleh tarif pengiriman maksimum akun Anda. Untuk informasi selengkapnya, 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 AWS Command Line Interface Pengguna.

Bagian 1: Siapkan notifikasi peristiwa kegagalan rendering

Jika Anda mengirim email yang berisi konten personalisasi yang tidak valid, Amazon SES mungkin menerima pesan tersebut, tetapi tidak dapat mengirimkannya. Untuk alasan ini, jika Anda berencana untuk mengirim email yang dipersonalisasi, Anda harus mengonfigurasi Amazon SES untuk mengirim pemberitahuan peristiwa Kegagalan Rendering melalui AmazonSNS. 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 SNS topik Amazon. Untuk prosedur, lihat Buat Topik di Panduan Developer Amazon Simple Notification Service.

  2. Berlangganan ke SNS topik Amazon. 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 Siapkan tujuan peristiwa Amazon SNS untuk penerbitan peristiwa untuk menyiapkan set konfigurasi Anda untuk memublikasikan peristiwa Kegagalan Rendering ke SNS topik Amazon Anda.

Bagian 2: Buat templat email

Di bagian ini, Anda menggunakan CreateTemplate API operasi 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 AWS Command Line Interface Pengguna.

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- HTML Tubuh email. Properti ini mungkin berisi tanda pengganti.

    • TextPart— Tubuh teks email. Penerima yang klien emailnya tidak menampilkan HTML email 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. Pada baris perintah, ketik perintah berikut untuk membuat template baru menggunakan CreateTemplate API operasi:

    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 API operasi yang dapat Anda gunakan untuk mengirim email menggunakan template:SendTemplatedEmail, danSendBulkTemplatedEmail. SendTemplatedEmailOperasi ini berguna untuk mengirim email yang disesuaikan ke satu tujuan (kumpulan “Kepada,” “CC,” dan "BCC" penerima yang akan menerima email yang sama). SendBulkTemplatedEmailOperasi ini berguna untuk mengirim email unik ke beberapa tujuan dalam satu panggilan ke Amazon SESAPI. Bagian ini memberikan contoh bagaimana 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 <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

      Sebaiknya gunakan set konfigurasi yang dikonfigurasi untuk mempublikasikan peristiwa Kegagalan Rendering ke AmazonSNS. Untuk informasi selengkapnya, 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— JSON String 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 SendBulkTemplatedEmail operasi untuk mengirim email ke beberapa tujuan dalam satu panggilan keAPI. Amazon SES mengirimkan email unik ke penerima atau penerima di setiap Destination objek.

Untuk mengirim email yang ditemplat ke beberapa tujuan

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

      Sebaiknya gunakan set konfigurasi yang dikonfigurasi untuk mempublikasikan peristiwa Kegagalan Rendering ke AmazonSNS. Untuk informasi selengkapnya, 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— JSON Objek yang berisi pasangan kunci-nilai. Kunci sesuai dengan variabel di templat (misalnya, {{name}}). Nilai-nilai menunjukkan konten yang menggantikan variabel di email.

    • DefaultTemplateData— JSON Objek 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 sebuah Destination objek berisi JSON objek kosong di ReplacementTemplateData properti, nilai-nilai dalam DefaultTemplateData properti yang 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