Format email dan Amazon SES

Ketika klien membuat permintaan ke Amazon SES, Amazon SES membangun pesan email yang patuh dengan spesifikasi Format Pesan Internet (RFC 5322). Email terdiri dari header, isi, dan envelope, seperti yang dijelaskan di bawah ini.

• Header—Berisi petunjuk perutean dan informasi tentang pesan. Contohnya adalah alamat pengirim, alamat penerima, subjek, dan tanggal. Header analog dengan informasi di bagian atas surat pos, meskipun dapat berisi banyak tipe informasi lainnya, seperti format pesan.

• Isi—Berisi teks pesan itu sendiri.

• Envelope—Berisi informasi perutean aktual yang dikomunikasikan antara klien email dan server surat selama sesi SMTP. Informasi envelope email ini analog dengan informasi pada envelope pos. Informasi perutean dari envelope email biasanya sama dengan informasi perutean di header email, tetapi tidak selalu. Misalnya, ketika Anda mengirim salinan tembusan (BCC), alamat penerima sebenarnya (berasal dari envelope) tidak sama dengan alamat "Kepada" yang ditampilkan di klien email penerima, yang berasal dari header.

Berikut ini adalah contoh sederhana dari email. Header diikuti oleh baris kosong lalu isi email. Envelope tidak ditampilkan karena dikomunikasikan antara klien dan server surat selama sesi SMTP, bukan bagian dari email itu sendiri.

Received: from abc.smtp-out.amazonses.com (123.45.67.89) by in.example.com (87.65.43.210); Fri, 17 Dec 2010 14:26:22
From: "Andrew" <[e-mail]>;
To: "Bob" <[e-mail]>
Date: Fri, 17 Dec 2010 14:26:21 -0800
Subject: Hello
Message-ID: <[e-mail]>
Accept-Language: en-US
Content-Language: en-US
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0

Hello, I hope you are having a good day.

-Andrew
	

Bagian berikut meninjau header dan isi email dan mengidentifikasi informasi yang Anda perlu berikan ketika Anda menggunakan Amazon SES.

Header email

Ada satu header per pesan email. Setiap baris header berisi bidang diikuti oleh titik dua yang diikuti oleh badan bidang. Ketika Anda membaca email di klien email, klien email biasanya menampilkan nilai-nilai bidang header berikut:

• Kepada—Alamat email penerima pesan.

• CC—Alamat email penerima tembusan pesan.

• Dari—Alamat email dari tempat email dikirim.

• Subjek—Ringkasan topik pesan.

• Tanggal—Waktu dan tanggal email dikirim.

Ada banyak bidang header tambahan yang menyediakan informasi perutean dan menjelaskan isi dari pesan. Klien email biasanya tidak menampilkan bidang ini ke pengguna. Untuk daftar lengkap bidang header yang diterima Amazon SES, lihat Bidang header Amazon SES. Bila Anda menggunakan Amazon SES, hal paling utama Anda perlu memahami perbedaan antara bidang header "Dari," "Balas Ke," dan "Jalur Kembali". Seperti yang disebutkan sebelumnya, alamat "Dari" adalah alamat email pengirim pesan, sedangkan "Balas Ke" dan "Jalur Kembali" adalah sebagai berikut:

• Balas Ke—Alamat email yang akan dikirim balasan. Secara default, balasan akan dikirim ke alamat email pengirim asli.

• Jalur Kembali—Alamat email tempat pentalan dan aduan pesan yang harus dikirim. "Jalur Kembali" terkadang dipanggil "envelope dari," "pengirim envelope," atau "MAIL FROM."

  catatan

  Bila Anda menggunakan Amazon SES, kami merekomendasikan Anda untuk selalu mengatur parameter "Jalur Kembali" sehingga Anda dapat menyadari pentalan dan mengambil tindakan korektif jika terjadi.

Untuk dengan mudah mencocokkan pesan pentalan dengan penerima yang dimaksudkan, Anda dapat menggunakan Variable Envelope Return Path (VERP). Dengan VERP, Anda menetapkan "Jalur Kembali" berbeda untuk setiap penerima, sehingga jika pesan terpental kembali, Anda secara otomatis mengetahui tempat penerima itu terpental, daripada harus membuka pesan pentalan dan mengurainya.

Isi email

Isi email berisi teks pesan. Isi dapat dikirim dalam format berikut:

• HTML—Jika klien email penerima dapat menafsirkan HTML, isi dapat mencakup teks dan hyperlink yang diformat

• Teks biasa—Jika klien email penerima berbasis teks, isi tidak harus berisi karakter yang tidak dapat dicetak.

• Kedua HTML dan teks biasa—Saat Anda menggunakan kedua format untuk mengirim konten yang sama dalam satu pesan, klien email penerima memutuskan yang akan ditampilkan, berdasarkan kemampuannya.

Jika Anda mengirim pesan email ke sejumlah besar penerima, maka masuk akal untuk mengirimkannya dalam kedua HTML dan teks. Beberapa penerima akan memiliki klien email yang diaktifkan HTML, sehingga mereka dapat mengeklik hyperlink yang tersemat dalam pesan. Penerima yang menggunakan klien email berbasis teks akan meminta Anda untuk menyertakan URL yang dapat disalin dan dibuka menggunakan peramban web.

Informasi email yang Anda butuhkan untuk diberikan ke Amazon SES

Ketika Anda mengirim email dengan Amazon SES, informasi email yang Anda butuhkan untuk disediakan tergantung pada cara Anda memanggil Amazon SES. Anda dapat menyediakan jumlah minimal informasi dan memiliki Amazon SES untuk mengurus semua format Anda. Atau, jika Anda ingin melakukan sesuatu yang lebih lanjut seperti mengirim lampiran, Anda dapat menyediakan pesan mentah itu sendiri. Bagian berikut meninjau hal yang Anda butuhkan untuk disediakan ketika Anda mengirim email dengan menggunakan API Amazon SES, antarmuka SMTP Amazon SES, atau konsol Amazon SES.

API Amazon SES

Jika Anda memanggil API Amazon SES secara langsung, Anda memanggil API SendEmail atau SendRawEmail. Jumlah informasi yang Anda butuhkan untuk disediakan tergantung pada API yang Anda panggil.

• SendEmail API mengharuskan Anda untuk hanya menyediakan alamat sumber, alamat tujuan, subjek pesan, dan isi pesan. Anda dapat menyediakan alamat "Balas Ke" secara opsional. Ketika Anda memanggil API ini, Amazon SES secara otomatis merakit pesan email Multipurpose Internet Mail Extensions (MIME) beberapa bagian yang diformat dengan benar yang dioptimalkan untuk ditampilkan oleh perangkat lunak klien email. Untuk informasi lebih lanjut, lihat Mengirim email terformat menggunakan API Amazon SES.

• API SendRawEmail menyediakan Anda fleksibilitas untuk memformat dan mengirim pesan email mentah Anda sendiri dengan menentukan header, bagian MIME, dan tipe konten. SendRawEmail biasanya digunakan oleh pengguna tingkat lanjut. Anda perlu menyediakan isi pesan dan semua bidang header yang ditentukan seperti yang diperlukan dalam spesifikasi Format Pesan Internet (RFC 5322). Untuk informasi lebih lanjut, lihat Mengirim email mentah menggunakan Amazon SES API v2.

Jika Anda menggunakan AWS SDK untuk memanggil API Amazon SES, Anda memberikan informasi yang tercantum di atas ke fungsi yang sesuai (misalnya, SendEmail dan SendRawEmail untuk Java).

Untuk informasi selengkapnya tentang mengirim email menggunakan API Amazon SES, lihat Menggunakan API Amazon SES untuk mengirim email.

Antarmuka SMTP Amazon SES

Ketika Anda mengakses Amazon SES melalui antarmuka SMTP, aplikasi klien SMTP Anda merakit pesan, sehingga informasi yang Anda butuhkan untuk disediakan tergantung pada aplikasi yang Anda gunakan. Minimal, pertukaran SMTP antara klien dan server memerlukan alamat sumber, alamat tujuan, dan data pesan.

Untuk informasi selengkapnya tentang mengirim email menggunakan antarmuka SMTP Amazon SES, lihat Menggunakan antarmuka SMTP Amazon SES untuk mengirim email.

Konsol Amazon SES

Ketika Anda mengirim email dengan menggunakan konsol Amazon SES, jumlah informasi yang Anda butuhkan untuk diberikan tergantung pada yang Anda pilih untuk mengirim email berformat atau email mentah.

• Untuk mengirim email berformat, Anda harus menyediakan alamat sumber, alamat tujuan, subjek pesan, dan isi pesan. Amazon SES secara otomatis merakit pesan email MIME beberapa bagian yang diformat dengan benar yang dioptimalkan untuk ditampilkan oleh perangkat lunak klien email. Anda juga dapat menentukan bidang balasan ke dan jalur kembali.

• Untuk mengirim email mentah, Anda menyediakan alamat sumber, alamat tujuan, dan konten pesan, yang harus berisi isi pesan dan semua bidang header yang ditentukan seperti yang diperlukan dalam spesifikasi Format Pesan Internet (RFC 5322).