З Mailgun на Mailtrap:
Довідник з міграції

Цей довідник розкриває основні принципи безпроблемного переходу з Mailgun на Mailtrap: порівняння термінології, конфігурацій SMTP або API та інші технічні характеристики, необхідні для плавного переходу.

Відмінності між Mailtrap і Mailgun

  1. Залежно від тарифного плану, Mailtrap зберігає логи імейлів до 30 днів. Контент імейлів та інші дані – від 3 до 15 днів.
  2. Mailtrap пропонує тарифні плани зі щомісячною оплатою. На відміну від Mailgun, у Mailtrap немає оплати “по факту використання”.
  3. Mailtrap пропонує Bulk Stream – окрему імейл інфраструктуру, що дозволяє відправляти електронні листи багатьом отримувачам одразу (новинні розсилки, маркетингові кампейни, оновлення продукту тощо)
  4. Mailtrap пропонує комплексний функціонал для тестування імейлів. Тестування допомагає перевіряти спам-показники кожного імейлу, верифікувати HTML/CSS код, дозволяє знаходити та виправляти баги на стейджингу, у розробницькому середовищі перед тим, як надсилати імейли одержувачам.
  5. З Mailtrap не можна налаштувати надсилання імейлів на пізнішу дату.

Спільне між Mailtrap і Mailgun

  1. Підтримка надсилання імейлів за допомогою SMTP або REST API. 
  2. Можна використовувати return-path та DKIM для верифікації домену.
  3. Під час надсилання з нового домену пропускна здатність регулюється чергою.
  4. Можна додати файл .csv, щоб імпортувати suppressions.
  5. Як Mailgun, так і Mailtrap надають можливість додавати функцію “відписатися” від імейлу без застосування коду.

Порівняння термінології

  • Multi User Access
  • Mailgun Templates
  • Suppressions
  • Tags 
  • Webhooks
  • X-headers
  • X-Mailgun-Variables 

Інструкція для покрокової міграції

  1. Після реєстрації в сервісі Mailtrap, перейдіть на вкладку Sending Domains. Додайте свій домен відправника і верифікуйте його.

  2. Якщо ви обираєте SMTP, змініть налаштування надсилання у своєму застосунку відповідно до облікових даних, які надає Mailtrap. Перегляньте інформацію під табом SMTP нижче.

  3. Якщо ви вибрали інтеграцію API, перевірте API-документацію та бібліотеки Mailtrap.

  4. Ретельно вивчіть основні відмінності між Mailtrap і Mailgun згадані вище.

    Потрібна допомога?

    Зверніться до нашої служби підтримки, і наші технічні експерти допоможуть.

  5. Якщо ви плануєте надсилати більше 200 тисяч електронних листів на місяць, рекомендуємо звернутися до служби підтримки Mailtrap. Ми раді допомогти, просто заплануйте дзвінок з представником нашої команди, і ми подбаємо про те, щоб ваша міграція відбулась без проблем.

    Рекомендація Mailtrap

    Використовуйте гем Ruby ActionMailer Balancer щоб пропорційно розподілити обсяги розсилки електронної пошти між двома різними імейл-сервісами (наприклад, 60% Mailgun і 40% Mailtrap), щоб зменшити ризики розсилки.

З чого почати

Розпочати роботу з Mailtrap досить просто. Створіть обліковий запис, додайте домен, верифікуйте його з вкладки Sending Domains у меню і відправте свій перший імейл. Ознайомтесь з нашим Getting Started Guide для детальної інформації.

Верифікація домену

  • Після того як ви створите обліковий запис і додасте домен відправника, перевірка займе до двох робочих днів. Поки триває верифікація домену, пропускна здатність надсилання імейлів обмежена до 50 електронних листів на годину, щоб запобігти спам-зловживаннями системи. Ознайомтесь з нашею статтею Sending Limits, щоб дізнатися більше.
  • Надзвичайно важливо не вносити ніяких змін і не видаляти дані поки домен проходить верифікацію, адже це буде розцінено, як підозріла активність відправника.
  • Обмеження кількості надісланих імейлів можна зняти звернувшись до служби підтримки Mailtrap. Для цього вам потрібно буде відповісти на низку питань, щоб підтвердити надійність вашого домену.
  • Переконайтесь, що ви налаштували опцію “Відписатися” в імейлах та імпортували з Mailgun свої списки адресатів, яким не потрібно надсилати мейли.

SMTP

Ендпоінти SMTP

Сервер Mailgun (EU)Сервеp Mailgun (US)
live.smtp.mailtrap.io
bulk.smtp.mailtrap.io		smtp.eu.mailgun.orgsmtp.mailgun.org

Порти SMTP

ПортФункція
587Рекомендований SMTP із TSL
25Значний обсяг трафіку, блокується деякими імейл-провайдерами через зловживання
2525Альтернативний порт у разі проблем з використанням інших

Налаштування SMTP

Після успішної верифікації домену, оберіть SMTP у вкладці SMTP/API Settings. Потім виберіть Transactional Stream або Bulk Stream залежно від типу імейлів, які ви хочете надсилати.

Скопіюйте з Mailtrap і вставте у свій проєкт облікові дані. Відправте підтверджуючий імейл, щоб верифікувати налаштування. Для більш детальної інформації, ознайомтесь з нашою статтею Sending Domain Setup.

Примітка: увімкнення TLS є обов’язковим, як зазначено в облікових даних.

API

Токени Mailtrap API

Mailtrap автоматично створює токен з усталеним доступом Domain Admin, коли ви додаєте домен відправника. Ви можете змінити доступ цього токену, щоб авторизувати його з іншими доменами в обліковому записі.

Дізнайтеся більше про те, як керувати токенами API, у нашому довіднику.

Мапінг API

Тип APIMailtrapMailgun
The BasicsGeneralIntroduction
SendingSend emailMessages
Email TestingEmail Testing API

Бібліотеки API

Наразі в Mailtrap доступні чотири бібліотеки.

Мова програмуванняMailtrapMailgun
NodeJSNodeJS SDKMailgunJS
RubyRuby SDKMailgun Ruby Gem
PHPPHP SDKMailgunPHP
PythonPython SDKНе підтримується
ElixirElixir SDKНе підтримується

Автентифікація API

Mailtrap використовує Bearer-автентифікацію. Передайте токен API в код імейла під хедером Authorization.

Доступ/User management

Починаючи з тарифного плану Business і вище, ви можете додавати користувачів у свій обліковий запис і керувати їхніми доступами. В меню Settings клікніть на User Management і оберіть зі списку, кого ви хочете додати і які доступи вони отримають.

Відповідно до типу доступу, користувачі зможуть переглядати, керувати чи змінювати певні функції у проєкті. Лише Admin доступ дозволяє пройти автентифікацію та надсилати імейли через API.

Ознайомтесь докладніше з інформацією про доступи користувачів.

ActionMailer Balancer для безпроблемної міграції

Для проєктів, створених на Ruby on Rails, Mailtrap пропонує ActionMailer Balancer, який полегшує міграцію. ActionMailer дозволяє пропорційно розподілити обсяги надсилання електронної пошти між двома різними імейл-сервісами, щоб зменшити ризики і збалансувати розсилку через різних провайдерів.

Після того як ви встановите Balancer у свій проєкт і зробите налаштування, він розширить метод надсилання ActionMailer.
Докладну інформацію про застосування балансеру для розробників можна знайти на нашій Github сторінці ActionMailer Balancer.