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

У цьому довіднику міститься основна інформація про те, як максимально легко і зручно перейти з Mailchimp Transactional Email на Mailtrap. Тут описані ключові термінологічні відмінності, порівняння конфігурацій SMTP і API, вказано інші технічні специфікації.

Основні відмінності між Mailchimp і Mailtrap

  1. Залежно від тарифного плану, Mailtrap зберігає логи імейлів до 30 днів. Контент імейлів та інші дані – від 3 до 15 днів.
  2. Mailtrap пропонує комплексний функціонал для тестування імейлів. Тестування допомагає перевіряти спам-показники кожного імейлу, верифікувати HTML/CSS код, дозволяє знаходити та виправляти баги на стейджингу, у розробницькому середовищі перед тим, як надсилати імейли одержувачам.
  3. Mailtrap пропонує Bulk Stream – окрему імейл інфраструктуру, що дозволяє відправляти електронні листи багатьом отримувачам одразу (новинні розсилки, маркетингові кампейни, оновлення продукту тощо)
  4. Mailtrap робить автоматичну валідацію DMARC домену відправника (разом з SPF i DKIM).
  5. API Mailtrap приймають і повертають тільки JSON. Запити API не приймають параметри HTTP POST. Mailtrap не повертає API responses у форматах XML і YAML.
  6. Mailtrap не підтримує надсилання імейлів за графіком.
  7. У Mailtrap не можна автоматично генерувати HTML-контент з текстових частин імейлів і навпаки. Тип контенту має бути вказаний під час надсилання імейлу або під час створення шаблона.

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

  • Users
  • Templates
  • Rejection Blacklist
  • Tags
  • Webhooks
  • Headers
  • X-MC-Metadata

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

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

  2. Якщо ви використовуєте SMTP, змініть налаштування відповідним чином.

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

  4. Переконайтеся, що ви розумієте основні відмінності між Mailchimp Transactional Email і Mailtrap згадані вище.

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

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

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

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

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

З чого почати

Щоб почати надсилати імейли з Mailtrap, необхідно створити обліковий запис, додати і верифікувати свій домен. Налаштування та перевірку домену можна виконати у вкладці Sending Domains.

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

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

Надсилання з Mailtrap SMTP

Ендпоінти SMTP

Mailchimp Transactional Email
live.smtp.mailtrap.io
bulk.smtp.mailtrap.io		 smtp.mandrillapp.com

Порти SMTP

ПортФункціяMailtrapMailchimp
587Рекомендовано для зашифрованого з’єднання TLS SMTP
25Використання може бути проблематичним через блокування деякими постачальниками імейл- скриньок, щоб уникнути зловживань
2525Для незашифрованого/TLS
465Для підключення SSL SMTP

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

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

Скопіюйте та вставте облікові дані SMTP (для обраної вами інфраструктури) у ваш додаток.

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

Надсилання з Mailtrap API

Токени Mailtrap API

Коли ви реєструєте домен відправника, автоматично створюється токен. Він отримує назву за такою формулою: [ім’я домену] + [токен] + [токен ID]. Додавайте або видаляйте доступ до нього натиснувши на відповідні поля в меню Token.

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

Мапінг API

Тип APIMailtrapMailchimp Transactional Email
Email sendingSend emailMessages
User managementUser managementUsers
Email TestingEmail Testing API

Бібліотеки API

Наразі в Mailtrap доступні пʼять бібліотек.

Мова програмуванняMailtrapMailchimp Transactional Email
NodeJSNodeJS SDKNodeJS
RubyRuby SDKRuby
PHPPHP SDKPHP
PythonPython SDKPython
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.