API для отправки email: как работает и чем отличается от SMTP

API для отправки email — это программный интерфейс, через который сайт, приложение, CRM или другая система передаёт сервису команду сформировать и отправить письмо. В запросе указывают получателя, шаблон или содержимое сообщения, данные для персонализации и служебные параметры.

Как работает API для отправки email

API связывает приложение с платформой рассылок или почтовым сервисом. Процесс обычно выглядит так:

1. В системе происходит событие. Пользователь регистрируется, оформляет заказ или выполняет другое действие.
   
   

2. Приложение отправляет запрос. В нём передают токен, адрес получателя, идентификатор шаблона и данные для письма.
   
   

3. Сервис проверяет запрос. Он проверяет авторизацию, обязательные поля и ограничения учётной записи.
   
   

4. Письмо формируется и ставится в очередь. В шаблон подставляются переданные значения, после чего сообщение поступает в почтовую инфраструктуру.
   
   

5. Приложение получает ответ. API возвращает код выполнения, описание ошибки или идентификатор сообщения.

Успешный ответ API означает, что сервис принял запрос в обработку. Доставка подтверждается позже: письмо может находиться в очереди, получить временный отказ или быть отклонено сервером получателя.

Упрощённый запрос выглядит так:

1
2
3
4
5
6
7
8
9
10
11
12
13
curl -X POST \
  https://api.emailprovider.example/v1/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "recipient@example.com",
    "template_id": "order-confirmed",
    "data": {
      "name": "Анна",
      "order_id": "A-1234",
      "total": "4 990 ₽"
    }
  }'

Вместо полного HTML-кода приложение передаёт идентификатор шаблона и переменные. Текст и оформление письма меняют в сервисе отправки, а код сайта или приложения не приходится обновлять при каждой правке шаблона.

Где используют email API

• Транзакционные письма. Через API отправляют подтверждение заказа, восстановление пароля, уведомление о доставке и другие сервисные сообщения после действия пользователя.
  
  

• Триггерные маркетинговые письма. Событие на сайте или в приложении запускает заранее настроенную коммуникацию — например, серию welcome-писем или напоминание о незавершённой покупке.
  
  

• Массовые рассылки. CRM, календарь акций или административная система могут запускать готовую рассылку для базы или сегмента.
  
  

• Служебные уведомления. Через API отправляют отчёты, предупреждения об ошибках и сообщения сотрудникам о событиях во внутренних системах.

В Altcraft API-вызов можно включить прямо в автоматический сценарий в визуальном редакторе и связать с последующими сообщениями, проверками условий и другими действиями.

API и SMTP: в чём разница

API и SMTP работают на разных уровнях.

SMTP — стандартный протокол передачи электронной почты между почтовыми системами. API — интерфейс, через который приложение обращается к конкретному сервису. Сервис принимает команду через API, формирует письмо и затем передаёт его дальше по почтовой инфраструктуре.

Скорость отправки зависит от очереди сервиса, ограничений учётной записи, подготовки сообщения и почтовой инфраструктуры.

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

Преимущества email API

• Автоматический запуск по событию. Письмо отправляется после действия пользователя без участия маркетолога.
  
  

• Разделение кода и контента. Приложение передаёт идентификатор шаблона и данные, а текст и оформление письма редактируют в сервисе отправки.
  
  

• Персонализация. В письмо подставляют имя, номер заказа, состав корзины, дату доставки и другие данные получателя.
  
  

• Получение статусов. Внешняя система принимает сведения о доставке, недоставке и других событиях через вебхуки или API.

«Выберу.ру» через API-импорт и другие источники интегрировал Altcraft с сайтом и бэкендом и на этой основе создал около 60 автоматических сценариев — от отдельных сообщений до многошаговых цепочек. По итогам внедрения платформы ROI CRM-маркетинга вырос почти до 250%.

Что учитывать при работе с email API

• Зависимость от сервиса. У платформ различаются методы, структура запросов и коды ошибок. При смене сервиса интеграцию адаптируют под новый API.
  
  

• Лимиты. Провайдеры ограничивают скорость запросов, суточный объём отправки, размер сообщения и число получателей. Часть ограничений зависит от тарифа и репутации отправителя, часть задаётся технически.
  
  

• Хранение реквизитов доступа. API-токены и SMTP-данные хранят на сервере или в защищённом хранилище секретов. Их не размещают в открытом коде сайта.
  
  

• Защита от дублей. При повторном запросе получатель может получить одно письмо несколько раз. Для проверки используют идентификаторы операций или предусмотренный сервисом механизм идемпотентности.
  
  

• Настройка доставляемости. На попадание письма во входящие влияют аутентификация домена, качество базы, репутация отправителя, жалобы и содержание сообщений.

Какие статусы отслеживать

Результат API-запроса, доставка и действия получателя — разные этапы.

Для транзакционного письма важны доля успешных доставок и время от события до отправки. Для маркетингового сообщения дополнительно оценивают клики и конверсию в целевое действие.

В Altcraft статистику по очереди, доставке, недоставке, открытиям и кликам смотрят в отчётах по каналам.

Как выбрать сервис с email API

Email API может быть частью отдельного почтового сервиса или маркетинговой платформы. В первом случае компания получает в основном техническую отправку писем. Во втором — API связывается с профилями клиентов, шаблонами, сегментами, сценариями и аналитикой.

При выборе сервиса проверьте:

• Поддерживаемые сценарии. Одиночные сообщения, массовые рассылки и автоматические цепочки.
  
  

• Документацию. Описание методов, примеры запросов и ответов, коды ошибок и журнал изменений.
  
  

• Шаблоны, персонализацию и вебхуки. Какие данные можно передавать в письмо и какие статусы возвращает сервис.
  
  

• Лимиты и безопасность. Ограничения запросов, права токенов и способы защиты доступа.
  
  

• Инфраструктуру и стоимость. Облачное или локальное развёртывание, требования к хранению данных, тарифы и техническая поддержка.

Altcraft относится к маркетинговым платформам: API работает вместе с профилями клиентов, шаблонами, сегментами, автоматическими сценариями и аналитикой. Такой вариант подходит, когда компании нужна не только техническая отправка писем, но и централизованное управление коммуникациями.

Как автоматизировать email через API в Altcraft

В Altcraft через API автоматизируют как транзакционные, так и маркетинговые email-коммуникации. Внешняя система передаёт событие и данные получателя, а платформа использует их для запуска настроенного сообщения или сценария.

Точные параметры описаны в документации по запуску триггерной рассылки. Работа с переданными значениями — в руководстве по API-контенту в сообщениях. В общем виде процесс выглядит так:

1. Маркетолог создаёт в платформе email-шаблон и настраивает запуск сообщения или сценария.
   
   

2. Сайт, приложение или CRM отправляет POST-запрос с данными получателя и значениями для письма.
   
   

3. Altcraft находит профиль, подставляет переданные значения в шаблон и запускает нужную коммуникацию.
   
   

4. Маркетолог отслеживает в отчётах платформы результаты отправки и дальнейшую реакцию получателя.

На странице интеграций Altcraft собраны возможности API, Webhooks и автоматического импорта данных из внешних систем.

Создайте личный кабинет Altcraft, чтобы настроить email-канал, шаблон и автоматическую отправку писем через API.

Заключение

API связывает события сайта, приложения или CRM с сервисом отправки email. Внешняя система передаёт получателя и динамические данные, а сервис формирует сообщение и возвращает технический результат запроса.

API и SMTP выполняют разные части процесса: через API приложение передаёт команду сервису, а почтовая инфраструктура затем доставляет сформированное письмо. При настройке интеграции важно различать принятие запроса, фактическую доставку и бизнес-результат письма.

Читайте по теме

• Автоматизация маркетинга: 8 лайфхаков для роста бизнеса
  
  

• Какие технологии используют почтовые сервисы для защиты от спама
  
  

• Гайд по созданию шаблонов писем для рассылки