Как перейти с доставки электронной почты Dyn на SendGrid

После недавних новостей о том, что Dyn приобретается Oracle для управления DNS, люди стали искать решения, полностью ориентированные на электронную почту. У нашей команды увеличилось количество вопросов о том, как перейти с доставки электронной почты Dyn на SendGrid, поэтому мы решили составить это руководство.

Если вы хотите осмотреться перед тем, как начать, ознакомьтесь с документацией SendGrid. Класс — отличное место, чтобы начать изучать электронную почту, прежде чем углубляться в справку по API и подробности.

С самого начала мы были компанией, ориентированной только на API и электронную почту, и вы обнаружите, что это отражено в наших продуктах. Наша конечная точка электронной почты HTTP, веб-перехватчики, SMTP и не-электронный API являются основой нашего бизнеса, и вы увидите, что это отражено в их возможностях. Это руководство будет направлено на то, чтобы дать вам основы настройки SendGrid, а также выделить полезные функции, которых нет у вашего текущего провайдера.

Получение ключа API

Сначала вам понадобится учетная запись SendGrid. Далее вам нужно создать ключ API, который вы будете использовать для отправки. Перейдите в Настройки -> Ключи API или воспользуйтесь этой ссылкой. Лучшая практика SendGrid и безопасности — использовать разные ключи API для каждого из ваших разных приложений. Ключи API имеют детализированные разрешения, поэтому вы можете включать или отключать доступ на чтение или запись для отдельных конечных точек. Убедитесь, что созданный ключ API имеет полный доступ к Mail Send . (Примечание. Прежде чем вы сможете создать ключ API, ваша учетная запись должна пройти подготовку.)

Библиотеки API

Хотя Dyn предоставляет официальные SDK для Python и PHP, мы официально поддерживаем семь библиотек API, чтобы упростить интеграцию для наших клиентов. Если вы переписываете какой-либо код или реорганизуете способ взаимодействия с вашим ESP в рамках миграции, сейчас самое время оценить эти библиотеки:

• sendgrid-csharp — официальная библиотека C#
• sendgrid-go — официальная библиотека Go
• sendgrid-java — официальная библиотека Java
• sendgrid-nodejs — официальная библиотека NodeJS
• sendgrid-php — официальная библиотека PHP
• sendgrid-python — официальная библиотека Python
• sendgrid-ruby — официальная библиотека Ruby

SMTP

Если вы отправляете через SMTP, есть несколько отличий, о которых вы должны знать. Во-первых, вам не нужно беспокоиться об использовании определенного SMTP-сервера в зависимости от размера вашего сообщения, как того требует Dyn. Мы также принимаем сообщения размером до ~19,5 МБ по сравнению с ограничением Dyn в 10 МБ. Для аутентификации укажите строку «apikey» в качестве имени пользователя SMTP и используйте ключ API в качестве пароля. Затем укажите свое имя хоста на smtp.sendgrid.net .

Мы также предлагаем дополнительные варианты портов по сравнению с Dyn. Вы можете подключиться с помощью SMTP через незашифрованный или TLS через порты 25, 2525 и 587. Вы также можете подключиться через SSL через порт 465. В целом, мы рекомендуем порт 587, так как это приводит к наименьшему количеству проблем с хостинг-провайдерами.

Механизм настройки электронной почты, отправляемой через SMTP, — это наш заголовок X-SMTPAPI. Этот заголовок позволит вам определить замены ключей/значений, отправлять пакетные запросы в стиле слияния и фильтры управления (например, отслеживание кликов), которые активны для вашей отправки. Вы можете группировать электронные письма по категориям или отслеживать метаданные для каждого электронного письма с помощью unique_args. Это мощные функции, которые могут сократить время отправки и пропускную способность, необходимую для транзакций электронной почты, и их стоит изучить.

HTTP

Основной конечной точкой для отправки электронной почты является конечная точка почты/отправки. Запросы к этой конечной точке аутентифицируются через заголовок авторизации с вашим ключом API, представленным в виде токена-носителя. Вы можете найти более подробный пример в нашей документации.

По сравнению с HTTP API Dyn наша конечная точка предоставляет больше возможностей, позволяющих настраивать получателей и управлять ими, а также отправлять несколько разных сообщений в одном запросе.

Персонализация позволяет вам определять получателей и метаданные для каждого сообщения, например значения замены для настройки содержимого или custom_args для связывания сообщений с идентификаторами пользователей или номерами заказов. Существует ряд примеров персонализации для распространенных случаев использования. Вы также можете найти примеры вызовов cURL.

Такие функции, как отслеживание кликов, настраиваются с помощью параметров tracking_settings и mail_settings. Вы также можете запланировать отправку на срок до 72 часов, используя параметр «send_at».

Мы также упростили добавление вложений к вашему запросу API. Просто закодируйте файл в виде строки Base64 и вставьте его непосредственно в полезную нагрузку JSON вместе с информацией о содержимом MIME. Вы можете узнать больше о включении вложений в следующем разделе нашего Класса документации.

Вебхуки

SendGrid предоставляет два веб-перехватчика: веб-перехватчик событий для публикации событий электронной почты в реальном времени, таких как отказы от подписки, отказы и т. д., и веб-перехватчик входящего анализа для получения электронных писем и программного ответа на них.

Эти функции недоступны в Dyn, но могут быть полезны для дополнительной автоматизации управления электронной почтой. Их стоит посмотреть, когда вы начнете настройку.

Конечные точки API без электронной почты

Для конечных точек API, которые не отправляют электронную почту, ознакомьтесь с обзором API v3. В большинстве случаев мы используем интуитивно понятные HTTP-методы и коды ответов, а также применяем ограничения скорости для вызовов. API v2 устарел, хотя сроков прекращения его поддержки нет. Все новые интеграции должны отдавать предпочтение v3. Аутентификация API v3 выполняется с помощью заголовка аутентификации с токеном носителя.

Маркетинговые кампании

Еще одна функция, которую мы предлагаем, — это надежная платформа Marketing Campaigns, позволяющая вам управлять своими списками, создавать динамические сегменты, загружать свои активы и разрабатывать шаблон электронной почты с помощью визуального редактора, выполнять автоматическое A/B-тестирование и многое другое. И, конечно же, за всеми этими функциями стоит открытый API.

Несколько часто задаваемых вопросов

В: Поддерживаете ли вы шаблоны для транзакционных писем?

A: Да, и они динамичны! Шаблоны транзакций SendGrid имеют встроенную поддержку синтаксиса Handlebars. В дополнение к базовой замене и подстановке вы можете использовать перечисления/перебирать списки, использовать условные операторы и многое другое. Чтобы узнать больше, нажмите сюда.

В: Есть ли песочница или способ проверить мои электронные письма, не отправляя их?

A: Вы можете включить режим песочницы при отправке через HTTP. Существует также адрес «приемника», который вы можете использовать для тестирования.

В: Можно ли перенести мой IP-адрес/репутацию отправителя в SendGrid?

О: Мы не можем перенести IP-адрес или репутацию, но мы можем помочь вам автоматически подготовить новый IP-адрес.

Вопрос. Поддерживает ли SendGrid принудительный TLS ?

О: Абсолютно. Вы можете потребовать, чтобы принимающие серверы поддерживали TLS и отбрасывали сообщения, идущие на серверы, которые не соответствуют требованиям.

В: Могу ли я разрешить своим получателям определять типы электронных писем, которые они хотят получать?

О: Да. Предоставление вашим получателям большего контроля над своей электронной почтой позволяет вам отправлять электронные письма, которые нужны людям, что лучше для всех. Посетите группы отписки для получения дополнительной информации.

Если вы заинтересованы в переходе на SendGrid, дополнительную информацию можно найти на странице sendgrid.com/pricing.