Langkah 3: Tentukan set konfigurasi saat Anda mengirim email - Layanan Email Sederhana Amazon
Menggunakan Parameter API Amazon SESMenggunakan Header Email Khusus Amazon SESMenggunakan Header Email Kustom

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Langkah 3: Tentukan set konfigurasi saat Anda mengirim email

Setelah Anda buat satu set konfigurasi dan tambahkan tujuan peristiwa, langkah terakhir untuk penerbitan peristiwa adalah dengan mengirim email Anda.

Untuk menerbitkan peristiwa yang terkait dengan email, Anda harus menyediakan nama konfigurasi yang diatur untuk dikaitkan dengan email. Secara opsional, Anda dapat memberikan tanda pesan untuk mengategorikan email.

Anda menyediakan informasi ini ke Amazon SES sebagai parameter untuk API pengiriman email, header email khusus Amazon SES, atau header kustom dalam pesan MIME Anda. Metode yang Anda pilih tergantung pada antarmuka pengiriman email yang Anda gunakan, seperti yang ditunjukkan pada tabel berikut.

Antarmuka Pengiriman Email Cara Menerbitkan Peristiwa

SendEmail

Parameter API:

SendTemplatedEmail

Parameter API:

SendBulkTemplatedEmail

Parameter API:

SendCustomVerificationEmail

Parameter API:

SendRawEmail

Parameter API, header email khusus Amazon SES, atau header MIME kustom

penting

Jika Anda menentukan tanda pesan menggunakan header dan parameter API, Amazon SES hanya menggunakan tanda pesan yang disediakan oleh parameter API. Amazon SES tidak menggabungkan tanda pesan yang ditentukan oleh parameter dan header API.

Antarmuka SMTP

Header email khusus Amazon SES

Bagian berikut menjelaskan cara menentukan set konfigurasi dan tanda pesan menggunakan header dan menggunakan parameter API.

catatan

Anda dapat secara opsional menyertakan tanda pesan di header email Anda. Tanda pesan dapat mencakup angka 0–9, huruf A–Z (huruf besar dan kecil), tanda hubung (-), dan garis bawah (_).

Menggunakan Parameter API Amazon SES

Untuk menggunakan SendEmail, SendTemplatedEmail, SendBulkTemplatedEmail, SendCustomVerificationEmail, atau SendRawEmaildengan penerbitan peristiwa, Anda menentukan set konfigurasi dan tag pesan dengan meneruskan struktur data yang dipanggil ConfigurationSetdan MessageTagke panggilan API.

Untuk informasi selengkapnya tentang cara menggunakan API Amazon SES, lihat Referensi API Amazon Simple Email Service.

Menggunakan Header Email Khusus Amazon SES

Saat Anda menggunakan SendRawEmail atau antarmuka SMTP, Anda dapat menentukan set konfigurasi dan tanda pesan dengan menambahkan header khusus Amazon SES ke email. Amazon SES menghapus header sebelum mengirim email. Tabel berikut menunjukkan nama-nama header yang akan digunakan.

Informasi Penerbitan Peristiwa Header

Set konfigurasi

X-SES-CONFIGURATION-SET

Tanda pesan

X-SES-MESSAGE-TAGS

Contoh berikut menunjukkan bagaimana header dapat terlihat dalam email mentah yang Anda kirimkan ke Amazon SES.

X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2
X-SES-CONFIGURATION-SET: myConfigurationSet
From: sender@example.com
To: recipient@example.com
Subject: Subject
Content-Type: multipart/alternative;
	boundary="----=_boundary"

------=_boundary
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit

body
------=_boundary
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit

body
------=_boundary--

Menggunakan Header Email Kustom

Meskipun Anda harus menentukan nama set konfigurasi menggunakan header khusus Amazon SES X-SES-CONFIGURATION-SET, Anda dapat menentukan tanda pesan dengan menggunakan header MIME Anda sendiri.

catatan

Nama dan nilai header yang Anda gunakan untuk penerbitan peristiwa Amazon SES harus dalam ASCII. Jika Anda menentukan nama atau nilai header non-ASCII untuk penerbitan peristiwa Amazon SES, maka panggilan pengiriman email akan tetap berhasil, tetapi metrik peristiwa tidak akan dipancarkan ke Amazon. CloudWatch