Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyiapkan pemberitahuan acara untuk Amazon SES
Dalam rangka mengirim email menggunakan Amazon SES, Anda harus memiliki sistem di tempat untuk mengelola pentalan dan aduan. Amazon SES dapat memberi tahu Anda tentang peristiwa pentalan atau aduan dalam tiga cara: dengan mengirimkan email notifikasi, dengan memberitahukan topik Amazon SNS, atau dengan memublikasikan peristiwa pengiriman. Bagian ini berisi informasi tentang penyiapan Amazon SES untuk mengirim jenis notifikasi tertentu melalui email atau dengan memberi tahu topik Amazon SNS. Untuk informasi selengkapnya tentang publikasi peristiwa pengiriman, lihat [Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES](monitor-using-event-publishing.md).
Anda dapat menyiapkan notifikasi menggunakan konsol Amazon SES atau API Amazon SES.
**Topics**
+ [
## Pertimbangan penting
](#monitor-sending-activity-using-notifications-considerations)
+ [
# Menerima notifikasi Amazon SES melalui email
](monitor-sending-activity-using-notifications-email.md)
+ [
# Menerima notifikasi Amazon SES menggunakan Amazon SNS
](monitor-sending-activity-using-notifications-sns.md)
## Pertimbangan penting
Ada beberapa poin penting yang perlu dipertimbangkan ketika Anda mengatur Amazon SES untuk mengirim notifikasi:
+ Notifikasi email dan Amazon SNS berlaku untuk identitas individu (alamat email atau domain terverifikasi yang Anda gunakan untuk mengirim email). Saat Anda mengaktifkan notifikasi untuk identitas, Amazon SES hanya mengirimkan notifikasi untuk email yang dikirim dari identitas tersebut, dan hanya di AWS Wilayah tempat Anda mengonfigurasi notifikasi.
+ Anda harus mengaktifkan satu metode penerimaan notifikasi pentalan atau aduan. Anda dapat mengirim notifikasi ke domain atau alamat email yang menghasilkan pentalan atau aduan, atau ke topik Amazon SNS. Anda juga dapat menggunakan [penerbitan acara](monitor-using-event-publishing.md) untuk mengirim pemberitahuan tentang beberapa jenis acara (termasuk pantulan, keluhan, pengiriman, dan lainnya) ke topik Amazon SNS atau aliran Firehose.
Jika Anda tidak mengatur salah satu metode notifikasi penerimaan pentalan atau aduan ini, Amazon SES secara otomatis meneruskan notifikasi pentalan dan aduan ke alamat Jalur Kembali (atau alamat Sumber, jika Anda tidak menentukan alamat Jalur Kembali) di email yang mengakibatkan peristiwa pentalan atau aduan, bahkan jika Anda menonaktifkan penerusan umpan balik email.
Jika Anda menonaktifkan penerusan umpan balik email dan mengaktifkan publikasi peristiwa, Anda harus menerapkan set konfigurasi yang berisi aturan publikasi peristiwa untuk semua email yang Anda kirim. Dalam situasi ini, jika Anda tidak menggunakan set konfigurasi, Amazon SES secara otomatis meneruskan notifikasi pentalan dan aduan ke Jalur Kembali atau alamat Sumber di email yang mengakibatkan peristiwa pentalan atau aduan.
+ Jika Anda menyiapkan Amazon SES untuk mengirim peristiwa pentalan dan aduan menggunakan lebih dari satu metode (seperti dengan mengirim notifikasi email dan dengan menggunakan peristiwa pengiriman), Anda mungkin menerima lebih dari satu notifikasi untuk peristiwa yang sama.
# Menerima notifikasi Amazon SES melalui email
Amazon SES dapat mengirimkan email ketika Anda menerima pentalan dan aduan dengan menggunakan proses yang disebut *penerusan umpan balik email*.
Dalam rangka mengirim email menggunakan Amazon SES, Anda harus mengonfigurasinya untuk mengirim notifikasi pentalan dan aduan dengan menggunakan salah satu metode berikut:
+ Dengan mengaktifkan penerusan umpan balik email. Prosedur untuk menyiapkan tipe notifikasi ini disertakan di bagian ini.
+ Dengan mengirimkan notifikasi ke topik Amazon SNS. Untuk informasi lebih lanjut, lihat [Menerima notifikasi Amazon SES menggunakan Amazon SNS](monitor-sending-activity-using-notifications-sns.md).
+ Dengan memublikasikan notifikasi peristiwa. Untuk informasi lebih lanjut, lihat [Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES](monitor-using-event-publishing.md).
**penting**
Untuk beberapa poin penting tentang notifikasi, lihat [Menyiapkan pemberitahuan acara untuk Amazon SES](monitor-sending-activity-using-notifications.md).
**Topics**
+ [
## Mengaktifkan penerusan umpan balik email
](#monitor-sending-activity-using-notifications-email-enabling)
+ [
## Menonaktifkan penerusan umpan balik email
](#monitor-sending-activity-using-notifications-email-disabling)
+ [
## Tujuan penerusan umpan balik email
](#monitor-sending-activity-using-notifications-email-destination)
## Mengaktifkan penerusan umpan balik email
Penerusan umpan balik email diaktifkan secara default. Jika sebelumnya Anda menonaktifkannya, Anda dapat mengaktifkannya dengan mengikuti prosedur di bagian ini.
**Untuk mengaktifkan penerusan pentalan dan aduan melalui email menggunakan konsol Amazon SES**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon SES di [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih **Identitas yang terverifikasi**.
1. Dalam daftar alamat email atau domain terverifikasi, pilih alamat email atau domain yang ingin Anda konfigurasikan notifikasi pentalan dan aduannya.
1. Di panel detail, perluas bagian **Notifikasi**.
1. Pilih **Edit Konfigurasi**.
1. Di bawah **Penerusan Umpan Balik Email**, pilih **Diaktifkan**.
**catatan**
Perubahan yang Anda buat di halaman ini mungkin memerlukan beberapa menit untuk diterapkan.
Anda juga dapat mengaktifkan pemberitahuan pentalan dan keluhan melalui email dengan menggunakan operasi [ SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html)API.
## Menonaktifkan penerusan umpan balik email
Jika Anda menyiapkan metode yang berbeda dalam memberikan notifikasi pentalan dan aduan, Anda dapat menonaktifkan penerusan umpan balik email sehingga Anda tidak menerima banyak notifikasi ketika terjadi peristiwa pentalan atau aduan.
**Untuk menonaktifkan penerusan pentalan dan aduan melalui email menggunakan konsol Amazon SES**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon SES di [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih **Identitas yang terverifikasi**.
1. Dalam daftar alamat email atau domain terverifikasi, pilih alamat email atau domain yang ingin Anda konfigurasikan notifikasi pentalan dan aduannya.
1. Di panel detail, perluas bagian **Notifikasi**.
1. Pilih **Edit Konfigurasi**.
1. Di bawah **Penerusan Umpan Balik Email**, pilih **Dinonaktifkan**.
**catatan**
Anda harus mengonfigurasi salah satu metode penerimaan notifikasi pentalan dan aduan untuk mengirim email melalui Amazon SES. [Jika menonaktifkan penerusan umpan balik email, Anda harus mengaktifkan notifikasi yang dikirim oleh Amazon SNS, atau memublikasikan peristiwa pentalan dan keluhan ke topik Amazon SNS atau aliran Firehose dengan menggunakan penerbitan acara.](monitor-using-event-publishing.md) Jika Anda menggunakan publikasi peristiwa, Anda juga harus menerapkan set konfigurasi yang berisi aturan publikasi peristiwa ke setiap email yang Anda kirim. Jika Anda tidak menyiapkan metode penerimaan notifikasi pentalan dan aduan, Amazon SES secara otomatis meneruskan notifikasi umpan balik melalui email ke alamat di bidang Jalur Kembali (atau bidang Sumber, jika Anda tidak menentukan alamat Jalur Kembali) dari pesan yang mengakibatkan peristiwa pentalan atau aduan. Dalam situasi ini, Amazon SES meneruskan notifikasi pentalan dan aduan bahkan jika Anda menonaktifkan notifikasi umpan balik email.
1. Untuk menyimpan konfigurasi notifikasi Anda, pilih **Simpan Config**.
**catatan**
Perubahan yang Anda buat di halaman ini mungkin perlu beberapa menit untuk diterapkan.
Anda juga dapat menonaktifkan pemberitahuan pentalan dan keluhan melalui email dengan menggunakan operasi [SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html)API.
## Tujuan penerusan umpan balik email
Ketika Anda menerima notifikasi melalui email, Amazon SES menulis ulang header `From` dan mengirimkan notifikasi kepada Anda. Alamat tempat Amazon SES meneruskan notifikasi tergantung pada cara Anda mengirim pesan asli.
Jika Anda menggunakan antarmuka SMTP untuk mengirim pesan, maka notifikasi dikirimkan sesuai dengan aturan berikut:.
+ Jika Anda menentukan `Return-Path` header di `SMTP DATA` bagian tersebut, maka notifikasi masuk ke alamat itu.
+ Jika tidak, pemberitahuan pergi ke alamat yang Anda tentukan saat Anda mengeluarkan perintah MAIL FROM.
Jika Anda menggunakan operasi API `SendEmail` untuk mengirim pesan, maka notifikasi dikirimkan sesuai dengan aturan berikut:
+ Jika Anda menentukan parameter `ReturnPath` opsional dalam panggilan Anda ke API `SendEmail`, maka notifikasi masuk ke alamat tersebut.
+ Jika tidak, notifikasi masuk ke alamat yang ditentukan dalam parameter `Source` dari `SendEmail` yang diperlukan.
Jika Anda menggunakan operasi API `SendRawEmail` untuk mengirim pesan, maka notifikasi dikirimkan sesuai dengan aturan berikut:
+ Jika Anda menentukan `Return-Path` header dalam pesan mentah, maka notifikasi masuk ke alamat itu.
+ Jika tidak, jika Anda menentukan `Source` parameter dalam panggilan Anda ke `SendRawEmail` API, maka notifikasi akan masuk ke alamat tersebut.
+ Sebaliknya, notifikasi masuk ke alamat di header `From` dari pesan mentah.
**catatan**
Ketika Anda menentukan alamat `Return-Path` di email, Anda menerima notifikasi di alamat tersebut. Namun, versi pesan yang diterima oleh penerima berisi header `Return-Path` yang menyertakan alamat email anonim (seperti *a0b1c2d3e4f5a6b7-c8d9e0f1-a2b3-c4d5-e6f7-a8b9c0d1e2f3-000000@amazonses.com*). Anonimisasi ini terjadi terlepas dari cara Anda mengirim email.
# Menerima notifikasi Amazon SES menggunakan Amazon SNS
Anda dapat mengonfigurasi Amazon SES untuk memberi tahu topik Amazon SNS ketika Anda menerima pentalan atau aduan, atau ketika email dikirim. Notifikasi Amazon SNS dalam format [JavaScript Object Notation (JSON)](http://www.json.org), yang memungkinkan Anda memprosesnya secara terprogram.
Dalam rangka mengirim email menggunakan Amazon SES, Anda harus mengonfigurasinya untuk mengirim notifikasi pentalan dan aduan dengan menggunakan salah satu metode berikut:
+ Dengan mengirimkan notifikasi ke topik Amazon SNS. Prosedur untuk menyiapkan tipe notifikasi ini disertakan di bagian ini.
+ Dengan mengaktifkan penerusan umpan balik email. Untuk informasi lebih lanjut, lihat [Menerima notifikasi Amazon SES melalui email](monitor-sending-activity-using-notifications-email.md).
+ Dengan memublikasikan notifikasi peristiwa. Untuk informasi lebih lanjut, lihat [Pantau pengiriman email menggunakan penerbitan peristiwa Amazon SES](monitor-using-event-publishing.md).
**penting**
Lihat [Menyiapkan pemberitahuan acara untuk Amazon SES](monitor-sending-activity-using-notifications.md) untuk informasi penting tentang notifikasi.
**Topics**
+ [
# Mengonfigurasi notifikasi Amazon SNS untuk Amazon SES
](configure-sns-notifications.md)
+ [
# Isi notifikasi Amazon SNS untuk Amazon SES
](notification-contents.md)
+ [
# Contoh notifikasi Amazon SNS untuk Amazon SES
](notification-examples.md)
# Mengonfigurasi notifikasi Amazon SNS untuk Amazon SES
Amazon SES dapat memberi tahu Anda tentang pentalan, aduan, dan pengiriman Anda melalui [Amazon Simple Notification Service (Amazon SNS)](https://aws.amazon.com/sns).
Anda dapat mengonfigurasi notifikasi di konsol Amazon SES, atau dengan menggunakan API Amazon SES.
**Topics**
+ [
## Prasyarat
](#configure-feedback-notifications-prerequisites)
+ [
## Mengonfigurasi notifikasi menggunakan konsol Amazon SES
](#configure-feedback-notifications-console)
+ [
## Mengonfigurasi notifikasi menggunakan API Amazon SES
](#configure-feedback-notifications-api)
+ [
## Pemecahan masalah notifikasi umpan balik
](#configure-feedback-notifications-troubleshooting)
## Prasyarat
Selesaikan langkah-langkah berikut sebelum Anda menyiapkan notifikasi Amazon SNS di Amazon SES:
1. Buat topik di Amazon SNS. Untuk informasi lebih lanjut, lihat [Buat Topik](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) di *Panduan Developer Amazon Simple Notification Service*.
**penting**
**Saat Anda membuat topik menggunakan Amazon SNS, untuk **Jenis**, pilih saja Standar.** (SES tidak mendukung topik tipe FIFO.)
Apakah Anda membuat topik SNS baru atau memilih yang sudah ada, Anda perlu memberikan akses ke SES untuk mempublikasikan pemberitahuan ke topik tersebut.
Untuk memberikan izin Amazon SES untuk memublikasikan pemberitahuan ke topik, pada layar **Edit topik** di konsol SNS, perluas **kebijakan Access** dan di **editor JSON**, tambahkan kebijakan izin berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "notification-policy",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:identity/identity_name"
}
}
}
]
}
```
------
Buat perubahan berikut ke contoh kebijakan sebelumnya:
+ Ganti *topic\$1region* dengan AWS Wilayah tempat Anda membuat topik SNS.
+ Ganti *111122223333* dengan ID akun AWS Anda.
+ Ganti *topic\$1name* dengan nama topik SNS Anda.
+ Ganti *identity\$1name* dengan identitas terverifikasi (alamat email atau domain) yang Anda berlangganan ke topik SNS.
1. Berlangganan setidaknya satu titik akhir ke topik. Misalnya, jika Anda ingin menerima notifikasi melalui pesan teks, berlanggananlah titik akhir SMS (yaitu nomor ponsel) ke topik tersebut. Untuk menerima notifikasi melalui email, berlanggananlah titik akhir email (alamat email) ke topik tersebut.
Untuk informasi lebih lanjut, lihat [Memulai](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) di *Panduan Developer Amazon Simple Notification Service*.
1. (Opsional) Jika topik Amazon SNS Anda menggunakan AWS Key Management Service (AWS KMS) untuk enkripsi sisi server, Anda harus menambahkan izin ke kebijakan utama. AWS KMS Anda dapat menambahkan izin dengan melampirkan kebijakan berikut ke kebijakan AWS KMS utama:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowSESToUseKMSKey",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
## Mengonfigurasi notifikasi menggunakan konsol Amazon SES
**Untuk mengonfigurasi notifikasi menggunakan konsol Amazon SES**
1. Buka konsol Amazon SES di [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih **Identitas**.
1. Dalam wadah **Identitas**, pilih identitas terverifikasi yang ingin Anda terima pemberitahuan umpan balik ketika pesan yang dikirim dari identitas ini menghasilkan bouncing, keluhan, atau pengiriman.
**penting**
Pengaturan notifikasi domain terverifikasi berlaku untuk semua email yang dikirim dari alamat email di domain tersebut *kecuali* untuk alamat email yang juga terverifikasi.
1. Di layar detail identitas terverifikasi yang Anda pilih, pilih tab **Pemberitahuan** dan pilih **Edit** di wadah **Pemberitahuan umpan balik**.
1. Perluas kotak daftar topik SNS dari setiap jenis umpan balik yang ingin Anda terima notifikasi, dan pilih topik SNS yang Anda miliki, **Tidak ada topik SNS, atau topik SNS** **yang tidak Anda** miliki.
1. Jika Anda memilih **topik SNS yang tidak Anda miliki**, bidang **ARN topik SNS akan disajikan di mana Anda harus memasukkan topik SNS ARN** yang dibagikan kepada Anda oleh pengirim delegasi Anda. (Hanya pengirim delegasi Anda yang akan mendapatkan notifikasi ini karena mereka memiliki topik SNS. Untuk mempelajari lebih lanjut tentang pengiriman delegasi, lihat[Gambaran umum otorisasi pengiriman](sending-authorization-overview.md).)
**penting**
Topik Amazon SNS yang Anda gunakan untuk pemberitahuan pentalan, keluhan, dan pengiriman harus sama Wilayah AWS dengan yang Anda gunakan Amazon SES.
Selain itu, Anda harus berlangganan satu atau beberapa titik akhir ke topik tersebut untuk menerima notifikasi. Misalnya, jika Anda ingin notifikasi dikirimkan ke suatu alamat email, Anda harus berlangganan titik akhir email ke topik tersebut. Untuk informasi lebih lanjut, lihat [Memulai](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) di *Panduan Developer Amazon Simple Notification Service*.
1. (Opsional) Jika Anda ingin pemberitahuan topik Anda menyertakan header dari email asli, centang **Sertakan header email asli** kotak tepat di bawah nama topik SNS dari setiap jenis umpan balik. Opsi ini hanya tersedia jika Anda telah menetapkan topik Amazon SNS untuk tipe notifikasi terkait. Untuk informasi tentang isi header email asli, lihat objek `mail` di [Isi notifikasi](notification-contents.md).
1. Pilih **Simpan perubahan**. Perubahan yang Anda buat pada pengaturan notifikasi Anda mungkin memerlukan beberapa menit untuk diterapkan.
1. (Opsional) Jika Anda memilih notifikasi topik Amazon SNS untuk pantulan dan keluhan, Anda dapat menonaktifkan notifikasi email sepenuhnya sehingga Anda tidak menerima pemberitahuan ganda melalui email dan notifikasi SNS. **Untuk menonaktifkan pemberitahuan email untuk bouncing dan keluhan, di bawah tab **Notifikasi** pada layar detail identitas terverifikasi, dalam wadah **Penerusan Umpan Balik Email**, pilih **Edit**, hapus centang pada kotak **Diaktifkan**, dan pilih Simpan perubahan.**
Setelah mengonfigurasi pengaturan, Anda akan mulai menerima notifikasi pentalan, aduan, dan pengiriman ke topik Amazon SNS Anda. Notifikasi ini dalam format JavaScript Object Notation (JSON) dan mengikuti struktur yang dijelaskan dalam. [Isi notifikasi](notification-contents.md)
Anda akan dikenakan tarif Amazon SNS standar untuk notifikasi pentalan, aduan, dan pengiriman. Untuk informasi lebih lanjut, lihat [halaman harga Amazon SNS](https://aws.amazon.com/sns/pricing).
**catatan**
Jika upaya untuk memublikasikan ke topik Amazon SNS Anda gagal karena topik telah dihapus atau Anda Akun AWS tidak lagi memiliki izin untuk mempublikasikannya, Amazon SES menghapus konfigurasi untuk topik tersebut jika telah dikonfigurasi untuk pantulan atau keluhan (bukan pengiriman - untuk pemberitahuan pengiriman, SES tidak akan menghapus setelan konfigurasi topik SNS). Selain itu, Amazon SES kembali mengaktifkan notifikasi email pentalan dan aduan untuk identitas, dan Anda menerima notfikasi dari perubahan tersebut melalui email. Jika beberapa identitas dikonfigurasi untuk menggunakan topik tersebut, konfigurasi topik untuk setiap identitas berubah ketika masing-masing identitas mengalami kegagalan untuk memublikasikan ke topik.
## Mengonfigurasi notifikasi menggunakan API Amazon SES
Anda juga dapat mengonfigurasi notifikasi pentalan, aduan, dan pengiriman dengan menggunakan API Amazon SES. Gunakan operasi berikut untuk mengonfigurasi notifikasi:
+ [SetIdentityNotificationTopic](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityNotificationTopic.html)
+ [SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html)
+ [GetIdentityNotificationAttributes](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityNotificationAttributes.html)
+ [SetIdentityHeadersInNotificationsEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityHeadersInNotificationsEnabled.html)
Anda dapat menggunakan tindakan API ini untuk menulis aplikasi front-end yang disesuaikan untuk notifikasi. Untuk deskripsi lengkap mengenai tindakan API terkait notifikasi, lihat [Referensi API Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Pemecahan masalah notifikasi umpan balik
**Tidak menerima notifikasi**
Jika Anda tidak menerima notifikasi, pastikan bahwa Anda berlangganan titik akhir ke topik yang dikirimkan notifikasi. Ketika Anda berlangganan titik akhir email ke topik, Anda menerima email yang meminta Anda untuk mengonfirmasi langganan Anda. Anda harus mengonfirmasi langganan sebelum mulai menerima notifikasi email. Untuk informasi lebih lanjut, lihat [Memulai](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) di *Panduan Developer Amazon Simple Notification Service*.
**Kesalahan `InvalidParameterValue` saat memilih topik**
Jika Anda menerima kesalahan yang menyatakan bahwa terjadi kesalahan `InvalidParameterValue`, periksa topik Amazon SNS untuk melihat jika dienkripsi menggunakan AWS KMS. Jika ya, Anda harus mengubah kebijakan untuk AWS KMS kunci tersebut. Lihat [Prasyarat](#configure-feedback-notifications-prerequisites) untuk kebijakan sampel.
# Isi notifikasi Amazon SNS untuk Amazon SES
Pemberitahuan pantulan, keluhan, dan pengiriman dipublikasikan ke topik [Amazon Simple Notification Service (Amazon SNS) dalam format JavaScript Object Notation (JSON)](https://aws.amazon.com/sns). Tingkat atas objek JSON berisi string `notificationType`, objek `mail`, dan objek `bounce`, objek `complaint`, atau objek `delivery`.
Lihat bagian berikut untuk deskripsi berbagai tipe objek:
+ [Objek JSON tingkat atas](#top-level-json-object)
+ [objek `mail`](#mail-object)
+ [Objek `bounce`](#bounce-object)
+ [Objek `complaint`](#complaint-object)
+ [Objek `delivery`](#delivery-object)
Berikut ini adalah beberapa catatan penting tentang isi notifikasi Amazon SNS untuk Amazon SES:
+ Untuk tipe notifikasi tertentu, Anda mungkin menerima satu notifikasi Amazon SNS untuk beberapa penerima, atau Anda mungkin menerima satu notifikasi Amazon SNS per penerima. Kode Anda harus dapat mengurai notifikasi Amazon SNS dan menangani kedua kasus; SES tidak membuat jaminan pemesanan atau pengelompokan untuk notifikasi yang dikirim melalui Amazon SNS. Namun, tipe notifikasi Amazon SNS yang berbeda (misalnya, pentalan dan aduan) tidak digabungkan menjadi satu notifikasi.
+ Anda mungkin menerima beberapa tipe notifikasi Amazon SNS untuk satu penerima. Misalnya, server email penerima mungkin menerima email tersebut (memicu notifikasi pengiriman), tapi setelah memproses email, server email penerima mungkin menentukan bahwa email tersebut benar-benar menghasilkan pentalan (memicu notifikasi pentalan). Namun, notifikasi ini selalu terpisah karena notifikasi tersebut merupakan tipe notifikasi yang berbeda.
+ SES berhak untuk menambahkan bidang tambahan ke notifikasi. Dengan demikian, aplikasi yang mengurai notifikasi ini harus cukup fleksibel untuk menangani bidang yang tidak diketahui.
+ SES menimpa header pesan saat mengirim email. Anda dapat mengambil header pesan asli dari bidang `headers` dan `commonHeaders` dari objek `mail`.
## Objek JSON Tingkat Atas
Objek JSON tingkat atas dalam pemberitahuan SES berisi bidang berikut.
| Nama bidang | Deskripsi |
| --- | --- |
| notificationType | String yang memiliki tipe notifikasi yang diwakili oleh objek JSON. Kemungkinan nilai adalah: `Bounce`, `Complaint`, atau `Delivery`. Jika Anda [menyiapkan penerbitan acara](monitor-sending-using-event-publishing-setup.md), bidang ini diberi nama`eventType`. |
| mail | Objek JSON yang berisi informasi tentang email asli yang dikaitkan dengan notifikasi. Untuk informasi lebih lanjut, lihat [Objek surat](#mail-object). |
| bounce | Bidang ini muncul hanya jika `notificationType` adalah `Bounce` dan berisi objek JSON yang menyimpan informasi tentang pentalan. Untuk informasi lebih lanjut, lihat [Objek pentalan](#bounce-object). |
| complaint | Bidang ini muncul hanya jika `notificationType` adalah `Complaint` dan berisi objek JSON yang menyimpan informasi tentang aduan. Untuk informasi lebih lanjut, lihat [Objek aduan](#complaint-object). |
| delivery | Bidang ini muncul hanya jika `notificationType` adalah `Delivery` dan berisi objek JSON yang menyimpan informasi tentang pengiriman. Untuk informasi lebih lanjut, lihat [Objek pengiriman](#delivery-object). |
## Objek surat
Setiap notifikasi pentalan, aduan, atau pengiriman berisi informasi tentang email asli di objek `mail`. Objek JSON yang berisi informasi tentang objek `mail` memiliki bidang berikut.
| Nama bidang | Deskripsi |
| --- | --- |
| timestamp | Waktu di mana pesan asli dikirim (dalam ISO8601 format). |
| messageId | ID unik yang ditetapkan SES ke pesan. SES mengembalikan nilai ini kepada Anda saat Anda mengirim pesan. ID pesan ini ditetapkan oleh SES. Anda dapat menemukan ID pesan dari email asli di `headers` bidang `mail` objek. |
| source | Alamat email tempat pesan asli dikirim (alamat envelope MAIL FROM). |
| sourceArn | Amazon Resource Name (ARN) dari identitas yang digunakan untuk mengirim email. Dalam hal otorisasi pengiriman, `sourceArn` adalah ARN identitas yang pemilik identitasnya mengotorisasi penggunaan pengirim delegasi untuk mengirim email. Untuk informasi selengkapnya tentang otorisasi pengiriman, lihat [Metode autentikasi emailMenggunakan otorisasi pengiriman](sending-authorization.md). |
| sourceIp | Alamat IP publik yang berasal dari klien yang melakukan permintaan pengiriman email ke SES. |
| sendingAccountId | Akun AWS ID akun yang digunakan untuk mengirim email. Dalam hal otorisasi pengiriman, `sendingAccountId` adalah ID akun pengirim delegasi. |
| callerIdentity | Identitas IAM dari pengguna SES yang mengirim email. |
| destination | Daftar alamat email yang merupakan penerima email asli. |
| headersTruncated | Objek ini ada hanya jika Anda mengonfigurasi pengaturan notifikasi untuk menyertakan header dari email asli. Menunjukkan jika header dipotong dalam notifikasi. SES memotong header dalam notifikasi ketika header dari pesan asli berukuran 10 KB atau lebih besar. Kemungkinan nilai adalah `true` dan `false`. |
| headers | Objek ini ada hanya jika Anda mengonfigurasi pengaturan notifikasi untuk menyertakan header dari email asli. Daftar header asli email. Setiap header dalam daftar memiliki bidang `name` dan bidang `value`. Setiap ID pesan dalam `headers` objek berasal dari pesan asli yang Anda kirimkan ke SES. ID pesan yang selanjutnya ditetapkan SES ke pesan ada di `messageId` bidang `mail` objek. |
| commonHeaders | Objek ini ada hanya jika Anda mengonfigurasi pengaturan notifikasi untuk menyertakan header dari email asli. Mencakup informasi tentang header email umum dari email asli, termasuk bidang Dari, Kepada, dan Subjek. Dalam objek ini, setiap header adalah kunci. Bidang Dari dan Kepada diwakili oleh array yang dapat berisi beberapa nilai. Untuk peristiwa, ID pesan apa pun dalam `commonHeaders` bidang adalah ID pesan yang kemudian ditetapkan Amazon SES ke pesan di `messageId` bidang objek email. Notifikasi akan berisi ID pesan dari email asli. |
Berikut ini adalah contoh dari objek `mail` yang mencakup header email asli. Ketika tipe notifikasi ini tidak dikonfigurasi untuk menyertakan header email asli, objek `mail` tidak menyertakan bidang `headersTruncated`, `headers`, dan `commonHeaders`.
```
{
"timestamp":"2018-10-08T14:05:45 +0000",
"messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000",
"source":"sender@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"destination":[
"recipient@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"Sender Name\" "
},
{
"name":"To",
"value":"\"Recipient Name\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Mon, 08 Oct 2018 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"Sender Name "
],
"date":"Mon, 08 Oct 2018 14:05:45 +0000",
"to":[
"Recipient Name "
],
"messageId":" custom-message-ID",
"subject":"Message sent using SES"
}
}
```
## Objek pentalan
Objek JSON yang berisi informasi tentang pentalan berisi bidang berikut.
| Nama bidang | Deskripsi |
| --- | --- |
| bounceType | Jenis pantulan, sebagaimana ditentukan oleh SES. Untuk informasi selengkapnya, lihat [Tipe pentalan](#bounce-types). |
| bounceSubType | Subtipe pantulan, sebagaimana ditentukan oleh SES. Untuk informasi selengkapnya, lihat [Tipe pentalan](#bounce-types). |
| bouncedRecipients | Daftar yang berisi informasi tentang penerima email asli yang terpental. Untuk informasi selengkapnya, lihat [Penerima yang terpental](#bounced-recipients). |
| timestamp | Tanggal dan waktu di mana pantulan dikirim (dalam ISO8601 format). Perhatikan bahwa ini adalah waktu di mana pemberitahuan dikirim oleh ISP, dan bukan waktu di mana pemberitahuan itu diterima oleh SES. |
| feedbackId | ID unik untuk pentalan. |
Jika SES dapat menghubungi Otoritas Transfer Pesan jarak jauh (MTA), bidang berikut juga ada.
| Nama bidang | Deskripsi |
| --- | --- |
| remoteMtaIp | Alamat IP MTA tempat SES berusaha mengirimkan email. |
Jika notifikasi status pengiriman (DSN) terlampir pada pentalan, bidang berikut ini juga ada.
| Nama bidang | Deskripsi |
| --- | --- |
| reportingMTA | Nilai bidang `Reporting-MTA` dari DSN. Ini adalah nilai MTA yang berusaha untuk melakukan pengiriman, relai, atau operasi gateway yang dijelaskan di DSN. |
Berikut ini adalah contoh dari objek `bounce`.
```
{
"bounceType":"Permanent",
"bounceSubType": "General",
"bouncedRecipients":[
{
"status":"5.0.0",
"action":"failed",
"diagnosticCode":"smtp; 550 user unknown",
"emailAddress":"recipient1@example.com"
},
{
"status":"4.0.0",
"action":"delayed",
"emailAddress":"recipient2@example.com"
}
],
"reportingMTA": "example.com",
"timestamp":"2012-05-25T14:59:38.605Z",
"feedbackId":"000001378603176d-5a4b5ad9-6f30-4198-a8c3-b1eb0c270a1d-000000",
"remoteMtaIp":"127.0.2.0"
}
```
### Penerima yang terpental
Notifikasi pentalan mungkin berkaitan dengan satu penerima atau beberapa penerima. Bidang `bouncedRecipients` memiliki daftar objek—satu per penerima yang berkaitan dengan notifikasi pentalan—dan selalu berisi bidang berikut.
| Nama bidang | Deskripsi |
| --- | --- |
| emailAddress | Alamat email penerima. Jika DSN tersedia, ini adalah nilai bidang `Final-Recipient` dari DSN. |
Secara opsional, jika DSN dilampirkan ke pentalan, bidang berikut mungkin juga ada.
| Nama bidang | Deskripsi |
| --- | --- |
| action | Nilai bidang `Action` dari DSN. Hal ini menunjukkan tindakan yang dilakukan oleh Pelaporan-MTA sebagai hasil dari usahanya untuk mengirimkan pesan kepada penerima ini. |
| status | Nilai bidang `Status` dari DSN. Ini adalah kode status bebas-transportasi per penerima yang menunjukkan status penyampaian pesan. |
| diagnosticCode | Kode status yang dikeluarkan oleh MTA pelaporan. Ini adalah nilai bidang `Diagnostic-Code` dari DSN. Bidang ini mungkin tidak ada di DSN (sehingga juga tidak ada di JSON). |
Berikut ini adalah contoh objek yang mungkin ada di daftar `bouncedRecipients`.
```
{
"emailAddress": "recipient@example.com",
"action": "failed",
"status": "5.0.0",
"diagnosticCode": "X-Postfix; unknown user"
}
```
### Tipe pentalan
Objek bouncing berisi jenis bouncing`Undetermined`, `Permanent` *(keras)*, atau `Transient` *(lunak*). Jenis bouncing `Permanent` *(keras)* dan `Transient` *(lunak)* juga dapat berisi salah satu dari beberapa subtipe bouncing.
Saat menerima pemberitahuan bouncing dengan tipe bouncing `Transient` *(lunak)*, Anda mungkin dapat mengirim email ke penerima tersebut di masa mendatang jika masalah yang menyebabkan pesan terpental teratasi.
Ketika Anda menerima pemberitahuan bouncing dengan tipe bouncing `Permanent` *(hard)*, kecil kemungkinannya Anda akan dapat mengirim email ke penerima tersebut di masa mendatang. Untuk alasan ini, Anda harus segera menghapus penerima alamat yang menghasilkan pentalan tersebut dari milis Anda.
**catatan**
Ketika *soft bounce* (bouncing yang terkait dengan masalah sementara, seperti kotak masuk penerima penuh) terjadi, SES mencoba mengirim ulang email untuk jangka waktu tertentu. Pada akhir periode waktu itu, jika SES masih tidak dapat mengirimkan email, ia berhenti mencoba.
SES memberikan pemberitahuan untuk pantulan keras, dan untuk pantulan lunak yang berhenti mencoba mengirimkannya. Jika Anda ingin menerima notifikasi setiap kali terjadi pentalan lunak, [aktifkan publikasi peristiwa](monitor-sending-using-event-publishing-setup.md) dan konfigurasikan untuk mengirim notifikasi ketika peristiwa penundaan pengiriman terjadi.
| bounceType | bounceSubType | Deskripsi |
| --- | --- | --- |
| Undetermined | Undetermined | Penyedia email penerima mengirim pesan pentalan. Pesan bouncing tidak berisi informasi yang cukup bagi SES untuk menentukan alasan pantulan. Email pentalan, yang dikirim ke alamat di header Jalur Kembali email yang mengakibatkan pentalan, mungkin berisi informasi tambahan tentang masalah yang menyebabkan email terpental. |
| Permanent | General | Penyedia email penerima mengirim pesan hard bounce. Ketika Anda menerima tipe notifikasi pentalan ini, Anda harus segera menghapus alamat email penerima tersebut dari milis Anda. Mengirim pesan ke alamat yang menghasilkan pentalan keras dapat berdampak negatif pada reputasi Anda sebagai pengirim. Jika Anda terus mengirim email ke alamat yang menghasilkan pentalan keras, kami mungkin menjeda kemampuan Anda untuk mengirim email tambahan. Lihat [Menggunakan daftar penindasan tingkat akun Amazon SES](sending-email-suppression-list.md). |
| Permanent | NoEmail | Itu tidak mungkin untuk mengambil alamat email penerima dari pesan bouncing. |
| Permanent | Suppressed | Alamat email penerima ada di daftar penindasan SES karena memiliki riwayat baru-baru ini menghasilkan pantulan keras. Untuk mengganti daftar penindasan global, lihat. [Menggunakan daftar penindasan tingkat akun Amazon SES](sending-email-suppression-list.md) |
| Permanent | OnAccountSuppressionList | SES telah menekan pengiriman ke alamat ini karena ada di daftar penekanan [tingkat akun](sending-email-suppression-list.md). Ini tidak dihitung terhadap metrik rasio pentalan Anda. |
| Permanent | UnsubscribedRecipient | Jenis bouncing ini terjadi ketika kontak penerima telah berhenti berlangganan dari topik dan email dikirim kepada mereka menggunakan opsi manajemen [daftar](sending-email-list-management.md#configuring-list-management-list-contacts). SES menghormati preferensi kontak dan tidak mencoba pengiriman. Selain itu, bouncing ini tidak memengaruhi reputasi pengirim karena pengiriman tidak dicoba, kontak penerima juga tidak ditambahkan ke daftar penindasan karena pantulan. Disarankan agar Anda berlangganan UnsubscribedRecipient acara untuk menghindari pengiriman terus ke penerima yang berhenti berlangganan. Pertimbangkan[Menggunakan pengelolaan daftar](sending-email-list-management.md). Manajemen daftar harus menjadi sumber kebenaran untuk daftar pelanggan Anda. Dari perspektif penegakan SES, jika Anda terus mengirim ke penerima yang ditekan atau berhenti berlangganan, Anda akan memiliki reputasi tidak mengikuti praktik terbaik untuk pengiriman email. |
| Transient | General | Penyedia email penerima mengirim pesan pentalan umum. Anda mungkin dapat mengirim pesan ke penerima yang sama di masa mendatang jika masalah yang menyebabkan pesan terpental teratasi. Jika Anda mengirim email ke penerima yang memiliki aturan respons otomatis yang aktif (seperti pesan "di luar kantor"), Anda mungkin menerima tipe notifikasi ini. Meskipun respons memiliki jenis notifikasi`Bounce`, SES tidak menghitung respons otomatis saat menghitung rasio pentalan untuk akun Anda. |
| Transient | MailboxFull | Penyedia email penerima mengirim pesan pentalan karena kotak masuk penerima penuh. Anda mungkin dapat mengirim ke penerima yang sama di masa mendatang ketika kotak pesan tidak lagi penuh. |
| Transient | MessageTooLarge | Penyedia email penerima mengirim pesan pentalan karena pesan yang Anda kirim terlalu besar. Anda mungkin dapat mengirim pesan ke penerima yang sama jika Anda mengurangi ukuran pesan. |
| Transient | ContentRejected | Penyedia email penerima mengirim pesan pentalan karena pesan yang Anda kirim berisi konten yang tidak diizinkan oleh penyedia. Anda mungkin dapat mengirim pesan ke penerima yang sama jika mengubah konten pesan. |
| Transient | AttachmentRejected | Penyedia email penerima mengirim pesan pentalan karena pesan berisi lampiran yang tidak dapat diterima. Misalnya, beberapa penyedia email mungkin menolak pesan dengan lampiran tipe file tertentu, atau pesan dengan lampiran yang sangat besar. Anda mungkin dapat mengirim pesan ke penerima yang sama jika Anda menghapus atau mengubah konten lampiran. |
## Objek aduan
Objek JSON yang berisi informasi tentang aduan memiliki bidang berikut.
| Nama bidang | Deskripsi |
| --- | --- |
| complainedRecipients | Daftar yang berisi informasi tentang penerima yang mungkin bertanggung jawab atas aduan tersebut. Untuk informasi lebih lanjut, lihat [Penerima yang diadukan](#complained-recipients). |
| timestamp | Tanggal dan waktu saat ISP mengirimkan notifikasi aduan, dalam format ISO 8601. Tanggal dan waktu di bidang ini mungkin tidak sama dengan tanggal dan waktu saat SES menerima pemberitahuan. |
| feedbackId | ID unik yang terkait dengan aduan tersebut. |
| complaintSubType | Nilai bidang `complaintSubType` dapat null atau `OnAccountSuppressionList`. Jika nilainya`OnAccountSuppressionList`, SES menerima pesan tersebut, tetapi tidak mencoba mengirimkannya karena ada di daftar [penekanan tingkat akun](sending-email-suppression-list.md). |
Selanjutnya, jika laporan umpan balik dilampirkan pada aduan, bidang berikut mungkin ada.
| Nama bidang | Deskripsi |
| --- | --- |
| userAgent | Nilai bidang `User-Agent` dari laporan umpan balik. Nilai ini menunjukkan nama dan versi sistem yang menghasilkan laporan. |
| complaintFeedbackType | Nilai bidang `Feedback-Type` dari laporan umpan balik yang diterima dari ISP. Ini berisi tipe umpan balik. |
| arrivalDate | Nilai `Arrival-Date` atau `Received-Date` bidang dari laporan umpan balik (dalam ISO8601 format). Bidang ini mungkin tidak ada dalam laporan (sehingga juga tidak ada dalam JSON). |
Berikut ini adalah contoh dari objek `complaint`.
```
{
"userAgent":"ExampleCorp Feedback Loop (V0.01)",
"complainedRecipients":[
{
"emailAddress":"recipient1@example.com"
}
],
"complaintFeedbackType":"abuse",
"arrivalDate":"2009-12-03T04:24:21.000-05:00",
"timestamp":"2012-05-25T14:59:38.623Z",
"feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"
}
```
### Penerima yang diadukan
Bidang `complainedRecipients` berisi daftar penerima yang mungkin telah mengirimkan aduan. Anda harus menggunakan informasi ini untuk menentukan penerima mana yang mengajukan keluhan, dan kemudian segera menghapus penerima itu dari milis Anda.
**penting**
Sebagian besar ISPs menghapus alamat email penerima yang mengajukan keluhan dari pemberitahuan keluhan mereka. Untuk alasan ini, daftar ini berisi informasi tentang penerima yang mungkin telah mengirim aduan, berdasarkan penerima pesan asli dan ISP tempat kami menerima aduan tersebut. SES melakukan pencarian terhadap pesan asli untuk menentukan daftar penerima ini.
Objek JSON dalam daftar ini berisi bidang berikut.
| Nama bidang | Deskripsi |
| --- | --- |
| emailAddress | Alamat email penerima. |
Berikut ini adalah contoh objek penerima yang diadukan.
```
{ "emailAddress": "recipient1@example.com" }
```
**catatan**
Karena perilaku ini, Anda dapat lebih yakin bahwa Anda mengetahui alamat email yang mengadu tentang pesan Anda jika Anda membatasi pengiriman ke satu pesan per penerima (daripada mengirim satu pesan dengan 30 alamat email yang berbeda di baris bcc).
#### Tipe aduan
Anda mungkin melihat tipe aduan berikut di bidang `complaintFeedbackType` seperti yang ditetapkan oleh ISP pelaporan, menurut [situs web Internet Assigned Numbers Authority](http://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2):
+ `abuse`—Menunjukkan email yang tidak diminta atau jenis penyalahgunaan email lainnya.
+ `auth-failure`—Laporan kegagalan autentikasi email.
+ `fraud`—Menunjukkan beberapa jenis penipuan atau aktivitas pengelabuan.
+ `not-spam`—Menunjukkan bahwa entitas yang menyediakan laporan tidak menganggap pesan tersebut sebagai spam. Tindakan ini dapat digunakan untuk memperbaiki pesan yang salah ditandai atau dikategorikan sebagai spam.
+ `other`—Menunjukkan umpan balik lain yang tidak sesuai dengan tipe terdaftar lainnya.
+ `virus`—Laporan bahwa virus ditemukan dalam pesan asal.
## Objek pengiriman
Objek JSON yang berisi informasi tentang pengiriman selalu memiliki bidang berikut.
| Nama bidang | Deskripsi |
| --- | --- |
| timestamp | Waktu SES mengirimkan email ke server email penerima (dalam ISO8601 format). |
| processingTimeMillis | Waktu dalam milidetik antara saat SES menerima permintaan dari pengirim untuk meneruskan pesan ke server email penerima. |
| recipients | Daftar penerima yang dimaksudkan dari email yang diterapkan notifikasi pengiriman. |
| smtpResponse | Pesan respons SMTP dari ISP jarak jauh yang menerima email dari SES. Pesan ini bervariasi menurut email, menurut server email penerima, dan menurut ISP penerima. |
| reportingMTA | Nama host dari server surat SES yang mengirim surat. |
| remoteMtaIp | Alamat IP MTA tempat SES mengirimkan email. |
Berikut ini adalah contoh dari objek `delivery`.
```
{
"timestamp":"2014-05-28T22:41:01.184Z",
"processingTimeMillis":546,
"recipients":["success@simulator.amazonses.com"],
"smtpResponse":"250 ok: Message 64111812 accepted",
"reportingMTA":"a8-70.smtp-out.amazonses.com",
"remoteMtaIp":"127.0.2.0"
}
```
# Contoh notifikasi Amazon SNS untuk Amazon SES
Bagian berikut memberikan contoh tiga tipe notifikasi:
+ Untuk contoh notifikasi pentalan, lihat [Contoh notifikasi pentalan Amazon SNS](#notification-examples-bounce).
+ Untuk contoh notifikasi aduan, lihat [Contoh notifikasi aduan Amazon SNS](#notification-examples-complaint).
+ Untuk contoh notifikasi pengiriman, lihat [Contoh notifikasi pengiriman Amazon SNS](#notification-examples-delivery).
## Contoh notifikasi pentalan Amazon SNS
Bagian ini berisi contoh notifikasi pentalan dengan dan tanpa Delivery Status Notification (DSN) yang disediakan oleh penerima email yang mengirimkan umpan balik.
### Notifikasi pentalan dengan DSN
Berikut ini adalah contoh dari notifikasi pentalan yang berisi DSN dan header email asli. Ketika notifikasi pentalan tidak dikonfigurasi untuk menyertakan header email asli, objek `mail` dalam notifikasi tidak menyertakan bidang `headersTruncated`, `headers`, dan `commonHeaders`.
```
{
"notificationType":"Bounce",
"bounce":{
"bounceType":"Permanent",
"reportingMTA":"dns; email.example.com",
"bouncedRecipients":[
{
"emailAddress":"jane@example.com",
"status":"5.1.1",
"action":"failed",
"diagnosticCode":"smtp; 550 5.1.1 ... User"
}
],
"bounceSubType":"General",
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa068a-000000",
"remoteMtaIp":"127.0.2.0"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"messageId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa0680-000000",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
### Notifikasi pentalan tanpa DSN
Berikut ini adalah contoh dari notifikasi pentalan yang menyertakan header email asli tetapi tidak menyertakan DSN. Ketika notifikasi pentalan tidak dikonfigurasi untuk menyertakan header email asli, objek `mail` dalam notifikasi tidak menyertakan bidang `headersTruncated`, `headers`, dan `commonHeaders`.
```
{
"notificationType":"Bounce",
"bounce":{
"bounceType":"Permanent",
"bounceSubType": "General",
"bouncedRecipients":[
{
"emailAddress":"jane@example.com"
},
{
"emailAddress":"richard@example.com"
}
],
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"00000137860315fd-869464a4-8680-4114-98d3-716fe35851f9-000000",
"remoteMtaIp":"127.0.2.0"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"00000137860315fd-34208509-5b74-41f3-95c5-22c1edc3c924-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
## Contoh notifikasi aduan Amazon SNS
Bagian ini berisi contoh notifikasi aduan dengan dan tanpa laporan umpan balik yang diberikan oleh penerima email yang mengirimkan umpan balik.
### Notifikasi aduan dengan laporan umpan balik
Berikut ini adalah notifikasi aduan yang berisi laporan umpan balik dan header email asli. Ketika notifikasi aduan tidak dikonfigurasi untuk menyertakan header email asli, objek `mail` dalam notifikasi tidak menyertakan bidang `headersTruncated`, `headers`, dan `commonHeaders`.
```
{
"notificationType":"Complaint",
"complaint":{
"userAgent":"AnyCompany Feedback Loop (V0.01)",
"complainedRecipients":[
{
"emailAddress":"richard@example.com"
}
],
"complaintFeedbackType":"abuse",
"arrivalDate":"2016-01-27T14:59:38.237Z",
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
### Notifikasi aduan tanpa laporan umpan balik
Berikut ini adalah contoh notifikasi aduan yang menyertakan header email asli namun tidak menyertakan laporan umpan balik. Ketika notifikasi aduan tidak dikonfigurasi untuk menyertakan header email asli, objek `mail` dalam notifikasi tidak menyertakan bidang `headersTruncated`, `headers`, dan `commonHeaders`.
```
{
"notificationType":"Complaint",
"complaint":{
"complainedRecipients":[
{
"emailAddress":"richard@example.com"
}
],
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"0000013786031775-fea503bc-7497-49e1-881b-a0379bb037d3-000000"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"0000013786031775-163e3910-53eb-4c8e-a04a-f29debf88a84-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
## Contoh notifikasi pengiriman Amazon SNS
Berikut ini adalah contoh notifikasi pengiriman yang menyertakan header email asli. Ketika notifikasi pengiriman tidak dikonfigurasi untuk menyertakan header email asli, objek `mail` dalam notifikasi tidak menyertakan bidang `headersTruncated`, `headers`, dan `commonHeaders`.
```
{
"notificationType":"Delivery",
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"0000014644fe5ef6-9a483358-9170-4cb4-a269-f5dcdf415321-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:58:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:58:45 +0000",
"to":[
"Jane Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
},
"delivery":{
"timestamp":"2016-01-27T14:59:38.237Z",
"recipients":["jane@example.com"],
"processingTimeMillis":546,
"reportingMTA":"a8-70.smtp-out.amazonses.com",
"smtpResponse":"250 ok: Message 64111812 accepted",
"remoteMtaIp":"127.0.2.0"
}
}
```