View a markdown version of this page

Menggunakan template untuk mengirim email yang dipersonalisasi dengan Amazon SES API - Layanan Email Sederhana Amazon
(Opsional) Bagian 1: Siapkan notifikasi(Opsional) Bagian 2: Buat template 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

Di Amazon SES Anda dapat mengirim email templat baik dengan menggunakan templat yang disimpan atau dengan menggunakan template sebaris.

  • Template tersimpan — Meng Template acu pada sumber daya yang dibuat dan disimpan di SES dengan menggunakan CreateEmailTemplate operasi di Amazon SES v2 API. Template berisi subjek dan badan email yang berisi variabel (placeholder) sejalan dengan konten tertulis. Nama template yang disimpan dan data dinamis ke variabel placeholder dalam template disediakan saat memanggil operasi API SendEmail atau SendBulkEmail v2.

    Template yang disimpan dapat dengan mudah digunakan kembali dan dapat menghemat waktu dan tenaga Anda saat mengirim jenis email serupa. Alih-alih membuat setiap email dari awal, Anda hanya perlu membuat struktur dasar dan desain sekali, lalu cukup memperbarui konten dinamis dalam template.

  • Template sebaris — Sumber Template daya tidak digunakan, melainkan subjek dan isi email yang berisi variabel (placeholder) sebaris dengan konten tertulis bersama dengan nilai untuk variabel placeholder tersebut disediakan saat memanggil operasi API SendEmail atau SendBulkEmail v2.

    Template sebaris merampingkan proses pengiriman email massal dengan menghilangkan kebutuhan untuk mengelola sumber daya template di akun SES Anda dan menyederhanakan proses integrasi dengan memungkinkan Anda memasukkan konten template secara langsung ke dalam logika aplikasi Anda. Mereka tidak dihitung terhadap batas 20.000 template per. Wilayah AWS

Batas berikut berlaku saat menggunakan templ at yang disimpan:

  • Anda dapat membuat hingga 20.000 template email di masing-masing Wilayah AWS.

  • Setiap templat dapat berukuran hingga 500KB, termasuk bagian teks dan HTML.

Batas berikut berlaku saat menggunakan template sebaris:

  • Setiap masukan file JSON dapat berukuran hingga 1 MB, termasuk bagian teks dan HTML.

Berikut ini berlaku untuk templat tersimpan dan sebaris:

  • Tidak ada batasan jumlah variabel pengganti yang dapat digunakan.

  • Anda dapat mengirim email ke hingga 50 objek tujuan dalam setiap panggilan ke SendBulkEmail operasi. Ob Destination jek dapat berisi beberapa penerima yang ditentukan dalam ToAddresses, CcAddresses, dan BccAddresses. Jumlah tujuan yang dapat Anda hubungi dalam satu panggilan ke v2 API mungkin dibatasi oleh tingkat pengiriman maksimum akun Anda. Untuk informasi selengkapnya, lihat Mengelola batas pengiriman Amazon SES Anda.

Bab ini mencakup prosedur dengan contoh untuk menggunakan templat yang disimpan dan templ at sebaris.

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.

(Opsional) Bagian 1: Mengatur pemberitahuan peristiwa Rendering Failure

Jika Anda mengirim email berisi konten personalisasi yang tidak valid, Amazon SES mungkin menerima pesan tersebut, namun tidak dapat mengirimkannya. Untuk alasan ini, jika Anda berencana mengirim email yang dipersonalisasi, Anda harus mengonfigurasi SES untuk mengirim pemberitahuan peristiwa Rendering Failure 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.

(Opsional) Bagian 2: Buat template email

Jika Anda berniat menggunakan template yang disimpan, bagian ini akan menunjukkan cara menggunakan operasi API CreateEmailTemplate SES v2 untuk membuat template. Anda dapat melewati langkah ini jika Anda ingin menggunakan template inline.

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 dan tempel kode berikut yang menyesuaikannya sesuai kebutuhan.

    {
    "TemplateName": "MyTemplate",
    "TemplateContent": {
        "Subject": "Greetings, {{name}}!",
        "Text": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}.",
        "Html": "<h1>Hello {{name}},</h1><p>Your favorite animal is {{favoriteanimal}}.</p>"
    }
}

    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:

      • Sub jek — 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 — Badan HTML dari email. Properti ini mungkin berisi tanda pengganti. Contoh sebelumnya mencakup dua tanda: {{name}} dan {{favoriteanimal}}.

      • Tek s — Badan teks email. Penerima yang klien emailnya tidak menampilkan konten HTML akan melihat versi email ini. Properti ini mungkin juga berisi tag 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 operasi API CreateEmailTemplate 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 yang disimpan atau templat sebaris:

  • SendEmailOperasi ini berguna untuk mengirim email yang disesuaikan ke objek tujuan tunggal. Ob Destination jek API v2 dapat berisi ToAddresses properti CcAddresses,, dan BccAddresses. Ini dapat digunakan dalam kombinasi apa pun dan dapat berisi satu atau lebih alamat email yang akan menerima email yang sama.

  • SendBulkEmailOperasi ini berguna untuk mengirim email unik ke beberapa objek tujuan dalam satu panggilan ke v2 API.

Bagian ini memberikan contoh cara menggunakan AWS CLI untuk mengirim email templat menggunakan kedua operasi pengiriman ini.

Mengirim email templat ke objek tujuan tunggal

Anda dapat menggunakan SendEmail operasi untuk mengirim email ke satu atau lebih penerima yang ditentukan dalam objek tujuan tunggal. Semua penerima di objek Destination akan menerima email yang sama.

Untuk mengirim email templat ke objek tujuan tunggal

  1. Bergantung pada apakah Anda ingin menggunakan templat yang disimpan atau template 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 Major <mary.major@example.com>",
    "Destination": {
        "ToAddresses": [
            "alejandro.rosalez@example.com", "jimmy.jet@example.com"
        ]
    },
    "Content": {
        "Template": {
            "TemplateName": "MyTemplate",
            "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 properti CcAddresses,, dan BccAddresses. Ini dapat digunakan dalam kombinasi apa pun dan dapat berisi satu atau lebih alamat email yang akan menerima email yang sama.

    • TemplateName— Nama sumber Template daya yang akan diterapkan ke email.

    • TemplateData— String JSON yang lolos yang berisi pasangan kunci-nilai. Kunci sesuai dengan variabel yang ditentukan dalam TemplateContent properti dalam template yang disimpan, misalnya,{{name}}. Nilai-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 peristiwa Rendering Failure.

    Inline template code example

    Perhatikan bahwa TemplateContent properti (yang biasanya akan didefinisikan dalam template yang disimpan), sedang didefinisikan sebaris bersama dengan TemplateData properti yang menjadikannya template sebaris.

    {
    "FromEmailAddress": "Mary Major <mary.major@example.com>",
    "Destination": {
        "ToAddresses": [
            "alejandro.rosalez@example.com", "jimmy.jet@example.com"
        ]
    },
    "Content": {
        "Template": {
            "TemplateContent": {
                "Subject": "Greetings, {{name}}!",
                "Text": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}.",
                "Html": "<h1>Hello {{name}},</h1><p>Your favorite animal is {{favoriteanimal}}.</p>"
            },
            "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 properti CcAddresses,, dan BccAddresses. 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:

      • Sub jek — 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 — Badan HTML dari email. Properti ini mungkin berisi tanda pengganti. Contoh sebelumnya mencakup dua tanda: {{name}} dan {{favoriteanimal}}.

      • Tek s — Badan teks email. Penerima yang klien emailnya tidak menampilkan konten HTML akan melihat versi email ini. Properti ini mungkin juga 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-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 peristiwa Rendering Failure.

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

  3. Pada baris perintah, ketik perintah v2 API berikut untuk mengirim email:

    aws sesv2 send-email --cli-input-json file://myemail.json

Mengirim email templat ke beberapa objek tujuan

Anda dapat menggunakan SendBulkEmail 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 Destination objek.

Untuk mengirim email templat ke beberapa objek tujuan

  1. Bergantung pada apakah Anda ingin menggunakan templat yang disimpan atau template 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 Major <mary.major@example.com>",
    "DefaultContent": {
        "Template": {
            "TemplateName": "MyTemplate",
            "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— Objek JSON yang berisi TemplateData objek TemplateName dan.

    • TemplateName— Nama sumber Template daya yang akan diterapkan ke email.

    • TemplateData— Berisi pasangan kunci-nilai yang akan digunakan jika ReplacementEmailContent objek berisi objek JSON kosong,{}, di ReplacementTemplateData properti.

    • BulkEmailEntries— Array yang berisi satu atau lebih Destination objek.

    • Tujuan — Objek yang berisi penerima email yang ditentukan dalam ToAddresses properti CcAddresses,, dan BccAddresses. 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 dalam template, misalnya,{{name}}. Nilai-nilai menunjukkan konten yang menggantikan variabel di email. (Jika string JSON di sini kosong, ditunjukkan oleh{}, pasangan kunci-nilai yang ditentukan dalam TemplateData properti di 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 peristiwa Rendering Failure.

    Inline template code example

    Perhatikan bahwa TemplateContent properti (yang biasanya akan didefinisikan dalam template yang disimpan), sedang didefinisikan sebaris bersama dengan TemplateData properti yang menjadikannya template sebaris.

    {
    "FromEmailAddress": "Mary Major <mary.major@example.com>",
    "DefaultContent": {
        "Template": {
            "TemplateContent": {
                "Subject": "Greetings, {{name}}!",
                "Text": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}.",
                "Html": "<h1>Hello {{name}},</h1><p>Your favorite animal is {{favoriteanimal}}.</p>"
            },
            "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— Objek JSON yang berisi TemplateData objek TemplateContent dan.

    • TemplateContent— Sebuah wadah untuk atribut berikut:

      • Sub jek — 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 — Badan HTML dari email. Properti ini mungkin berisi tanda pengganti. Contoh sebelumnya mencakup dua tanda: {{name}} dan {{favoriteanimal}}.

      • Tek s — Badan teks email. Penerima yang klien emailnya tidak menampilkan konten HTML akan melihat versi email ini. Properti ini mungkin juga berisi tag pengganti.

    • TemplateData— Berisi pasangan kunci-nilai yang akan digunakan jika ReplacementEmailContent objek berisi objek JSON kosong,{}, di ReplacementTemplateData properti.

    • BulkEmailEntries— Array yang berisi satu atau lebih Destination objek.

    • Tujuan — Objek yang berisi penerima email yang ditentukan dalam ToAddresses properti CcAddresses,, dan BccAddresses. 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 yang ditentukan dalam TemplateData properti di 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 peristiwa Rendering Failure.

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

  3. Pada baris perintah, ketik perintah v2 API berikut untuk mengirim email massal:

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