اپنے ذاتی SendGrid اکاؤنٹ کے ذریعے ای میل بھیجیں

آپ کو SendGrid (Twilio SendGrid) اکاؤنٹ اور اپنے ڈومین کے DNS تک رسائی درکار ہوگی۔

SendGrid کی اپنی دستاویزات: Sender authentication · API keys · سائن اپ کریں

1. اپنے ڈومین کی تصدیق کریں

Settings → Sender Authentication → Authenticate Your Domain۔

فہرست میں سے اپنے DNS ہوسٹ کا انتخاب کریں، اور "Would you like to also brand the links for this domain?" کا جواب Yes دیں — لنک برانڈنگ ٹریک کیے گئے لنکس کو sendgrid.net کے بجائے آپ کے اپنے ڈومین پر دوبارہ لکھتی ہے، اور آپ کے انوائس میں موجود لنک پر کرسر لے جانے والے صارف کو آپ کا نام نظر آنا چاہیے۔

جب اس ڈومین کے بارے میں پوچھا جائے جہاں سے آپ بھیجتے ہیں، تو ایک ذیلی ڈومین (subdomain) درج کریں جیسے کہ mail.yourdomain.com۔

2. CNAME ریکارڈز شائع کریں

SendGrid آپ کو تین یا پانچ CNAME ریکارڈز فراہم کرتا ہے۔ ان سب کو شامل کریں۔

⭐ SendGrid جان بوجھ کر TXT ریکارڈز کے بجائے CNAMEs کا استعمال کرتا ہے، اور یہ واقعی بہتر ہے: کلید کی اصل قدریں SendGrid کے پاس رہتی ہیں، تاکہ وہ آپ کے DNS کو دوبارہ چھیڑے بغیر اپنی دستخطی کلیدوں کو تبدیل کر سکیں۔

⚠️ اگر آپ کا DNS فراہم کنندہ Cloudflare ہے، تو ان ریکارڈز کو DNS only (سرمئی بادل) پر سیٹ کریں، پراکسیڈ نہیں۔ ایک پراکسیڈ CNAME کلاؤڈ فلیئر کے پتے پر حل ہوتا ہے اور SendGrid کی جانچ ناکام ہو جاتی ہے۔

SendGrid میں Verify پر کلک کریں۔ ایک گھنٹے تک کا وقت دیں۔

3. ایک API کلید بنائیں

Settings → API Keys → Create API Key۔

Restricted Access کا انتخاب کریں اور صرف Mail Send → Full Access کی اجازت دیں۔ اس کے علاوہ کچھ نہیں۔

⛔ مکمل رسائی (Full Access) والی کلید استعمال نہ کریں۔ Full Access کلید آپ کے رابطوں کو پڑھ سکتی ہے، آپ کے اکاؤنٹ کی ترتیبات تبدیل کر سکتی ہے اور مزید کلیدیں بنا سکتی ہے؛ ہمیں صرف ایک پیغام بھیجنے کی ضرورت ہے۔ اگر آپ کی کلید کی ہماری کاپی کبھی افشا ہو جاتی ہے، تو ان دو کلیدوں کے درمیان فرق چند ناپسندیدہ ای میلز اور ایک ہیک شدہ اکاؤنٹ کے درمیان کا فرق ہے۔

⚠️ کلید صرف ایک بار دکھائی جاتی ہے۔ صفحہ چھوڑنے سے پہلے اسے کاپی کر لیں — SendGrid اسے آپ کو دوبارہ نہیں دکھا سکتا، صرف تبدیل کر سکتا ہے۔

4. اسے Zinn® میں مربوط کریں

اپنے ڈیش بورڈ میں ای میل بھیجنا کھولیں:

• فراہم کنندہ — SendGrid
• اس ڈومین سے بھیجیں — mail.yourdomain.com (ایک ڈومین، پتہ نہیں)
• SendGrid API کلید — مرحلہ 3 سے حاصل کردہ کلید

SendGrid کو آپ کی طرف سے کسی اور ترتیب کی ضرورت نہیں ہے۔

5. ٹیسٹ بھیجیں اور کوڈ درج کریں

کسی مختلف ڈومین پر موجود ان باکس میں ٹیسٹ پیغام بھیجیں پر کلک کریں، اس میں سے کوڈ پڑھیں، اور اسے درج کریں۔

جب یہ کام نہ کرے

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 دیکھیں۔ بالکل نئے اکاؤنٹ کو بعض اوقات پہلے ایک دو دن کے لیے جائزے کے لیے روک دیا جاتا ہے، اور پیغامات باؤنس ہونے کے بجائے وہیں رکے رہتے ہیں۔

کچھ پیغامات بھیجنے کے بعد آپ کا اکاؤنٹ معطل کر دیا گیا تھا — SendGrid ان نئے اکاؤنٹس کے حوالے سے سخت ہے جو باؤنس ہونے والے پتوں پر پیغامات بھیجتے ہیں۔ منتقلی کرنے سے پہلے یقینی بنائیں کہ آپ کے کلائنٹس کی فہرست درست اور صاف ہے۔