Изпращане на имейл през вашия собствен акаунт в Mailgun

Свържете собствения си акаунт в Mailgun: добавяне на поддомейн за изпращане, SPF, DKIM и MX записите за публикуване, ключ за изпращане вместо вашия личен API ключ и защо хостваният в EU акаунт връща грешка 401 срещу хоста в US.

Ще ви трябват акаунт в Mailgun и достъп до DNS на вашия домейн.

Собствената документация на Mailgun: Добавяне и потвърждаване на домейн · API ключове · Регистрация

1. Добавете вашия домейн за изпращане в Mailgun

В таблото за управление на Mailgun отидете на Send → Domains → Add New Domain (Изпращане → Домейни → Добавяне на нов домейн) и въведете поддомейн, например mail.yourdomain.com.

⚠️ Собствените указания на Mailgun посочват поддомейн и тук това е по-важно, отколкото при някои други доставчици: Mailgun задава свои собствени SPF и DKIM записи на всичко, което му подадете, а насочването му към основния ви домейн означава, че тези записи застават редом до тези, на които разчитат вашите бизнес пощенски кутии.

Изберете региона, който отговаря на мястото, където искате да се съхраняват вашите данни — US или EU. Запишете го; ще ви трябва в стъпка 4 и това е най-често срещаната грешка.

2. Публикувайте DNS записите, които Mailgun ви предоставя

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 | Получаване на отхвърлени писма (двата MX хоста на Mailgun) |

⛔ Ако вашият поддомейн за изпращане вече има SPF запис, редактирайте го — не добавяйте втори. Един домейн с два SPF TXT записа се проваля напълно при SPF проверките, което е по-лошо от липсата на каквито и да било записи.

След това натиснете Verify DNS Settings (Потвърждаване на DNS настройките) в Mailgun. Може да отнеме до един час, за да стане зелено.

⭐ Добавете MX записите, дори ако само изпращате. Чрез тях Mailgun събира отхвърлените съобщения. Без тях невалидният адрес се връща в нищото, Mailgun не може да го блокира и вие продължавате да плащате за изпращане до адрес, който никога няма да получи нищо.

3. Вземете своя API ключ

Send → Sending → Domain settings → API keys (Изпращане → Изпращане → Домейни настройки → API ключове) или страницата API Keys (API ключове) на вашия акаунт.

Използвайте ключ за изпращане, ограничен до този домейн, ако вашият план предлага такъв, вместо частния API ключ на вашия акаунт. Ключът за изпращане може само да изпраща; частният ключ може да чете вашите логове и да променя акаунта ви. Няма причина ние да съхраняваме втория.

4. Свържете го в Zinn®

Отворете Email sending (Имейл изпращане) в таблото си за управление и попълнете:

Provider (Доставчик) — Mailgun
Send from this domain (Изпращане от този домейн) — mail.yourdomain.com (домейн, а не адрес)
Mailgun sending domain (Домейн за изпращане на Mailgun) — същият домейн, който добавихте в Mailgun
Region (Регион) — us или eu, съответстващ на стъпка 1
Mailgun API key (API ключ на Mailgun) — ключът от стъпка 3

⛔⛔ Уцелете правилния регион. Хостваните в EU акаунти в Mailgun се обслужват от напълно различен API хост. Изпращането на ключа на EU акаунт към US хоста връща съобщение "401 Unauthorized" ("401 Неупълномощен достъп") — което изглежда точно като грешен ключ. Ако ключът ви определено е верен и получавате 401, почти винаги причината е тази.

5. Изпратете теста и въведете кода

Натиснете Send test message (Изпращане на тестово съобщение), като използвате пощенска кутия на различен домейн — Gmail адрес е идеален. Прочетете кода от тази пощенска кутия и го въведете. Пощата ви превключва незабавно.

Когато не работи

401 Unauthorized — грешен регион (вижте по-горе) или сте поставили ключ от друг акаунт в Mailgun. Генерирайте ключа отново, вместо да го преписвате; началният текст key- лесно се изпуска.

Тестовото съобщение така и не пристига — проверете страницата Logs (Логове) на Mailgun. Ако Mailgun няма никакъв запис за него, идентификационните данни или името на домейна са грешни. Ако Mailgun го е приел и то се е провалило впоследствие, причината ще бъде там с ясни думи и тя почти винаги е свързана с DNS.

"Domain not found" ("Домейнът не е намерен") — полето Mailgun sending domain (Домейн за изпращане на Mailgun) трябва да бъде точно домейнът, както е посочен в Mailgun, включително поддомейна. yourdomain.com и mail.yourdomain.com са два различни домейна за Mailgun.

Работеше и след това спре — проверете дали безплатният ви пробен период не е изтекъл. Пробните акаунти в Mailgun могат да изпращат само до оторизирани получатели, така че тестовото съобщение до вашия собствен адрес продължава да работи, докато всичко към вашите клиенти тихо спира да работи.