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

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

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

  1. Залежно від тарифного плану, Mailtrap зберігає логи імейлів до 60 днів. Контент імейлів та інші дані зберігаються в доступі від 3 до 15 днів без додаткових доплат.
  2. Mailtrap пропонує комплексний функціонал для тестування імейлів. Тестування допомагає перевіряти спам-показники кожного імейлу, верифікувати HTML/CSS код, дозволяє знаходити та виправляти баги на стейджингу, у розробницькому середовищі перед тим, як надсилати імейли одержувачам.
  3. Mailtrap не має опції запланованого надсилання імейлів на встановлену пізніше дату.

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

  • Teammates
  • SendGrid Templates
  • Suppressions
  • Categories
  • Webhooks
  • X-SMTPAPI
  • unique_args

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

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

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

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

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

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

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

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

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

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

З чого почати

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

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

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

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

Ендпоінти SMTP

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io		smtp.sendgrid.net

Порти SMTP

ПортФункціяMailtrapSendGrid
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, меню Settings.

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

Мапінг API

Тип APIMailtrapSendGrid
Email sendingSend emailMail
User managementUser managementTeammates
Email TestingEmail Testing API

Бібліотеки API

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

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