Anda akan memerlukan akun SendGrid (Twilio SendGrid) dan akses ke DNS domain Anda.
Dokumentasi SendGrid sendiri: Autentikasi pengirim · Kunci API · Daftar
1. Autentikasi domain Anda
Settings → Sender Authentication → Authenticate Your Domain.
Pilih host DNS Anda dari daftar, dan jawab Yes untuk pertanyaan "Would you like to also brand the links for this domain?" — penjenamaan tautan (link branding) menulis ulang tautan yang dilacak ke domain Anda sendiri, bukan sendgrid.net, dan klien yang mengarahkan kursor ke tautan di faktur Anda seharusnya melihat nama Anda.
Masukkan sebuah subdomain seperti mail.yourdomain.com saat diminta domain asal pengiriman Anda.
2. Publikasikan data CNAME
SendGrid memberi Anda tiga atau lima data CNAME. Tambahkan semuanya.
| Tipe | Host | Tujuan |
|---|
CNAME | em1234.yourdomain.com | Domain return-path (pantulan) |
CNAME | s1._domainkey.yourdomain.com | Kunci DKIM 1 |
CNAME | s2._domainkey.yourdomain.com | Kunci DKIM 2 |
⭐ SendGrid sengaja menggunakan CNAME daripada data TXT, dan ini memang jauh lebih baik: nilai kunci yang sebenarnya berada di SendGrid, sehingga mereka dapat merotasi kunci penandatanganan mereka tanpa Anda harus mengubah DNS Anda lagi.
⚠️ Jika penyedia DNS Anda adalah Cloudflare, atur data ini ke DNS only (awan abu-abu), bukan melalui proksi (proxied). CNAME yang diproksikan akan mengarah ke alamat Cloudflare dan pemeriksaan SendGrid akan gagal.
Tekan Verify di SendGrid. Berikan waktu hingga satu jam.
3. Buat kunci API
Settings → API Keys → Create API Key.
Pilih Restricted Access dan berikan izin Mail Send → Full Access saja. Tidak ada yang lain.
⛔ Jangan gunakan kunci Full Access. Kunci Full Access dapat membaca kontak Anda, mengubah pengaturan akun Anda, dan membuat kunci tambahan; satu-satunya hal yang perlu kami lakukan adalah mengirim pesan. Jika salinan kunci Anda di sistem kami sampai bocor, perbedaan antara kedua kunci tersebut adalah perbedaan antara beberapa email yang tidak diinginkan dan akun yang disusupi.
⚠️ Kunci ini hanya ditampilkan sekali. Salin sebelum Anda meninggalkan halaman tersebut — SendGrid tidak dapat menampilkannya lagi kepada Anda, hanya dapat menggantinya.
4. Hubungkan di Zinn®
Buka Pengiriman email di dasbor Anda:
- Penyedia — SendGrid
- Kirim dari domain ini —
mail.yourdomain.com (sebuah domain, bukan alamat email)
- Kunci API SendGrid — kunci dari langkah 3
SendGrid tidak memerlukan pengaturan lain dari Anda.
5. Kirim uji coba dan masukkan kodenya
Tekan Kirim pesan uji coba ke kotak masuk di domain yang berbeda, baca kodenya, dan masukkan kode tersebut.
Jika tidak berfungsi
403 Forbidden — kunci API Anda tidak memiliki izin Mail Send. Ini adalah kegagalan yang paling umum terjadi: kunci Restricted Access yang dibuat tanpa mencentang cakupan apa pun dapat terautentikasi dengan sempurna tetapi tidak diizinkan melakukan apa pun.
"The from address does not match a verified Sender Identity" — autentikasi domain Anda belum berstatus hijau, atau domain di Kirim dari domain ini bukan domain yang Anda autentikasi. SendGrid memeriksa domain secara presisi: mengautentikasi mail.yourdomain.com tidak memberikan izin pengiriman dari yourdomain.com.
Accepted but never delivered — periksa Activity di SendGrid. Akun yang benar-benar baru terkadang ditahan untuk ditinjau selama sekitar satu hari pertama, dan pesan-pesan tersebut tertahan di sana alih-alih memantul (bounce).
Akun Anda ditangguhkan setelah beberapa kali pengiriman — SendGrid sangat ketat terhadap akun baru yang mengirim ke alamat yang memantul. Pastikan daftar klien Anda bersih sebelum Anda beralih.