API для отправки email: как работает и чем отличается от SMTP
Дата: 2026-07-22 | Время чтения: 14 минут (2607 слов)
API для отправки email — это программный интерфейс, через который сайт, приложение, CRM или другая система передаёт сервису команду сформировать и отправить письмо. В запросе указывают получателя, шаблон или содержимое сообщения, данные для персонализации и служебные параметры.
Как работает API для отправки email
API связывает приложение с платформой рассылок или почтовым сервисом. Процесс обычно выглядит так:
- В системе происходит событие. Пользователь регистрируется, оформляет заказ или выполняет другое действие.
- Приложение отправляет запрос. В нём передают токен, адрес получателя, идентификатор шаблона и данные для письма.
- Сервис проверяет запрос. Он проверяет авторизацию, обязательные поля и ограничения учётной записи.
- Письмо формируется и ставится в очередь. В шаблон подставляются переданные значения, после чего сообщение поступает в почтовую инфраструктуру.
- Приложение получает ответ. API возвращает код выполнения, описание ошибки или идентификатор сообщения.
Успешный ответ API означает, что сервис принял запрос в обработку. Доставка подтверждается позже: письмо может находиться в очереди, получить временный отказ или быть отклонено сервером получателя.
Как приложение отправляет письмо через API и получает статусы
Упрощённый запрос выглядит так:
1 2 3 4 5 6 7 8 9 10 11 12 13curl -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 внутри автоматического сценария Altcraft
API и SMTP: в чём разница
API и SMTP работают на разных уровнях.
SMTP — стандартный протокол передачи электронной почты между почтовыми системами. API — интерфейс, через который приложение обращается к конкретному сервису. Сервис принимает команду через API, формирует письмо и затем передаёт его дальше по почтовой инфраструктуре.
| Критерий | API | Подключение по SMTP |
|---|---|---|
| Способ подключения | HTTP-запрос к методу сервиса | Подключение к SMTP-серверу |
| Формирование письма | Сервис может собрать письмо из шаблона и переданных данных | Приложение обычно передаёт готовое письмо |
| Ответ | HTTP-код, описание ошибки и идентификатор сообщения | Код ответа SMTP-сервера |
| Дальнейшие статусы | Часто доступны через вебхуки и отчёты | Зависят от сервера, логов и дополнительных интеграций |
Скорость отправки зависит от очереди сервиса, ограничений учётной записи, подготовки сообщения и почтовой инфраструктуры.
API удобен, когда сообщение связано с событиями приложения, а также нужны шаблоны, структурированные данные, вебхуки и подробные ошибки. SMTP подходит системам, которые уже умеют формировать готовые письма и подключаться к почтовому серверу.
Преимущества email API
- Автоматический запуск по событию. Письмо отправляется после действия пользователя без участия маркетолога.
- Разделение кода и контента. Приложение передаёт идентификатор шаблона и данные, а текст и оформление письма редактируют в сервисе отправки.
- Персонализация. В письмо подставляют имя, номер заказа, состав корзины, дату доставки и другие данные получателя.
- Получение статусов. Внешняя система принимает сведения о доставке, недоставке и других событиях через вебхуки или API.
«Выберу.ру» через API-импорт и другие источники интегрировал Altcraft с сайтом и бэкендом и на этой основе создал около 60 автоматических сценариев — от отдельных сообщений до многошаговых цепочек. По итогам внедрения платформы ROI CRM-маркетинга вырос почти до 250%.
Что учитывать при работе с email API
- Зависимость от сервиса. У платформ различаются методы, структура запросов и коды ошибок. При смене сервиса интеграцию адаптируют под новый API.
- Лимиты. Провайдеры ограничивают скорость запросов, суточный объём отправки, размер сообщения и число получателей. Часть ограничений зависит от тарифа и репутации отправителя, часть задаётся технически.
- Хранение реквизитов доступа. API-токены и SMTP-данные хранят на сервере или в защищённом хранилище секретов. Их не размещают в открытом коде сайта.
- Защита от дублей. При повторном запросе получатель может получить одно письмо несколько раз. Для проверки используют идентификаторы операций или предусмотренный сервисом механизм идемпотентности.
- Настройка доставляемости. На попадание письма во входящие влияют аутентификация домена, качество базы, репутация отправителя, жалобы и содержание сообщений.
Какие статусы отслеживать
Результат API-запроса, доставка и действия получателя — разные этапы.
| Этап | Что показывает | Где смотреть |
|---|---|---|
| Запрос | Принял ли сервис команду | HTTP-ответ и журнал внешней системы |
| Доставка | Поставлено ли письмо в очередь и принял ли его сервер получателя | Вебхуки и отчёт по рассылке |
| Взаимодействие | Открытия, клики, жалобы и отписки | Аналитика почтового сервиса или платформы |
| Бизнес-результат | Выполнил ли получатель нужное действие | CRM, веб-аналитика, CDP или сквозной отчёт |
Для транзакционного письма важны доля успешных доставок и время от события до отправки. Для маркетингового сообщения дополнительно оценивают клики и конверсию в целевое действие.
В Altcraft статистику по очереди, доставке, недоставке, открытиям и кликам смотрят в отчётах по каналам.
Как выбрать сервис с email API
Email API может быть частью отдельного почтового сервиса или маркетинговой платформы. В первом случае компания получает в основном техническую отправку писем. Во втором — API связывается с профилями клиентов, шаблонами, сегментами, сценариями и аналитикой.
При выборе сервиса проверьте:
- Документацию. Описание методов, примеры запросов и ответов, коды ошибок и журнал изменений.
- Шаблоны, персонализацию и вебхуки. Какие данные можно передавать в письмо и какие статусы возвращает сервис.
- Лимиты и безопасность. Ограничения запросов, права токенов и способы защиты доступа.
- Инфраструктуру и стоимость. Облачное или локальное развёртывание, требования к хранению данных, тарифы и техническая поддержка.
Altcraft относится к маркетинговым платформам: API работает вместе с профилями клиентов, шаблонами, сегментами, автоматическими сценариями и аналитикой. Такой вариант подходит, когда компании нужна не только техническая отправка писем, но и централизованное управление коммуникациями.
Как автоматизировать email через API в Altcraft
В Altcraft через API автоматизируют как транзакционные, так и маркетинговые email-коммуникации. Внешняя система передаёт событие и данные получателя, а платформа использует их для запуска настроенного сообщения или сценария.
Точные параметры описаны в документации по запуску триггерной рассылки. Работа с переданными значениями — в руководстве по API-контенту в сообщениях. В общем виде процесс выглядит так:
- Altcraft находит профиль, подставляет переданные значения в шаблон и запускает нужную коммуникацию.
Маркетолог отслеживает в отчётах платформы результаты отправки и дальнейшую реакцию получателя.
Настройка запуска email-коммуникации через API в Altcraft
На странице интеграций Altcraft собраны возможности API, Webhooks и автоматического импорта данных из внешних систем.
Создайте личный кабинет Altcraft, чтобы настроить email-канал, шаблон и автоматическую отправку писем через API.
Заключение
API связывает события сайта, приложения или CRM с сервисом отправки email. Внешняя система передаёт получателя и динамические данные, а сервис формирует сообщение и возвращает технический результат запроса.
API и SMTP выполняют разные части процесса: через API приложение передаёт команду сервису, а почтовая инфраструктура затем доставляет сформированное письмо. При настройке интеграции важно различать принятие запроса, фактическую доставку и бизнес-результат письма.
Читайте по теме
