Транзакционная и маркетинговая почта
Отправляйте транзакционные и маркетинговые письма из своих приложений по SMTP или через HTTP API с аутентификацией домена, списками подавления и событиями доставки.
Транзакционная и маркетинговая почта — это сервис, предназначенный только для отправки электронной почты. Ваши приложения отправляют через него письма по SMTP или через HTTP API: подтверждения регистрации, сброс пароля, чеки и уведомления (транзакционная почта), а также рассылки и промоакции (маркетинговая почта). Yeap Cloud подписывает каждое письмо DKIM-ключом вашего домена, доставляет его, обрабатывает отказы и жалобы и сообщает вам о каждом шаге в виде событий.
В консоли сервис находится в разделе Рассылка писем группы Почта на левой панели навигации (/tm/streams).
этот сервис только отправляет почту. У него нет входящего ящика, и он не может принимать ответы. Чтобы получать почту на свой домен, используйте Почтовый ящик для домена.
Основные понятия
| Понятие | Что это означает |
|---|---|
| Потоки | Единица покупки. Каждая подписка создаёт один поток, и у каждого потока есть собственная квота, ключи API, журнал отправки, вебхук и SMTP-хост. Потоков может быть несколько, например по одному на приложение. |
| Тип потока | Транзакционные или Маркетинговые. Тип выбирается при покупке потока, и изменить его позже нельзя. Для маркетинговых потоков действуют дополнительные требования: почтовый адрес, обязательная ссылка для отписки и более строгая проверка содержимого. |
| Ключ API | Секрет, начинающийся с ytm_. Это Bearer-токен для HTTP API и одновременно пароль SMTP (имя пользователя всегда apikey). Ключ показывается только один раз — при создании. |
| Домен отправки | Домен в адресе From. Прежде чем отправлять с него, домен необходимо подтвердить (его DKIM-запись должна быть активна). Домен может быть общим для всех ваших потоков или привязан к одному потоку. |
| Песочница | Потоки бесплатного тарифа начинают работу в песочнице (платные тарифы — нет): не более 100 писем в день и только на подтверждённые адреса получателей или адреса на ваших собственных подтверждённых доменах. Песочница снимается, когда ваш аккаунт достигает уровня доверия Lv2. |
| Уровень доверия | Репутация отправки вашего аккаунта, от Lv0 до Lv6. Он растёт по мере того, как вы со временем отправляете чистую почту. На бесплатном тарифе он определяет месячный объём и часовой лимит. На платных тарифах он масштабирует часовой лимит и определяет, можно ли использовать маркетинговые потоки. |
| Список подавления | Адреса, на которые письма не отправляются. Жёсткие отказы и жалобы добавляются автоматически, отписки добавляются для каждого потока отдельно, а также вы можете сами добавлять и удалять адреса. |
| Категория | Необязательная метка письма (category в API, заголовок X-Yeap-Category в SMTP). Используйте её для фильтрации журнала отправки и чтобы получатели могли отписаться только от одного вида писем. |
| События и вебхуки | Каждое письмо проходит через статусы, например «в очереди», «доставлено», «отказ» или «жалоба». Их можно смотреть в консоли, запрашивать через API или получать на собственный HTTPS-эндпоинт. |
Тарифы
На момент написания доступны следующие тарифы. Актуальные цены и лимиты показаны в диалоговом окне Новый поток в консоли.
| Тариф | Цена | Писем в месяц | Сверх включённого объёма | Домены отправки | Часовой лимит | Маркетинговая почта |
|---|---|---|---|---|---|---|
| Бесплатный | Бесплатно | 0 включено; только лимит уровня (100–3,000) | Не допускается: отправка останавливается до следующего месяца | 1 | По уровню (20–500) | Нет |
| Базовый | ¥39/месяц | 50,000 | ¥0.80 за 1,000 | 3 | 2,000 × коэффициент уровня | Да (Lv2 и выше) |
| TM Профессиональный | ¥129/месяц | 300,000 | ¥0.60 за 1,000 | 10 | 10,000 × коэффициент уровня | Да (Lv2 и выше) |
| TM Корпоративный | ¥499/месяц | 2,000,000 | ¥0.40 за 1,000 | Без ограничений | 50,000 × коэффициент уровня | Да (Lv2 и выше) |
- Объём бесплатного тарифа определяется уровнем доверия: 100 писем в месяц на Lv1 и до 3,000 на Lv6. У аккаунта может быть только один бесплатный поток. На платные тарифы этот лимит не распространяется: они включают объём, указанный в таблице.
- Часовой лимит на платных тарифах равен значению тарифа, умноженному на коэффициент уровня: ×0.5 на Lv1, ×0.75 на Lv2, ×1 на Lv3, ×1.25 на Lv4, ×1.5 на Lv5 и ×2 на Lv6.
- Годовая оплата стоит в 10 раз больше месячной цены (¥390, ¥1,290 и ¥4,990 в год), то есть два месяца вы получаете бесплатно.
- Одно письмо = один получатель. Письмо, отправленное трём получателям, засчитывается как три письма в месячный объём и часовой лимит.
- Перерасход оплачивается за каждый начатый блок из 1,000 писем. На каждом платном тарифе действует лимит расходов на неоплаченный перерасход (¥200, ¥1,000 и ¥5,000). При достижении лимита отправка останавливается до оплаты счёта за перерасход. См. Лимиты, песочница и соответствие требованиям.
- Бесплатный тариф начинает работу в песочнице; платные тарифы — нет. Песочница снимается, когда ваш аккаунт достигает Lv2.
Уровни доверия
У вашего аккаунта есть уровень доверия от Lv0 до Lv6. Новые аккаунты начинают с Lv1. На бесплатном тарифе уровень определяет месячный объём и часовой лимит. На платных тарифах он масштабирует часовой лимит, для маркетинговых потоков требуется Lv2 или выше, а для Lv5 и Lv6 пороги автоматической приостановки немного мягче. На Lv0 аккаунт не может отправлять письма. Уровни оцениваются ежедневно и повышаются по одному по мере того, как аккаунт становится старше, доставляет больше писем и сохраняет низкую долю отказов и жалоб. Для Lv2 достаточно подтверждённого адреса электронной почты аккаунта, одного подтверждённого домена отправки и возраста аккаунта не менее 7 дней. Автоматическая приостановка понижает уровень на один, а отправка вируса сбрасывает его до Lv0.
Карточка Уровень доверия на странице Рассылка писем показывает ваш текущий уровень, сколько бесплатного лимита этого месяца вы использовали (бесплатный тариф) и что требуется для следующего уровня. Полная таблица приведена в разделе Лимиты, песочница и соответствие требованиям.
Быстрый старт
Откройте Рассылка писем и нажмите Новый поток.
Выберите тариф, введите Название, например
my-app, и выберите Тип: Транзакционные или Маркетинговые. Маркетинговый тип доступен только на платных тарифах, а для отправки маркетинговой почты уровень доверия вашего аккаунта должен быть Lv2 или выше. Если тариф предлагает несколько периодов оплаты, выберите один в поле Расчётный период.Нажмите В корзину и оплатите заказ. Поток появится в списке после завершения оплаты.
Откройте поток, перейдите на вкладку Домены отправки и нажмите Добавить домен. Введите домен, с которого хотите отправлять письма, например
example.comилиmail.example.com.В открывшейся панели DNS добавьте записи. Если домен размещён в Yeap Cloud DNS, нажмите Добавить в один клик. В противном случае добавьте записи у своего DNS-провайдера. См. Домены отправки и DNS.
Нажмите Проверить. Когда DKIM-запись станет активной, у домена появится статус Проверено.
Перейдите на вкладку Ключ API, нажмите Создать ключ, введите название и скопируйте ключ. Он показывается только один раз.
Отправьте тестовое письмо:
bashcurl -X POST https://api.tm.yeapcloud.net/v1/send \ -H "Authorization: Bearer ytm_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "from": "Example <noreply@example.com>", "to": "you@example.com", "subject": "Hello from Yeap Cloud", "text": "It works." }'Откройте вкладку Журнал отправки, чтобы проследить путь письма от В очереди до Доставлено.
пока поток находится в песочнице, вы можете отправлять письма только на адреса своих подтверждённых доменов или на адреса, подтверждённые на вкладке Получатели песочницы. Если хотите протестировать отправку на ящик у другого провайдера, сначала добавьте туда свой адрес.
Страница потока
Нажмите на поток в списке, чтобы открыть его. В зависимости от потока доступны следующие вкладки:
| Вкладка | Назначение |
|---|---|
| Обзор | Месячное использование, остаток часового лимита, статистика за 7 или 30 дней (отправлено, доля доставки, доля отказов, доля жалоб, открытия, клики), а также настройки SMTP и HTTP API |
| Ключ API | Создание и отзыв ключей API |
| Домены отправки | Добавление, подтверждение и удаление доменов отправки |
| Журнал отправки | Письма за последние 30 дней и события каждого из них |
| Список подавления | Адреса, на которые письма не отправляются |
| Webhook | Отправка событий на ваш собственный HTTPS-эндпоинт |
| Настройки маркетинга | Только для маркетинговых потоков: почтовый адрес, категории, отслеживание открытий и кликов |
| Получатели песочницы | Только пока поток находится в песочнице: адреса получателей, подтверждённые вами для тестирования |
Статус потока
| Статус | Значение | Отправка |
|---|---|---|
| В норме | Обычная работа | Разрешена |
| Приостановлено | Приостановлен автоматически из-за слишком высокой доли отказов, жалоб или спама. Причина отображается в потоке. | Отклоняется с временной ошибкой. Для возобновления обратитесь в службу поддержки. |
| Отключено | Подписка приостановлена, например потому что продление не было оплачено | Отклоняется, пока подписка снова не станет активной |
| Заблокирован | Письмо содержало вирус. Все ключи API потока отозваны. | Отклоняется. Обратитесь в службу поддержки. |
Дальнейшие шаги
- Домены отправки и DNS: добавьте и подтвердите домены, с которых вы отправляете письма.
- SMTP и HTTP API: подключите приложение и отправляйте почту.
- События и вебхуки: отслеживайте доставку и получайте события на своём сервере.
- Подавление и отписка: управляйте тем, кто не получает почту, и узнайте, как работает отписка.
- Лимиты, песочница и соответствие требованиям: уровни доверия, лимиты отправки, перерасход, автоматические приостановки и политика отправки.