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

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

Відмінності між Amazon SES і Mailtrap

  1. Основна відмінність між Amazon SES і Mailtrap полягає в тому, що для налаштування та інтеграції Mailtrap вам не потрібні професійні навички кодингу та значний розробницький досвід.
  2. Залежно від тарифного плану, Mailtrap зберігає логи імейлів в Email Logs до 60 днів. Контент мейлів та інші дані зберігаються в доступі від 3 до 15 днів.
  3. Mailtrap пропонує тарифні плани зі щомісячною оплатою. На відміну від Amazon SES, у Mailtrap немає оплати “по факту використання”.
  4. Mailtrap пропонує комплексний функціонал для тестування імейлів. Тестування допомагає перевіряти спам-показники кожного імейлу, верифікувати HTML/CSS код, дозволяє знаходити та виправляти баги на стейджингу, у розробницькому середовищі перед тим, як надсилати імейли одержувачам.
  5. Mailtrap пропонує Bulk Stream – окрему імейл інфраструктуру, що дозволяє відправляти електронні листи багатьом отримувачам одразу (новинні розсилки, маркетингові кампейни, оновлення продукту тощо)
  6. Ще одна ключова відмінність між Amazon SES і Mailtrap полягає у доступі до статистики. Mailtrap має функцію Actionable Analytics, де ви можете отримати детальну статистику.
  7. В Amazon SES функцію імейлів “відписатися” треба кодити, на відміну від Mailtrap.

Спільне між Mailtrap і Amazon SES

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

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

  • Identity and Access Management (IAM)
  • Template (CreateTemplate – API operation
  • Account-level suppression list
  • Message Tags (closest comparison, but the logic is different)
  • Event Notifications
  • CONFIGURATIONSET (you have to store all the headers in configuration and create it in advance) or use

    SendRawEmail API method

  • Message Tags

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

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

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

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

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

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

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

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

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

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

З чого почати

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

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

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

SMTP

Перехід з SMTP Amazon SES простий. Ось покрокова інструкція:

Сервери надсилання

Amazon Servers

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io

email-smtp.us-east-2.amazonaws.com (+16 more) Show all
email-smtp.us-east-1.amazonaws.com
email-smtp-fips.us-east-1.amazonaws.com
email-smtp.us-west-1.amazonaws.com
email-smtp.us-west-2.amazonaws.com
email-smtp-fips.us-west-2.amazonaws.com
email-smtp.ap-south-1.amazonaws.com
email-smtp.ap-northeast-3.amazonaws.com
email-smtp.ap-northeast-2.amazonaws.com
email-smtp.ap-southeast-1.amazonaws.com
email-smtp.ap-southeast-2.amazonaws.com
email-smtp.ap-northeast-1.amazonaws.com
email-smtp.ca-central-1.amazonaws.com
email-smtp.eu-central-1.amazonaws.com
email-smtp.eu-west-1.amazonaws.com
email-smtp.eu-west-2.amazonaws.com
email-smtp.eu-west-3.amazonaws.com
email-smtp.eu-north-1.amazonaws.com
email-smtp.sa-east-1.amazonaws.com

Порти

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

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

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

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

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

API

Токени Mailtrap API

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

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

Мапінг API

Тип APIMailtrapSES Naming
The BasicsGeneralWelcome
SendingSend emailSendEmail, SendRawEmail,
SendTemplatedEmail
Email TestingEmail Testing API

Бібліотеки API

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

Мова програмуванняMailtrapAmazon SES
NodeJSNodeJS SDKНе підтримується
RubyRuby SDKRuby SDK
PHPPHP SDKPHP SDK
PythonPython SDKPython SDK
ElixirElixir SDKНе підтримується

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

Ми використовуємо 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.