तपाईंलाई एउटा Mailgun खाता र तपाईंको डोमेनको DNS मा पहुँच आवश्यक पर्नेछ।
Mailgun को आफ्नै कागजात: Adding and verifying a domain · API keys · Sign up
१. Mailgun मा आफ्नो पठाउने डोमेन थप्नुहोस्
Mailgun ड्यासबोर्डमा Send → Domains → Add New Domain मा जानुहोस् र एउटा सबडोमेन प्रविष्ट गर्नुहोस्, उदाहरणका लागि mail.yourdomain.com।
⚠️ Mailgun को आफ्नै मार्गदर्शन सबडोमेन प्रयोग गर्ने हो, र यो केही अन्य प्रदायकहरूको तुलनामा यहाँ बढी महत्त्वपूर्ण हुन्छ: तपाईंले जे उपलब्ध गराउनुहुन्छ, Mailgun ले त्यसमै आफ्ना SPF र DKIM रेकर्डहरू सेट गर्दछ, र यसलाई तपाईंको मूल (root) डोमेनमा देखाउनुको अर्थ ती रेकर्डहरू तपाईंको व्यावसायिक मेलबक्सहरू निर्भर रहने रेकर्डहरूसँगै बस्छन्।
तपाईं आफ्नो डेटा जहाँ रहन चाहनुहुन्छ त्यसैसँग मेल खाने क्षेत्र छान्नुहोस् — US वा EU। यसलाई कतै टिपेर राख्नुहोस्; तपाईंलाई चरण ४ मा यसको आवश्यकता पर्नेछ, र यो सबैभन्दा बढी गलत हुने सामान्य कुरा हो।
२. Mailgun ले तपाईंलाई दिने DNS रेकर्डहरू प्रकाशित गर्नुहोस्
Mailgun ले तपाईंलाई एउटा सूची देखाउँछ। ती प्रत्येकलाई आफ्नो DNS प्रदायकमा थप्नुहोस्।
| Type | Host | Purpose |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | DKIM सार्वजनिक कुञ्जी (public key) |
CNAME | email.mail.yourdomain.com | ट्र्याकिङ र बाउन्स व्यवस्थापन |
MX | mail.yourdomain.com | बाउन्सहरू प्राप्त गर्ने (Mailgun का दुई MX होस्टहरू) |
⛔ यदि तपाईंको पठाउने सबडोमेनमा पहिले नै एउटा SPF रेकर्ड छ भने, त्यसलाई सम्पादन गर्नुहोस् — दोस्रो नथप्नुहोस्। दुईवटा SPF TXT रेकर्डहरू भएको डोमेनले SPF पूर्ण रूपमा असफल गराउँछ, जुन कुनै पनि रेकर्ड नहुनुभन्दा पनि खराब हो।
त्यसपछि Mailgun मा Verify DNS Settings थिच्नुहोस्। हरियो हुन एक घण्टासम्म लाग्न सक्छ।
⭐ तपाईंले पठाउने काम मात्र गरिरहनुभएको भए तापनि MX रेकर्डहरू थप्नुहोस्। Mailgun ले बाउन्सहरू सङ्कलन गर्ने तरिका नै यिनै हुन्। तिनीहरू बिना खराब ठेगाना कतै नपुगी बाउन्स हुन्छ, Mailgun ले त्यसलाई दबाउन (suppress गर्न) सक्दैन, र तपाईं कहिल्यै केही प्राप्त नगर्ने ठेगानामा पठाउनका लागि भुक्तानी गरिरहनुहुन्छ।
३. आफ्नो API कुञ्जी प्राप्त गर्नुहोस्
Send → Sending → Domain settings → API keys, वा तपाईंको खाताको API Keys पृष्ठ।
यदि तपाईंको योजनाले उपलब्ध गराउँछ भने, आफ्नो खाताको निजी (private) API कुञ्जीको सट्टा यस डोमेनमा मात्र सीमित गरिएको sending key प्रयोग गर्नुहोस्। एउटा sending key ले पठाउने काम मात्र गर्न सक्छ; निजी कुञ्जीले तपाईंका लगहरू पढ्न र तपाईंको खाता परिवर्तन गर्न सक्छ। हामीले दोस्रो कुञ्जी राख्नुपर्ने कुनै कारण छैन।
४. यसलाई 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 खाताबाट कुञ्जी टाँस्नुभयो। यसलाई पुन: टाइप गर्नुभन्दा नयाँ कुञ्जी उत्पन्न (regenerate) गर्नुहोस्; अगाडिको key- छुट्न सजिलो हुन्छ।
परीक्षण सन्देश कहिल्यै आइपुग्दैन — Mailgun को Logs पृष्ठ जाँच गर्नुहोस्। यदि Mailgun सँग यसको कुनै पनि रेकर्ड छैन भने, विवरण (credential) वा डोमेन नाम गलत छ। यदि Mailgun ले यसलाई स्वीकार गर्यो र पछि असफल भयो भने, कारण त्यहाँ स्पष्ट शब्दहरूमा हुनेछ, र यो प्रायः जसो DNS नै हुन्छ।
"Domain not found" — Mailgun sending domain फिल्ड ठ्याक्कै Mailgun ले सूचीकृत गरेअनुसारको सबडोमेन सहितको डोमेन हुनुपर्छ। yourdomain.com र mail.yourdomain.com Mailgun का लागि दुई फरक डोमेनहरू हुन्।
यसले काम गर्यो र त्यसपछि रोकियो — तपाईंको निःशुल्क परीक्षण समाप्त भयो कि भएन जाँच गर्नुहोस्। Mailgun परीक्षण खाताहरूले अधिकृत प्राप्तकर्ताहरू (authorised recipients) लाई मात्र पठाउन सक्छन्, त्यसैले तपाईंको आफ्नै ठेगानामा पठाइएको परीक्षण सन्देशले काम गरिरहन्छ तर तपाईंका ग्राहकहरूलाई जाने सबै कुराहरू भने चुपचाप रोकिन्छन्।