Email Spam Tester

Home › Integrasi › Panduan › SendGrid

Panduan · tanpa koneksi

Menguji email SendGrid

SendGrid sebenarnya memiliki dua pengirim dalam satu login, yaitu layar Marketing Campaigns dan Email API. Keduanya menambahkan header yang berbeda pada email Anda, sehingga cara pengujiannya sedikit berbeda.

Panduan · SendGrid

Uji email dari SendGrid

Satu alamat, satu email, berlaku selama satu jam. Tanpa akun, tanpa kunci API.

Dapatkan alamat pengujian

Langkah 1

Autentikasi domain

Autentikasi domain: CNAME di em[0000], dua CNAME DKIM, dan TXT DMARC.

Langkah 2

Kirim satu email asli ke alamat pengujian

Single Send ke daftar berisi satu kontak, atau satu panggilan curl ke /v3/mail/send.

Langkah 3

Baca laporan

Cari "via sendgrid.net", baris penyelarasan, dan header berhenti berlangganan.

Newsletter yang dibuat di Single Sends dan email pengaturan ulang kata sandi yang dikirim melalui /v3/mail/send dapat berasal dari akun SendGrid yang sama, tetapi tetap diterima sebagai email yang cukup berbeda. Perbedaan ini penting dalam pengujian spam. Marketing Campaigns selalu mencoba menambahkan header berhenti berlangganan, sedangkan API hanya menambahkannya jika Anda memintanya. Jadi, tentukan mana yang ingin Anda uji sebelum mengirim apa pun.

Proses penerimaannya sama untuk keduanya. Email Spam Tester memberi Anda alamat sementara tanpa perlu membuat akun. Hanya pesan pertama yang masuk dalam waktu satu jam yang akan diperiksa. Pesan tersebut akan mendapatkan laporan yang mencakup autentikasi, hasil penilaian SpamAssassin dan Rspamd, konten, aturan pengirim massal yang ditetapkan Gmail dan Yahoo, serta pemeriksaan terhadap 21 daftar blokir menggunakan IP pengirim Anda.

Single Sends: tombol pengujian dan prefiksnya

Pengujian bawaan tersedia di Marketing > Single Sends. Buka Single Send, cari Test Your Email, masukkan alamat pengujian, lalu klik Send Test Message. SendGrid meminta pengirim dan subjek sebelum Anda dapat melakukan pengujian. Jika subjek menggunakan Handlebars, Test Data harus diisi. Saat dikirim, SendGrid menambahkan Test - di depan baris subjek.

Untuk pengujian sebenarnya, kirim Single Send ke sebuah daftar. Single Sends dikirim ke daftar atau segmen, jadi buat daftar yang hanya berisi alamat pengujian sebagai kontak, lalu pilih daftar tersebut di bagian Recipients. Dengan begitu, header, tautan berhenti berlangganan, dan tautan yang dilacak sama seperti yang diterima pelanggan. Jika Anda juga menjalankan pengujian inbox, inbox penyedianya dapat ditambahkan ke daftar tersebut.

API dan SMTP: satu perintah curl

Disederhanakan dari contoh memulai SendGrid, dengan alamat pengujian sebagai penerima:

curl --request POST \
  --url https://api.sendgrid.com/v3/mail/send \
  --header 'Authorization: Bearer <<YOUR_API_KEY>>' \
  --header 'Content-Type: application/json' \
  --data '{"personalizations":[{"to":[{"email":"test-xxxxxxxxxxxxxxxxxxxx@t.email-spam-tester.com"}],"subject":"Hello, World!"}],"content":[{"type":"text/plain","value":"Heya!"}],"from":{"email":"you@yourdomain.com","name":"Your Name"}}'

Saat uji penempatan inbox aktif, alamat inbox penyedia Anda dimasukkan ke array to yang sama dan penanda dimasukkan ke subject, sehingga satu permintaan tersebut juga memberi tahu Anda folder tempat Gmail, Outlook, Yahoo, dan penyedia lain menaruh email.

Masukkan alamat pengujian Anda sendiri dan alamat From yang telah diverifikasi SendGrid, melalui verifikasi pengirim tunggal atau autentikasi domain. Lebih baik lagi, kirim pesan yang benar-benar dikirim aplikasi Anda, dengan HTML aslinya, karena pemeriksaan konten akan menilai isi email.

Jika aplikasi Anda menggunakan SMTP, tidak ada yang berubah selain metode pengirimannya. Host-nya adalah smtp.sendgrid.net, nama penggunanya secara harfiah adalah string apikey (bukan kunci Anda), dan SSL berjalan di port 465.

Ada juga endpoint pengiriman uji, POST /v3/marketing/test/send_email. Endpoint ini menerima hingga 10 alamat, tetapi hanya berfungsi dengan Dynamic Transactional Templates. Jadi, untuk sebagian besar email API, panggilan Mail Send biasa di atas adalah pengujian yang sebenarnya.

Header berhenti berlangganan bergantung pada jalur yang Anda pilih

Marketing Campaigns mencoba menambahkan header List-Unsubscribe setiap kali. Email yang dikirim melalui API atau SMTP hanya mendapatkannya jika Subscription Tracking diaktifkan di Settings > Tracking. Dalam hal ini, SendGrid menyisipkan List-Unsubscribe dengan tautan HTTPS dan List-Unsubscribe-Post: List-Unsubscribe=One-Click.

Tanpa Subscription Tracking, Anda menambahkan sendiri header tersebut dalam permintaan:

"headers": {
  "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
  "List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}

SendGrid meminta bagian mailto dan https, serta memperingatkan agar Anda tidak menghentikan langganan siapa pun melalui GET biasa ke tautan tersebut. Berhati-hatilah saat menyalin dari artikel dukungan SendGrid tentang header ini. Contoh keduanya mengatur List-Unsubscribe-Post ke URL, dan itu salah. Nilainya selalu List-Unsubscribe=One-Click. Selebihnya tersedia di halaman perbaikan List-Unsubscribe.

Jika pesan berupa pengaturan ulang kata sandi atau tanda terima dan tidak memiliki header milis, laporan menandai grup aturan pengirim massal sebagai dilewati, bukan gagal. Newsletter yang dikirim melalui API tidak mendapatkan pengecualian tersebut.

Membaca hasil autentikasi

Pada akun tanpa autentikasi domain, penerima melihat "via sendgrid.net" setelah alamat From Anda, dan dokumentasi SendGrid menyatakan bahwa autentikasi domain akan menghapusnya. Laporan memberikan informasi lebih dari sekadar label tersebut. Periksa baris penyelarasan DKIM dan SPF. Jika tanda tangan atau return path menggunakan domain SendGrid, bukan domain Anda, DMARC tidak dapat lolos untuk alamat From Anda, dan rencana perbaikan akan mengarahkan Anda ke autentikasi domain. Mengirim dari alamat gmail.com atau yahoo.com bahkan lebih buruk. Halaman DMARC SendGrid menyatakan bahwa SPF dan DKIM gagal untuk keduanya, dan konsolnya juga memperingatkan bahwa pesan seperti itu mungkin gagal dalam pemeriksaan DMARC.

Autentikasi domain berada di Settings > Sender Authentication. Jika keamanan otomatis aktif, yang merupakan pengaturan default, SendGrid memberi Anda empat record:

  • CNAME di em[0000], yang mencakup SPF dan menjadi return path Anda;
  • CNAME di s1._domainkey dan s2._domainkey untuk DKIM;
  • TXT di _dmarc dengan v=DMARC1; p=none;.

Nilai contoh. Salin nilai sebenarnya dari akun Anda.

NamaJenisNilaiKegunaanSalin
Keamanan otomatis aktif (default)
em[0000]CNAMETarget dari akun AndaSPF dan return path.
s1._domainkeyCNAMETarget dari akun AndaDKIM.
s2._domainkeyCNAMETarget dari akun AndaDKIM, selector kedua.
_dmarcTXTv=DMARC1; p=none;DMARC.
Keamanan otomatis nonaktif
em[0000]MXHost dari akun AndaReturn path.
em[0000]TXTv=spf1 include:sendgrid.net ~allSPF, yang Anda kelola sendiri.
m1._domainkeyTXTKunci dari akun AndaDKIM.

Jika keamanan otomatis nonaktif, Anda mendapatkan MX dan TXT SPF (v=spf1 include:sendgrid.net ~all) di em[0000], ditambah TXT DKIM di m1._domainkey, dan Anda mengelola record SPF sendiri. Jika penyedia DNS Anda menolak nama CNAME yang berisi _, ini adalah satu-satunya opsi. Jika layanan lain sudah menggunakan selector s, SendGrid memungkinkan Anda memilih selector khusus. Periksa hasilnya dengan pemeriksa DKIM (selector s1) dan pemeriksa SPF, yang juga menghitung pencarian DNS jika record SPF Anda mulai terlalu padat.

Pelacakan klik menulis ulang setiap tautan. Jika teks tautan Anda berupa URL, alamat yang terlihat dan target sebenarnya tidak lagi cocok, lalu pemeriksaan ketidakcocokan tautan dalam laporan akan menandainya. Halaman keterkiriman SendGrid menjelaskan masalah yang sama. Gunakan kata-kata sebagai teks tautan, atau siapkan branding tautan agar tautan yang dilacak melewati domain Anda sendiri, yang harus cocok dengan domain From Anda.

Paket Trial dan Essentials mengirim dari kumpulan IP bersama. SendGrid menyatakan bahwa IP tersebut dapat berubah tanpa pemberitahuan jika reputasi Anda berubah, sehingga masuknya salah satu IP ke daftar blokir berdampak pada semua pengguna dalam kumpulan tersebut. Pemeriksa daftar blokir memungkinkan Anda memeriksa kembali IP tersebut nanti. Reverse DNS hanya dapat dikonfigurasi dengan IP khusus, yang tersedia dalam Pro Email API dan Advanced Marketing Campaigns.

Pertanyaan

Mengapa email saya menampilkan "via sendgrid.net"?

SendGrid belum mengautentikasi domain pengiriman Anda. Siapkan autentikasi domain di Settings > Sender Authentication. Menurut dokumentasi SendGrid, label tersebut kemudian akan hilang.

Laporan menyebutkan List-Unsubscribe tidak ada, tetapi saya menggunakan SendGrid. Mengapa?

Anda mungkin mengirim melalui API atau SMTP dengan Subscription Tracking dinonaktifkan. Aktifkan di Settings > Tracking atau tambahkan sendiri kedua header tersebut dalam objek headers.

Bisakah saya menggunakan "Send Test Message" dari SendGrid untuk pengujian ini?

Ya, pesan akan sampai ke alamat pengujian. Namun, subjek akan diterima dengan awalan Test - . Untuk mendapatkan header yang sama persis seperti yang diterima pelanggan, Single Send ke daftar yang berisi satu kontak lebih mendekati kondisi sebenarnya.

Bisakah saya menggunakan endpoint API test-send sebagai pengganti Mail Send?

Hanya untuk Dynamic Transactional Templates, karena /v3/marketing/test/send_email hanya menerima jenis tersebut. Endpoint ini mendukung hingga 10 alamat. Semua jenis lainnya dikirim melalui /v3/mail/send.

Selector mana yang harus saya masukkan ke pemeriksa DKIM?

Jika keamanan otomatis aktif, periksa s1 dan s2. Jika nonaktif, selectornya adalah m1. Jika Anda memilih selector khusus saat penyiapan, gunakan selector tersebut.

Panduan untuk platform lain

Semua integrasi dan panduan →

Uji email sekarang

Satu alamat, satu email, berlaku selama satu jam. Tanpa akun. Laporan tersusun otomatis setelah pemeriksaan selesai.

Dapatkan alamat pengujian