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

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

Mailgun کی اپنی دستاویزات: Adding and verifying a domain · API keys · Sign up

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

Mailgun ڈیش بورڈ میں Send → Domains → Add New Domain پر جائیں اور ایک سب ڈومین درج کریں، مثال کے طور پر mail.yourdomain.com۔

⚠️ Mailgun کی اپنی رہنمائی ایک سب ڈومین تجویز کرتی ہے، اور یہ یہاں دیگر فراہم کنندگان کی نسبت زیادہ اہمیت رکھتا ہے: Mailgun آپ کے فراہم کردہ نام پر اپنے SPF اور DKIM ریکارڈز سیٹ کرتا ہے، اور اسے اپنے روٹ ڈومین کی طرف پوائنٹ کرنے کا مطلب ہے کہ یہ ریکارڈز ان ریکارڈز کے شانہ بشانہ آ جاتے ہیں جن پر آپ کے کاروباری میل بکسز انحصار کرتے ہیں۔

اس خطے کا انتخاب کریں جو اس بات کے مطابق ہو کہ آپ اپنا ڈیٹا کہاں محفوظ رکھنا چاہتے ہیں — US یا EU۔ اسے نوٹ کر لیں؛ آپ کو مرحلہ 4 میں اس کی ضرورت ہوگی، اور یہ وہ واحد چیز ہے جس میں سب سے زیادہ غلطی کی جاتی ہے۔

2. وہ DNS ریکارڈز شائع کریں جو Mailgun آپ کو فراہم کرتا ہے

Mailgun آپ کو ایک فہرست دکھاتا ہے۔ اپنے DNS فراہم کنندہ کے پاس ان میں سے ہر ایک کو شامل کریں۔

⛔ اگر آپ کے بھیجنے والے سب ڈومین کا پہلے سے کوئی SPF ریکارڈ موجود ہے، تو اسے ایڈٹ کریں — دوسرا شامل نہ کریں۔ دو SPF TXT ریکارڈز والا ڈومین SPF میں مکمل طور پر فیل ہو جاتا ہے، جو کہ بالکل کوئی ریکارڈ نہ ہونے سے بھی بدتر ہے۔

پھر Mailgun میں Verify DNS Settings کو دبائیں۔ سبز ہونے میں ایک گھنٹے تک کا وقت لگ سکتا ہے۔

⭐ MX ریکارڈز شامل کریں اگرچہ آپ صرف ای میلز بھیج رہے ہوں۔ انہی کے ذریعے Mailgun باؤنسز جمع کرتا ہے۔ ان کے بغیر غلط ایڈریس کہیں بھی باؤنس نہیں ہوتا، Mailgun اسے سپریس (suppress) نہیں کر سکتا، اور آپ ایسے ایڈریس پر بھیجنے کے لیے پیسے ادا کرتے رہتے ہیں جو کبھی کچھ وصول نہیں کرے گا۔

3. اپنی API کی (key) حاصل کریں

Send → Sending → Domain settings → API keys، یا اپنے اکاؤنٹ کا API Keys صفحہ۔

اگر آپ کا پلان پیش کرتا ہے تو اپنے اکاؤنٹ کی پرائیویٹ API کی کے بجائے اس ڈومین کے لیے مخصوص sending key استعمال کریں۔ بھیجنے والی کی (sending key) صرف بھیج سکتی ہے؛ پرائیویٹ کی آپ کے لاگز پڑھ سکتی ہے اور آپ کے اکاؤنٹ میں تبدیلیاں کر سکتی ہے۔ ہمارے لیے دوسری والی کو رکھنے کی کوئی وجہ نہیں ہے۔

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

اپنے ڈیش بورڈ میں Email sending کھولیں اور مندرجہ ذیل کو پُر کریں:

• Provider — Mailgun
• Send from this domain — mail.yourdomain.com (ایک ڈومین، نہ کہ ایک ایڈریس)
• Mailgun sending domain — وہی ڈومین جو آپ نے Mailgun میں شامل کیا ہے
• Region — مرحلہ 1 سے مطابقت رکھتا ہوا، us یا eu
• Mailgun API key — مرحلہ 3 والی کی

⛔⛔ خطہ (region) درست رکھیں۔ EU میں ہوسٹ کیے گئے Mailgun اکاؤنٹس بالکل مختلف API ہوسٹ سے چلائے جاتے ہیں۔ EU اکاؤنٹ کی کی US ہوسٹ کو بھیجنے پر "401 Unauthorized" موصول ہوتا ہے — جو کہ بالکل غلط کی کے جیسا ہی لگتا ہے۔ اگر آپ کی کی یقینی طور پر درست ہے اور آپ کو 401 موصول ہو رہا ہے، تو تقریباً ہمیشہ اس کی یہی وجہ ہوتی ہے۔

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

کسی دوسرے ڈومین پر موجود ان باکس کا استعمال کرتے ہوئے Send test message کو دبائیں — ایک Gmail ایڈریس بہترین ہے۔ اس ان باکس سے کوڈ پڑھیں اور اسے درج کریں۔ آپ کی میل فوری طور پر منتقل ہو جاتی ہے۔

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

401 Unauthorized — غلط خطہ (اوپر دیکھیں)، یا آپ نے کسی مختلف Mailgun اکاؤنٹ سے کی پیسٹ کر دی ہے۔ اسے دوبارہ ٹائپ کرنے کے بجائے دوبارہ جنریٹ کریں؛ شروع کا key- باآسانی چھوٹ سکتا ہے۔

ٹیسٹ میسج کبھی نہیں پہنچتا — Mailgun کا Logs صفحہ چیک کریں۔ اگر Mailgun کے پاس اس کا بالکل کوئی ریکارڈ نہیں ہے، تو اسناد (credential) یا ڈومین کا نام غلط ہے۔ اگر Mailgun نے اسے قبول کر لیا اور وہ بعد میں ناکام ہو گیا، تو اس کی وجہ وہاں واضح الفاظ میں موجود ہوگی، اور یہ تقریباً ہمیشہ DNS ہی ہوتا ہے۔

"Domain not found" — Mailgun sending domain فیلڈ کا بالکل وہی ڈومین ہونا ضروری ہے جیسا کہ Mailgun میں درج ہے، بشمول سب ڈومین۔ Mailgun کے نزدیک yourdomain.com اور mail.yourdomain.com دو مختلف ڈومینز ہیں۔

اس نے کام کیا اور پھر رک گیا — چیک کریں کہ آیا آپ کا مفت ٹرائل ختم تو نہیں ہو گیا۔ Mailgun ٹرائل اکاؤنٹس صرف مجاز وصول کنندگان (authorised recipients) کو ہی بھیج سکتے ہیں، لہٰذا آپ کے اپنے ایڈریس پر ٹیسٹ میسج کام کرتا رہتا ہے جبکہ آپ کے کلائنٹس کو جانے والی ہر چیز خاموشی سے رک جاتی ہے۔