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

Відмінності між 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.

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

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

З чого почати

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

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

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

SMTP

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

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

Сервер Amazon

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

email-smtp.us-east-2.amazonaws.com (+16) Показати всі 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

Порти

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

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

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

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

API

Токени Mailtrap API

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

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

Мапінг API

Тип API	Mailtrap	SES Naming
The Basics	General	Welcome
Sending	Send email	SendEmail, SendRawEmail, SendTemplatedEmail
Email Testing	Email Testing API

Бібліотеки API

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

Автентифікація 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.