Za ku buƙaci asusun Mailgun da kuma damar shiga DNS na yankin sunanku (domain).
Takaddun jagora na Mailgun kansa: Adding and verifying a domain · API keys · Sign up
1. Ƙara yankin sunan aikawa na ku a Mailgun
A cikin dashboard na Mailgun je zuwa Send → Domains → Add New Domain sannan ku shigar da ƙaramin yankin suna (subdomain), misali mail.yourdomain.com.
⚠️ Shawarar Mailgun kanta ita ce amfani da ƙaramin yankin suna, kuma hakan yana da muhimmanci a nan fiye da sauran masu bada sabis: Mailgun yana saita nasa bayanan SPF da DKIM akan duk abin da kuka ba shi, kuma nuna shi zuwa babban yankin sunanku yana nufin waɗannan bayanan za su zauna tare da waɗanda akwatunan saƙon kasuwancinku suka dogara da su.
Zaɓi yankin da ya dace da inda kuke son adana bayananku — US ko EU. Rubuta shi a gefe; za ku buƙace shi a mataki na 4, kuma shi ne babban abin da aka fi samun kuskure a kansa.
2. Buga bayanan DNS ɗin da Mailgun ya ba ku
Mailgun zai nuna muku lissafi. Ƙara kowannensu a wajen mai ba ku sabis na DNS.
| Type | Host | Purpose |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | Maɓallin jama'a na DKIM |
CNAME | email.mail.yourdomain.com | Bibiya da kula da saƙonnin da suka dawo ba a isar ba (bounce) |
MX | mail.yourdomain.com | Karɓar saƙonnin da suka dawo ba a isar ba (bayanai biyu na MX na Mailgun) |
⛔ Idan ƙaramin yankin sunan aikawarku yana da bayanan SPF a riga, ku gyara shi — kada ku ƙara na biyu. Yankin suna da ke da bayanan TXT na SPF guda biyu zai gaza a SPF gaba ɗaya, wanda hakan ya fi rashin samun ko ɗaya muni.
Sannan ku danna Verify DNS Settings a cikin Mailgun. Yana iya ɗaukar har zuwa awa ɗaya kafin ya nuna kore.
⭐ Ƙara bayanan MX koda kuwa aikawa kawai kuke yi. Su ne yadda Mailgun ke tattara saƙonnin da ba su isa ba. In ba tare da su ba saƙon da ya tafi adireshin da ba daidai ba zai dawo babu inda zai nufa, Mailgun ba zai iya hana sake tura masa ba, kuma za ku ci gaba da biyan kuɗin aikawa zuwa adireshin da ba zai taɓa karɓar komai ba.
3. Samu maɓallin API na ku
Send → Sending → Domain settings → API keys, ko shafin API Keys na asusunku.
Yi amfani da maɓallin aikawa (sending key) wanda ke da alaƙa da wannan yankin suna idan tsarinku yana ba da shi, maimakon maɓallin API na sirri na asusunku. Maɓallin aikawa aiki kawai zai iya yi; maɓallin sirri na iya karanta bayanan tarihinku (logs) da kuma canza asusunku. Babu wani dalili da zai sa mu riƙe na biyun.
4. Haɗa shi a cikin Zinn®
Buɗe Email sending a cikin dashboard ɗinku sannan ku cika:
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com (yankin suna, ba adireshi ba)
- Mailgun sending domain — yankin suna ɗaya da wanda kuka ƙara a cikin Mailgun
- Region —
us ko eu, daidai da mataki na 1
- Mailgun API key — maɓallin daga mataki na 3
⛔⛔ Ku tabbatar yankin ya zama daidai. Asusun Mailgun da ke karɓar baƙuncin EU ana sarrafa su ne daga wani uwar garken API daban kwata-kwata. Aika maɓallin asusun EU zuwa uwar garken US yana dawo da "401 Unauthorized" — wanda ke nuna kamar maɓallin ne ba daidai ba. Idan kun tabbata maɓallinku yana da inganci kuma kuna samun 401, kusan a kowane lokaci wannan ne dalilin.
5. Aika gwaji kuma shigar da lambar sirri
Danna Send test message, ta amfani da akwatin saƙo mai yankin suna daban — adireshin Gmail ya fi dacewa. Duba lambar sirrin daga wannan akwatin saƙon sannan ku shigar da ita. Saƙonku zai canza zuwa sabon tsarin nan take.
Idan abin bai yi aiki ba
401 Unauthorized — yanki ba daidai ba (duba sama), ko kuma kun ɗora maɓallin da aka kwakwalo daga wani asusun Mailgun daban. Sake samar da maɓallin maimakon sake rubuta shi; yana da sauƙin mantawa da key- da ke gaba.
Saƙon gwaji bai taɓa isowa ba — duba shafin Logs na Mailgun. Idan Mailgun ba shi da wani bayanin aikawarsa kwata-kwata, bayanan shiga ko sunan yankin ne ba daidai ba. Idan Mailgun ya karɓe shi sannan ya gaza daga baya, za a rubuta dalilin a fili da kalmomi masu sauƙi, kuma kusan koyaushe matsalar DNS ce.
"Domain not found" — filin Mailgun sending domain dole ne ya zama daidai da yadda yankin sunan yake a lissafin Mailgun, har da ƙaramin yankin sunan. yourdomain.com da mail.yourdomain.com yankunan suna ne guda biyu mabanbanta ga Mailgun.
Ya yi aiki sannan ya tsaya — bincika ko lokacin gwajinku na kyauta ya ƙare. Asusun gwaji na Mailgun za su iya aikawa ne kawai zuwa masu karɓa da aka amince da su, don haka saƙon gwaji zuwa adireshinku zai ci gaba da aiki yayin da duk wani abu da zai tafi zuwa ga abokan cinikinku ba zai tafi ba a ɓoye.