Использование API агрегации SMTP
Объедините несколько своих SMTP-аккаунтов в один канал отправки, а платформа будет отправлять через них по очереди:
- При первом использовании автоматически подключается бесплатный тариф; лимиты, доступные функции и ограничения по количеству зависят от тарифа, сменить его можно кнопкой «Сменить тариф», а неиспользованное время засчитывается по исходной цене
- Сначала добавьте аккаунт на странице «Аккаунты SMTP», затем создайте ключ на странице «API-ключи»; для создания и сброса ключа нужно подтвердить личность, а ключ показывается только один раз
- Три способа отправки: написание письма онлайн, массовые рассылки и вызовы API; массовые рассылки автоматически объединяют получателей, удаляют дубликаты и пропускают список отписавшихся
- Если аккаунт SMTP из-за проблем самого аккаунта 3 раза подряд не смог отправить письмо, его статус меняется на «Ошибка», а после успешной проверки платформой он восстанавливается автоматически
- Частые ошибки: при 400 действуйте по message (квота исчерпана, получатель отмечен как возврат или жалоба и т. п.), 401 — недействительный ключ, 403 — аккаунт ограничен, 429 — слишком частые запросы
Что делает этот сервис
API агрегации SMTP объединяет несколько ваших собственных SMTP-аккаунтов в один канал отправки: ваша система подключается к платформе один раз, а платформа отправляет письма через эти аккаунты по очереди. Отправлять можно прямо из консоли или через API из своей системы.
- Подходит для транзакционных писем, например кодов регистрации и уведомлений о заказах, а также массовых рассылок группам контактов.
- При первом использовании автоматически подключается бесплатный тариф. Добавьте аккаунт SMTP и создайте API-ключ — и можно отправлять письма; если понадобится больше лимитов или функций, смените тариф.
- В консоли сервис находится в разделе «SMTP API», страницы которого разделены на три группы: «Отправка», «Интеграция» и «Настройки».
Сначала несколько терминов
В этом разделе много страниц. Если сначала разобраться с этими понятиями, будет гораздо проще найти нужную.
- Тариф — Определяет, сколько писем можно отправить в день и в месяц, какие функции доступны (шаблоны писем, контакты, массовые рассылки, webhook) и какие действуют ограничения по количеству — всё это по пунктам указано на карточках страницы «Оформить подписку». При первом использовании автоматически подключается бесплатный тариф; по окончании платного тарифа аккаунт возвращается на бесплатный.
- Аккаунт SMTP — Ваш собственный SMTP-аккаунт для отправки (у почтового провайдера или на своём сервере) — канал отправки платформа не предоставляет. Можно добавить несколько аккаунтов и для каждого задать приоритет и дневной лимит отправки, а платформа будет отправлять письма через них по очереди.
- API-ключ — Учётные данные, с которыми ваша система вызывает API отправки. API-ключ определяет, «кто вызывает», а аккаунт SMTP — «с какого ящика отправлять».
- Домен отправки — Домен после @ в адресе отправителя. На странице «Домены отправки» проверяются его записи SPF, DKIM и DMARC; когда все они настроены, письма чаще попадают во входящие.
- Список отписавшихся — Адреса, отписавшиеся по ссылке отписки, а также адреса, которые ваша система через API отметила как возврат или жалобу. Платформа автоматически пропускает адреса из списка, вести его вручную не нужно.
Отправка первого письма
- Проверьте тариф: При первом входе автоматически подключается бесплатный тариф. В разделе «SMTP API → Оформить подписку» показаны текущий тариф и лимиты всех тарифов; если нужно больше лимитов или функций, оформите подписку на более высокий тариф.
- Добавьте аккаунт SMTP: На странице «Аккаунты SMTP» нажмите «Добавить аккаунт» и укажите адрес сервера, порт, имя пользователя, пароль и адрес отправителя. Сколько аккаунтов можно добавить, зависит от тарифа; если их несколько, платформа автоматически отправляет через них по очереди.
- Создайте API-ключ: На странице «API-ключи» нажмите «Создать API-ключ». Для создания и сброса ключа нужно подтвердить личность: при включённой двухфакторной аутентификации — одноразовым кодом из приложения, без неё — кодом из письма; после одного подтверждения в течение 10 минут в рамках этого входа повторно подтверждать не нужно. Ключ показывается только один раз — сразу скопируйте и сохраните его; на один аккаунт можно создать не более 50 ключей.
- Отправка тестового письма: На странице «Аккаунты SMTP» нажмите «Проверить»: можно проверить подключение или отправить тестовое письмо на свой адрес. Тестовые письма не расходуют квоту отправки, поэтому проверять можно сколько угодно раз.
Если у вас уже есть платный тариф, выберите на странице «Оформить подписку» другой и нажмите «Сменить тариф» — смена вступает в силу сразу. Неиспользованное время текущего тарифа засчитывается по исходной цене, и вы доплачиваете только разницу; если зачёт превышает цену нового тарифа, остаток переводится в дополнительное время, а не возвращается на баланс. Лимиты, уже использованные в этом месяце, переносятся на новый тариф.
После удаления API-ключа все запросы, которые всё ещё его используют, завершаются ошибкой; сброс тоже сразу делает прежний ключ недействительным. Если ключ используется работающей системой, сначала замените его новым и только потом удаляйте или сбрасывайте старый.
Три способа отправки
Одна квота, три способа — выбирайте по ситуации:
- Написать онлайн — Составляйте и отправляйте письма из консоли. Подходит для разовых уведомлений и повторной отправки вручную.
- Рассылка — Выберите шаблон и группы контактов для массовой рассылки с ограничением скорости, отслеживанием и планированием. Система объединяет контакты, удаляет дубликаты и исключает адреса из списка отписавшихся.
- Вызов API — Ваша система напрямую вызывает конечную точку. Один запрос может содержать нескольких получателей, каждый со своими переменными шаблона.
Шаблоны и переменные
Поместите содержимое в шаблон и передавайте при отправке только переменные, чтобы отделить текст от кода.
- Шаблоны управляются на странице «Шаблоны» и указываются по идентификатору при отправке; платформа подставляет значения переменных.
- Платформа создаёт текстовую версию из HTML, чтобы письмо оставалось читаемым там, где HTML не поддерживается.
Контакты и отписки
На странице «Контакты» ведутся адреса и группы, поддерживаются импорт и экспорт CSV; при массовой рассылке получатели выбираются по группам.
- При выборе нескольких групп контакты объединяются, а дубликаты удаляются, чтобы никто не получил одно и то же письмо дважды.
- При импорте CSV отписавшиеся адреса пропускаются автоматически.
- Ссылка отписки ведёт на страницу подтверждения. После подтверждения адрес добавляется в список отписавшихся, а контакт получает соответствующую отметку.
Список отписавшихся применяется автоматически. На адреса, отмеченные как возврат или жалоба, больше не отправляется ни одно письмо; адреса, отписавшиеся по ссылке отписки, пропускаются только в массовых рассылках и пакетной отправке, а отдельные письма вроде кодов подтверждения им отправляются как обычно.
Домены отправки
На странице «Домены отправки» добавьте домен, с которого вы отправляете письма (часть адреса отправителя после @); можно сразу указать селектор DKIM (его даёт ваш почтовый провайдер). Платформа проверит записи SPF, DKIM и DMARC, предложит DNS-записи, которые стоит добавить, и покажет состояние домена. Когда все записи настроены, письма чаще попадают во входящие. Этот шаг не обязателен для отправки; число доменов, которые можно добавить, зависит от тарифа.
Webhooks и события
Чтобы знать, что произошло с каждым письмом, настройте webhook, и платформа будет отправлять вашему сервису события доставки.
- События охватывают процесс и результат доставки, а также, например, отписку получателя или завершение рассылки.
- Обратные вызовы подписаны. Ваш сервер должен проверить подпись, прежде чем доверять данным: это граница безопасности, и пропускать проверку нельзя.
Типичные ошибки и решения
Если вызов API завершился ошибкой, сначала посмотрите код состояния HTTP и message в ответе, а затем действуйте по таблице ниже.
- Возвращается 400 — Запрос отклонён: квота исчерпана, получатель отмечен как возврат или жалоба, нет доступного аккаунта SMTP, ошибка в параметрах и т. п. — Действуйте по тексту message. Если квота исчерпана, дождитесь её обновления (дневной лимит обновляется в 0:00 по часовому поясу вашего аккаунта, который можно изменить в настройках аккаунта; месячный — в начале каждого месяца) или перейдите на более высокий тариф. Если сообщается, что нет доступного аккаунта SMTP, проверьте статус аккаунтов на странице «Аккаунты SMTP».
- Возвращается 401 — API-ключ не передан, либо он недействителен, отключён, удалён или сброшен — Проверьте статус на странице «API-ключи» и укажите в своей системе действующий ключ.
- Возвращается 403 — Аккаунт заморожен или ограничен — Ограниченный аккаунт (код ошибки 4031) по-прежнему может вызывать API для запроса данных, но отправка отклоняется. Обратитесь в поддержку.
- Возвращается 429 — Слишком частые запросы: не более 20 в секунду на один API-ключ и не более 60 в секунду в сумме на аккаунт — Подождите столько, сколько указано в заголовке ответа Retry-After, и отправьте снова. Если письмо нужно отправить многим получателям, указывайте нескольких получателей в одном запросе или используйте массовую рассылку, а не вызывайте API быстро по одному письму.
- Письмо отправляется, но попадает в спам — Домен отправки не настроен или содержимое вызывает срабатывание фильтров — Проверьте SPF, DKIM и DMARC на странице «Домены отправки», добавьте недостающие DNS-записи по рекомендациям, затем проверьте содержимое письма; перед настоящей массовой рассылкой можно сначала выполнить проверку на странице «Проверка доставки».
Если аккаунт SMTP 3 раза подряд не смог отправить письмо из-за проблем самого аккаунта — например, ошибки входа или недоступности сервера, — его статус меняется на «Ошибка», и он временно исключается из очереди отправки. Платформа периодически проверяет его автоматически и после успешной проверки восстанавливает. Вы также можете на странице «Аккаунты SMTP» проверить подключение или отправить тестовое письмо — при успехе аккаунт восстановится, — либо исправить данные подключения или включить аккаунт вручную.
Часто задаваемые вопросы
Всё настроено — почему письма всё равно не отправляются?
Проверьте по порядку: есть ли на странице «Аккаунты SMTP» включённые аккаунты (аккаунты со статусом «Ошибка» в отправке не участвуют); действителен ли используемый API-ключ; не исчерпана ли дневная или месячная квота. Конкретная причина указана в message ответа API.
Расходуют ли тестовые письма квоту?
Нет. Тестовая отправка на странице «Аккаунты SMTP» не расходует квоту отправки, поэтому на этапе настройки можно спокойно проверять несколько раз.
Что будет после окончания платного тарифа?
По окончании срока аккаунт возвращается к лимитам и функциям бесплатного тарифа. Чтобы продолжить пользоваться платным тарифом, нажмите «Продлить» на странице «Оформить подписку» до окончания срока или оформите подписку заново после него.
Связанные страницы: Центр помощи · Руководства и вопросы · Агрегированный SMTP API · Документация API
Загрузка…