Anda memerlukan akaun SendGrid (Twilio SendGrid) dan akses kepada DNS domain anda.
Dokumentasi SendGrid sendiri: Pengesahan penghantar · Kunci API · Daftar
1. Sahkan domain anda
Tetapan → Pengesahan Penghantar → Sahkan Domain Anda.
Pilih hos DNS anda daripada senarai, dan jawab Ya kepada "Adakah anda ingin turut menjenamakan pautan untuk domain ini?" — penjenamaan pautan menulis semula pautan yang dijejaki kepada domain anda sendiri dan bukannya sendgrid.net, dan pelanggan yang menuding kursor pada pautan dalam invois anda sepatutnya melihat nama anda.
Masukkan subdomain seperti mail.yourdomain.com apabila ditanya tentang domain tempat anda menghantar e-mel.
2. Terbitkan rekod CNAME
SendGrid memberikan anda tiga atau lima rekod CNAME. Tambahkan kesemuanya.
| Jenis | Hos | Tujuan |
|---|
CNAME | em1234.yourdomain.com | Domain laluan kembali (lantunan) |
CNAME | s1._domainkey.yourdomain.com | Kunci DKIM 1 |
CNAME | s2._domainkey.yourdomain.com | Kunci DKIM 2 |
⭐ SendGrid sengaja menggunakan CNAME dan bukannya rekod TXT, dan ia sememangnya lebih baik: nilai kunci sebenar berada di SendGrid, jadi mereka boleh menggilirkan kunci tandatangan mereka tanpa anda perlu mengubah DNS anda lagi.
⚠️ Jika penyedia DNS anda ialah Cloudflare, tetapkan rekod ini kepada DNS sahaja (awan kelabu), bukan diproksikan. CNAME yang diproksikan menyelesai kepada alamat Cloudflare dan semakan SendGrid akan gagal.
Tekan Sahkan di SendGrid. Berikan masa sehingga satu jam.
3. Cipta kunci API
Tetapan → Kunci API → Cipta Kunci API.
Pilih Akses Terhad dan berikan Penghantaran Mel → Akses Penuh sahaja. Tiada yang lain.
⛔ Jangan gunakan kunci Akses Penuh. Kunci Akses Penuh boleh membaca kenalan anda, menukar tetapan akaun anda dan mencipta lebih banyak kunci; satu-satunya perkara yang perlu kami lakukan ialah menghantar mesej. Jika salinan kunci anda pada pihak kami terdedah, perbezaan antara kedua-dua kunci tersebut adalah perbezaan antara beberapa e-mel yang tidak diingini dengan akaun yang terjejas.
⚠️ Kunci ini dipaparkan sekali sahaja. Salinnya sebelum anda meninggalkan halaman tersebut — SendGrid tidak boleh menunjukkannya kepada anda lagi, hanya menggantikannya.
4. Sambungkannya dalam Zinn®
Buka Penghantaran e-mel dalam papan pemuka anda:
- Penyedia — SendGrid
- Hantar daripada domain ini —
mail.yourdomain.com (domain, bukan alamat)
- Kunci API SendGrid — kunci daripada langkah 3
SendGrid tidak memerlukan tetapan lain daripada anda.
5. Hantar ujian dan masukkan kod
Tekan Hantar mesej ujian ke peti masuk pada domain yang berbeza, baca kod daripadanya, dan masukkannya.
Apabila ia tidak berfungsi
403 Dilarang — kunci API anda tidak mempunyai kebenaran Penghantaran Mel. Ini adalah kegagalan yang paling biasa berlaku: kunci Akses Terhad yang dicipta tanpa sebarang skop ditanda mengesahkan dengan sempurna tetapi tidak dibenarkan melakukan apa-apa.
"Alamat daripada tidak sepadan dengan Identiti Penghantar yang disahkan" — pengesahan domain anda belum bertukar hijau lagi, atau domain dalam Hantar daripada domain ini bukanlah domain yang anda sahkan. SendGrid menyemak domain yang tepat: mengesahkan mail.yourdomain.com tidak membenarkan penghantaran daripada yourdomain.com.
Diterima tetapi tidak pernah dihantar — lihat Aktiviti di SendGrid. Akaun serba baharu kadangkala ditahan untuk semakan bagi hari pertama atau lebih, dan mesej berada di sana dan bukannya melantun.
Akaun anda telah digantung selepas beberapa penghantaran — SendGrid sangat tegas mengenai akaun baharu yang menghantar ke alamat yang melantun. Pastikan senarai pelanggan anda bersih sebelum anda beralih.