تاسو به د Mailgun حساب او د خپل ډومین DNS ته لاسرسي ته اړتیا ولرئ.
د Mailgun خپل اسناد: د ډومین اضافه کول او تاییدول · د API کیليګانې · نوم لیکنه وکړئ
۱. خپل د لېږلو ډومین په Mailgun کې اضافه کړئ
د Mailgun په ډېشبورډ کې Send → Domains → Add New Domain ته لاړ شئ او یو subdomain داخل کړئ، د بېلګې په توګه mail.yourdomain.com.
⚠️ د Mailgun خپله لارښوونه فرعي ډومین (subdomain) دی، او دلته دا چاره د ځینو نورو برابروونکو په پرتله ډېره مهمه ده: Mailgun هر هغه څه چې ورکوئ خپل د SPF او DKIM ریکارډونه پرې تنظیموي، او ستاسو اصلي ډومین ته د هغې اشاره کول په دې مانا دي چې دا ریکارډونه د هغو تر څنګ ځای نیسي چې ستاسو سوداګریز ایمیلونه پرې تکیه کوي.
هغه سیمه وټاکئ چې ستاسو د معلوماتو د ساتلو ځای سره سمون خوري — US یا EU. هغه ولیکئ؛ تاسو به ورته په څلورم ګام کې اړتیا ولرئ، او دا تر ټولو عام شی دی چې تېروتنه پکې کېږي.
۲. هغه DNS ریکارډونه خپاره کړئ چې Mailgun یې تاسو ته درکوي
Mailgun تاسو ته یو لست ښیي. د خپل DNS چمتوکوونکي سره د هغوی هر یو اضافه کړئ.
| Type | Host | Purpose |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | د DKIM عامه کیلي |
CNAME | email.mail.yourdomain.com | تعقیب او د بېرته ګرځېدو (bounce) اداره کول |
MX | mail.yourdomain.com | د بېرته راګرځېدلو ترلاسه کول (د Mailgun دوه MX کوربانه) |
⛔ که ستاسو د لېږلو فرعي ډومین لا دمخه د SPF ریکارډ لري، هغه سم کړئ — دویم مه اضافه کوئ. یو ډومین چې دوه د SPF TXT ریکارډونه لري په مستقیم ډول SPF ناکاموي، چې دا بیخي د هیڅ ریکارډ نه لرلو څخه هم بدتر دی.
بیا په Mailgun کې Verify DNS Settings کېکاږئ. دا ښايي تر یو ساعت پورې وخت ونیسي چې شین شي.
⭐ د MX ریکارډونه اضافه کړئ که څه هم تاسو یوازې لېږل کوئ. هغوی هغه لار ده چې Mailgun بېرته ګرځېدلي (bounces) راټولوي. د هغوی پرته یو ناسم ادرس هیڅ ځای ته نه بېرته ګرځي، Mailgun نشي کولی هغه ودروي، او تاسو یو داسې ادرس ته د لېږلو لپاره تادیه جاري ساتئ چې هیڅکله به هیڅ شی ترلاسه نکړي.
۳. خپله د API کیلي ترلاسه کړئ
Send → Sending → Domain settings → API keys، یا ستاسو د حساب د API Keys پاڼه.
د دې ډومین لپاره ټاکل شوې یوه sending key وکاروئ که ستاسو پلان داسې یوه وړاندې کوي، نه ستاسو د حساب خصوصي API کیلي. د لېږلو کیلي یوازې لېږل کولی شي؛ خصوصي کیلي کولی شي ستاسو لاګونه ولولي او ستاسو حساب بدل کړي. زموږ لپاره د دویمې کیلي د ساتلو هیڅ دلیل نشته.
۴. دا په Zinn® کې ونښلوئ
په خپل ډېشبورډ کې Email sending پرانیزئ او لاندې برخې ډکې کړئ:
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com (یو ډومین، نه یو ادرس)
- Mailgun sending domain — کټ مټ همغه ډومین لکه څنګه چې تاسو په Mailgun کې اضافه کړی
- Region —
us یا eu، د لومړي ګام سره سم
- Mailgun API key — د ۳ ګام څخه ترلاسه شوې کیلي
⛔⛔ سیمه سمه وټاکئ. د EU کوربه توب شوي Mailgun حسابونه د یو بشپړ جلا API کوربه لخوا خدمت کیږي. د EU حساب کیلي د US کوربه ته لېږل "401 Unauthorized" بیرته راګرځوي — چې کټ مټ د یوې ناسمې کیلي په څېر ښکاري. که ستاسو کیلي یقیناً سمه وي او تاسو 401 ترلاسه کوئ، نو دا نږدې تل همدا لامل وي.
۵. ازموینه ولېږئ او کوډ داخل کړئ
Send test message کېکاږئ، په یو بل ډومین کې د انباګس په کارولو سره — د Gmail یو ادرس خورا مناسب دی. له هغه انباګس څخه کوډ ولولئ او داخل یې کړئ. ستاسو ایمیل سمدستي بدلیږي.
کله چې دا کار نه کوي
401 Unauthorized — ناسمه سیمه (پورته وګورئ)، یا تاسو د بل Mailgun حساب څخه کیلي کاپي کړې وي. د بیا ټایپ کولو پرځای کیلي له سره جوړه کړئ؛ پیل کې key- په اسانۍ سره هېرېدای شي.
د ازموینې پیغام هیڅکله نه رسیږي — د Mailgun د Logs پاڼه وګورئ. که چیرې Mailgun د دې هیڅ ریکارډ ونه لري، باورلیک یا د ډومین نوم غلط دی. که Mailgun هغه ومنله او وروسته ناکامه شوه، نو لامل به یې هلته په واضحو ټکو کې موجود وي، او دا نږدې تل DNS وي.
"Domain not found" — د Mailgun sending domain ساحه باید کټ مټ هغه ډومین وي لکه څنګه چې Mailgun یې لست کوي، د فرعي ډومین په شمول. yourdomain.com او mail.yourdomain.com د Mailgun لپاره دوه مختلف ډومینونه دي.
کار یې وکړ او بیا ودرېد — وګورئ چې ایا ستاسو وړیا ازموینه پای ته رسېدلې که نه. د Mailgun ازمویښتي حسابونه یوازې تایید شویو ترلاسه کوونکو ته لېږل کولی شي، نو ستاسو خپل ادرس ته د ازموینې پیغام کار کوي پداسې حال کې چې ستاسو پیرودونکو ته هرڅه په پټه توګه نه لېږل کیږي.