আপনার একটি Mailgun অ্যাকাউন্ট এবং আপনার ডোমেইনের DNS-এ অ্যাক্সেস প্রয়োজন হবে।
Mailgun-এর নিজস্ব ডকুমেন্টেশন: একটি ডোমেইন যোগ ও যাচাই করা · API কী · নিবন্ধন
১. Mailgun-এ আপনার প্রেরণ ডোমেইন যোগ করুন
Mailgun ড্যাশবোর্ডে Send → Domains → Add New Domain-এ যান এবং একটি সাবডোমেইন লিখুন, উদাহরণস্বরূপ mail.yourdomain.com।
⚠️ Mailgun-এর নিজস্ব নির্দেশনা হলো একটি সাবডোমেইন, এবং এখানে এটি কিছু প্রদানকারীর তুলনায় বেশি গুরুত্বপূর্ণ: Mailgun আপনি যা দেবেন তার উপর নিজস্ব SPF এবং DKIM রেকর্ড সেট করে, এবং এটি আপনার রুট ডোমেইনের দিকে নির্দেশ করলে সেই রেকর্ডগুলি আপনার ব্যবসায়িক মেইলবক্সগুলি যেগুলির উপর নির্ভর করে সেগুলির পাশেই বসে।
যেখানে আপনি আপনার ডেটা রাখতে চান তার সাথে মিলে এমন অঞ্চল বেছে নিন — US অথবা EU। এটি লিখে রাখুন; ধাপ ৪-এ আপনার এটি প্রয়োজন হবে, এবং এটিই ভুল হওয়ার সবচেয়ে সাধারণ বিষয়।
২. Mailgun আপনাকে যে DNS রেকর্ড দেয় সেগুলি প্রকাশ করুন
Mailgun আপনাকে একটি তালিকা দেখায়। আপনার DNS প্রদানকারীতে সেগুলির প্রতিটি যোগ করুন।
| ধরন | হোস্ট | উদ্দেশ্য |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | DKIM পাবলিক কী |
CNAME | email.mail.yourdomain.com | ট্র্যাকিং এবং বাউন্স পরিচালনা |
MX | mail.yourdomain.com | বাউন্স গ্রহণ (Mailgun-এর দুটি MX হোস্ট) |
⛔ যদি আপনার প্রেরণ সাবডোমেইনে ইতিমধ্যে একটি SPF রেকর্ড থাকে, সেটি সম্পাদনা করুন — দ্বিতীয়টি যোগ করবেন না। দুটি SPF TXT রেকর্ডযুক্ত একটি ডোমেইন SPF-এ সরাসরি ব্যর্থ হয়, যা একেবারে না থাকার চেয়েও খারাপ।
তারপর Mailgun-এ Verify DNS Settings চাপুন। সবুজ হতে এক ঘণ্টা পর্যন্ত সময় লাগতে পারে।
⭐ আপনি শুধুমাত্র পাঠাচ্ছেন বলেও MX রেকর্ডগুলি যোগ করুন। এগুলি দিয়েই Mailgun বাউন্স সংগ্রহ করে। এগুলি ছাড়া একটি খারাপ ঠিকানা কোথাও না গিয়ে বাউন্স হয়, Mailgun সেটি সাপ্রেস করতে পারে না, এবং আপনি এমন একটি ঠিকানায় পাঠাতে অর্থ দিতে থাকেন যা কখনোই কিছু গ্রহণ করবে না।
৩. আপনার API কী নিন
Send → Sending → Domain settings → API keys, অথবা আপনার অ্যাকাউন্টের API Keys পৃষ্ঠা।
যদি আপনার প্ল্যানে থাকে তবে আপনার অ্যাকাউন্টের প্রাইভেট API কী-এর পরিবর্তে এই ডোমেইনে সীমাবদ্ধ একটি প্রেরণ কী ব্যবহার করুন। একটি প্রেরণ কী শুধুমাত্র পাঠাতে পারে; প্রাইভেট কী আপনার লগ পড়তে এবং আপনার অ্যাকাউন্ট পরিবর্তন করতে পারে। দ্বিতীয়টি আমাদের কাছে রাখার কোনো কারণ নেই।
৪. Zinn®-এ এটি সংযুক্ত করুন
আপনার ড্যাশবোর্ডে ইমেইল প্রেরণ খুলুন এবং পূরণ করুন:
- প্রদানকারী — Mailgun
- এই ডোমেইন থেকে পাঠান —
mail.yourdomain.com (একটি ডোমেইন, কোনো ঠিকানা নয়)
- Mailgun প্রেরণ ডোমেইন — Mailgun-এ আপনি যে ডোমেইন যোগ করেছেন সেই একই ডোমেইন
- অঞ্চল —
us অথবা eu, ধাপ ১-এর সাথে মিল রেখে
- Mailgun API কী — ধাপ ৩-এর কী
⛔⛔ অঞ্চলটি সঠিক রাখুন। EU-হোস্টেড Mailgun অ্যাকাউন্টগুলি সম্পূর্ণ ভিন্ন API হোস্ট থেকে পরিবেশিত হয়। একটি EU অ্যাকাউন্টের কী US হোস্টে পাঠালে "401 Unauthorized" ফিরে আসে — যা ঠিক একটি ভুল কী-এর মতোই পড়া যায়। যদি আপনার কী নিশ্চিতভাবে সঠিক হয় এবং আপনি 401 পাচ্ছেন, প্রায় সবসময় এই কারণেই হয়।
৫. পরীক্ষা পাঠান এবং কোড লিখুন
পরীক্ষা বার্তা পাঠান চাপুন, একটি ভিন্ন ডোমেইনের ইনবক্স ব্যবহার করে — একটি Gmail ঠিকানা আদর্শ। সেই ইনবক্স থেকে কোডটি পড়ে তা লিখুন। আপনার মেইল তৎক্ষণাৎ স্যুইচ হয়ে যায়।
যখন এটি কাজ করে না
401 Unauthorized — ভুল অঞ্চল (উপরে দেখুন), অথবা আপনি একটি ভিন্ন Mailgun অ্যাকাউন্ট থেকে একটি কী পেস্ট করেছেন। পুনরায় টাইপ করার পরিবর্তে কীটি নতুন করে তৈরি করুন; শুরুর key- হারিয়ে যাওয়া সহজ।
পরীক্ষা বার্তা কখনোই পৌঁছায় না — Mailgun-এর Logs পৃষ্ঠা পরীক্ষা করুন। যদি Mailgun-এ এর কোনো রেকর্ডই না থাকে, তবে ক্রেডেনশিয়াল বা ডোমেইন নাম ভুল। যদি Mailgun এটি গ্রহণ করে এবং পরে ব্যর্থ হয়, কারণটি সেখানে সাধারণ ভাষায় থাকবে, এবং প্রায় সবসময়ই তা DNS।
"Domain not found" — Mailgun প্রেরণ ডোমেইন ক্ষেত্রটি অবশ্যই ঠিক সেই ডোমেইন হতে হবে যা Mailgun তালিকাভুক্ত করে, সাবডোমেইনসহ। yourdomain.com এবং mail.yourdomain.com Mailgun-এর কাছে দুটি ভিন্ন ডোমেইন।
এটি কাজ করেছিল এবং তারপর বন্ধ হয়ে গেছে — আপনার ফ্রি ট্রায়াল শেষ হয়েছে কিনা পরীক্ষা করুন। Mailgun ট্রায়াল অ্যাকাউন্টগুলি শুধুমাত্র অনুমোদিত প্রাপকদের কাছে পাঠাতে পারে, তাই আপনার নিজের ঠিকানায় পরীক্ষা বার্তা কাজ করতে থাকে যখন আপনার ক্লায়েন্টদের কাছে সবকিছু নীরবে কাজ করে না।