Как перейти с транзакционного API Mailchimp на SendGrid

В 2016 году Mandrill, теперь известный как транзакционный API Mailchimp, стал эксклюзивным дополнительным сервисом для Mailchimp. Это означало, что только ежемесячные участники Mailchimp могли получить доступ к функциям транзакций электронной почты Mandrill. Другим пользователям приходилось либо выбирать другую платформу, либо платить за учетную запись Mailchimp, которая им не всегда была нужна.

Тогда мы поняли, что многие клиенты будут искать альтернативного провайдера, который мог бы эффективно рассылать электронные письма. Twilio SendGrid хотел помочь сделать этот процесс как можно более плавным.

Миграция с транзакционного API Mailchimp на SendGrid

Будучи исключительно дополнением, Mailchimp Transactional API не настроен для надежной доставки электронной почты в масштабе, необходимом для вашего бизнеса. Но здесь, в Twilio SendGrid, мы являемся лидерами в области надежной и безопасной доставки электронной почты, обрабатывая более 100 миллиардов электронных писем в месяц для наших ведущих отправителей, включая Uber, Airbnb и Spotify.

В этом руководстве мы рассмотрим основные преимущества, которые вы можете ожидать при отправке электронных писем с помощью Twilio SendGrid. Наше пошаговое руководство по миграции обеспечит плавный и оптимизированный переход.

Документация по Twilio SendGrid — лучший ресурс для тех, кто ищет ответы на все вопросы, связанные с SMTP, API и электронной почтой. Это отличное место для начала, прежде чем углубляться в более мелкие детали перемещения почты и выполнения вызовов API.

Но сначала, если вы ищете эквивалент Twilio SendGrid для определенных функций транзакционного API Mailchimp, вам может помочь следующая таблица:

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

Для начала вам потребуется учетная запись Twilio SendGrid. Затем вам нужно создать ключ API, который вы будете использовать для отправки. Перейдите в «Настройки» → «Ключи API» или используйте эту ссылку , если вы вошли в свою учетную запись. Целесообразно использовать разные ключи API для каждого из ваших приложений. Вы также можете определить разрешения для ключей API, включив или отключив доступ для чтения или записи для отдельных конечных точек. На данный момент вам просто нужен тот, у которого есть полный доступ к Mail Send. (Примечание. Перед созданием ключа API необходимо пройти подготовку .)

библиотеки API

У нас есть ряд официально поддерживаемых библиотек API , которые дополнительно оптимизируют процесс отправки электронной почты. Если вы переписываете какой-либо код или реорганизуете способ взаимодействия с поставщиком услуг электронной почты (ESP) в рамках миграции, самое время использовать одну из этих библиотек для ускорения интеграции:

• sendgrid-csharp — официальная библиотека C#
• sendgrid-go — официальная библиотека Go
• sendgrid-java — официальная библиотека Java
• sendgrid-nodejs — официальная библиотека Node.js
• sendgrid-perl — официальная библиотека Perl
• sendgrid-php — официальная библиотека PHP
• sendgrid-python — официальная библиотека Python
• sendgrid-ruby — Официальная библиотека Ruby
• ti.sendgrid — официальная оболочка Titanium

SMTP

Если вы не используете одну из наших библиотек и не отправляете сообщения по протоколу Simple Mail Transfer Protocol или SMTP, вам следует знать несколько отличий. Для аутентификации при отправке через SMTP укажите строку «apikey» в качестве имени пользователя SMTP и используйте ключ API в качестве пароля. Затем укажите свое имя хоста на smtp.sendgrid.net.

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

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

HTTP

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

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

Такие функции, как отслеживание кликов, можно настроить с помощью параметров tracking_settings и mail_settings .

Для вложений, отправленных через HTTP, обрабатывайте их так же, как транзакционный API Mailchimp, где содержимое кодируется как Base64 и встраивается непосредственно в полезную нагрузку JSON вместе с многоцелевыми расширениями электронной почты или информацией MIME, например так .

Обратите внимание, что конечная точка mail.send Twilio SendGrid полностью асинхронна. Мы примем запрос — при условии, что он правильно сформирован — и постараемся обработать доставку почты как можно скорее. Mailchimp Transactional API позволяет синхронно выполнять запросы менее чем на 10 электронных писем. Однако Twilio SendGrid не поддерживает синхронный режим.

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

Вебхуки

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

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

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

Часто задаваемые вопросы о переходе на Twilio SendGrid

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

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

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

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

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

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

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

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

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

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

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

О: Да. Клиенты API v3, использующие персонализацию, могут включать до 1000 получателей на запрос. Пользователи SMTP могут включать до 10 000 получателей на сообщение, но мы часто рекомендуем использовать 1 000 получателей на запрос.

Узнайте больше о переходе с транзакционного API Mailchimp на Twilio SendGrid.