ඔබට SendGrid (Twilio SendGrid) ගිණුමක් සහ ඔබේ වසමේ (domain) DNS වෙත ප්රවේශය අවශ්ය වනු ඇත.
SendGrid හි නිල ලේඛන: ප්රේරක සත්යාපනය · API යතුරු · ලියාපදිංචි වන්න
1. ඔබේ වසම සත්යාපනය කරන්න
Settings → Sender Authentication → Authenticate Your Domain.
ලැයිස්තුවෙන් ඔබේ DNS ධාරකයා (host) තෝරා, "Would you like to also brand the links for this domain?" යන ප්රශ්නයට Yes ලෙස පිළිතුරු දෙන්න — සබැඳි සන්නාමකරණය (link branding) මඟින් ලුහුබැඳි සබැඳි sendgrid.net වෙනුවට ඔබේම වසමට හරවා ලියනු ලබන අතර, ඔබේ ඉන්වොයිසියේ ඇති සබැඳියක් මත කර්සරය තබන සේවාදායකයෙකුට ඔබේ නම දිස්විය යුතුය.
ඔබ පණිවිඩ යවන වසම විමසූ විට mail.yourdomain.com වැනි උපවසමක් (subdomain) ඇතුළත් කරන්න.
2. CNAME වාර්තා ප්රකාශයට පත් කරන්න
SendGrid මඟින් ඔබට CNAME වාර්තා තුනක් හෝ පහක් ලබා දේ. ඒවා සියල්ලම එක් කරන්න.
| Type | Host | Purpose |
|---|
CNAME | em1234.yourdomain.com | ආපසු හැරවුම් මාර්ග (bounce) වසම |
CNAME | s1._domainkey.yourdomain.com | DKIM යතුර 1 |
CNAME | s2._domainkey.yourdomain.com | DKIM යතුර 2 |
⭐ SendGrid හිතාමතාම TXT වාර්තා වෙනුවට CNAME භාවිත කරයි, එය සැබවින්ම වඩා හොඳය: සත්ය යතුරු අගයන් SendGrid හි පවතින බැවින්, ඔබට නැවත ඔබේ DNS වෙනස් කිරීමට අවශ්ය නොවී ඔවුන්ට ඔවුන්ගේ අත්සන් කිරීමේ යතුරු මාරු කිරීමට (rotate) හැකිය.
⚠️ ඔබේ DNS සපයන්නා Cloudflare නම්, මෙම වාර්තා ප්රොක්සි කළ (proxied) නොවන ලෙස, DNS only (අළු පැහැති වලාකුළ) ලෙස සකසන්න. ප්රොක්සි කළ CNAME වාර්තාවක් Cloudflare හි ලිපින වෙත යොමු වන අතර SendGrid හි පරීක්ෂාව අසාර්ථක වේ.
SendGrid හි Verify ඔබන්න. පැයක් දක්වා කාලයක් ලබා දෙන්න.
3. API යතුරක් සාදන්න
Settings → API Keys → Create API Key.
Restricted Access තෝරා Mail Send → Full Access සඳහා පමණක් අවසර දෙන්න. වෙනත් කිසිවක් නැත.
⛔ Full Access යතුරක් භාවිත නොකරන්න. Full Access යතුරකට ඔබේ සම්බන්ධතා කියවීමට, ඔබේ ගිණුම් සැකසීම් වෙනස් කිරීමට සහ තවත් යතුරු සෑදීමට හැකිය; අපට අවශ්ය එකම දෙය පණිවිඩයක් යැවීම පමණි. අප සතු ඔබේ යතුරේ පිටපත කවදා හෝ අනාවරණය වුවහොත්, එම යතුරු දෙක අතර වෙනස වන්නේ අනවශ්ය ඊමේල් කිහිපයක් සහ සම්පූර්ණයෙන්ම අනතුරට ලක් වූ ගිණුමක් අතර වෙනසයි.
⚠️ යතුර පෙන්වනු ලබන්නේ එක් වරක් පමණි. ඔබ පිටුවෙන් පිටවීමට පෙර එය පිටපත් කරගන්න — SendGrid හට එය ඔබට නැවත පෙන්විය නොහැක, කළ හැක්කේ එය ප්රතිස්ථාපනය කිරීම පමණි.
4. එය Zinn® හි සම්බන්ධ කරන්න
ඔබේ උපකරණ පුවරුවේ (dashboard) Email sending විවෘත කරන්න:
- සපයන්නා — SendGrid
- මෙම වසමෙන් යවන්න —
mail.yourdomain.com (ලිපිනයක් නොව, වසමක්)
- SendGrid API යතුර — 3 වන පියවරේ යතුර
SendGrid සඳහා ඔබෙන් වෙනත් කිසිදු සැකසීමක් අවශ්ය නොවේ.
5. පරීක්ෂණ පණිවිඩය යවා කේතය ඇතුළත් කරන්න
වෙනත් වසමක ඇති එන ලිපි ගිණුමකට Send test message ඔබන්න, එහි ඇති කේතය කියවා එය ඇතුළත් කරන්න.
එය ක්රියා නොකරන විට
403 Forbidden — ඔබේ API යතුරට Mail Send අවසරය නොමැත. මෙය බොහෝ දුරට සිදුවන සුලභම අසාර්ථක වීමයි: කිසිදු ප්රවේශ සීමාවක් (scope) තෝරා නොගෙන සාදන ලද Restricted Access යතුරක් කිසිදු ගැටළුවක් නොමැතිව සත්යාපනය වන නමුත් කිසිවක් කිරීමට අවසර නොලැබේ.
"The from address does not match a verified Sender Identity" — ඔබේ වසම් සත්යාපනය තවමත් සාර්ථක වී නොමැත, නැතහොත් මෙම වසමෙන් යවන්න හි ඇති වසම ඔබ සත්යාපනය කළ එක නොවේ. SendGrid නිශ්චිත වසමම පරීක්ෂා කරයි: mail.yourdomain.com සත්යාපනය කිරීමෙන් yourdomain.com වෙතින් යැවීමට අවසර නොලැබේ.
භාර ගන්නා ලද නමුත් කිසිදා භාර දී නොමැත — SendGrid හි Activity බලන්න. අලුත්ම ගිණුමක් සමහර විට පළමු දිනය හෝ ඊට ආසන්න කාලයක් සමාලෝචනය සඳහා රඳවා තබා ගන්නා අතර, පණිවිඩ ආපසු නොඑවා එහිම රැඳී පවතී.
යැවීම් කිහිපයකට පසු ඔබේ ගිණුම අත්හිටුවන ලදී — ආපසු හැරී එන (bounce වන) ලිපින වෙත පණිවිඩ යවන නව ගිණුම් සම්බන්ධයෙන් SendGrid දැඩි වේ. ඔබ මාරු වීමට පෙර ඔබේ සේවාදායක ලැයිස්තුව නිවැරදි සහ පිරිසිදු බව තහවුරු කරගන්න.