Прежде чем отправлять письма реальным получателям, проверьте их на тестовых отправках. Удобнее всего завести для этого отдельное тестовое окружение: так вы безопасно найдёте проблемы с отправкой и отображением писем.
Вот что для этого есть в Haskimail.
Тестовые возвраты и жалобы
Чтобы проверить, как ваша интеграция обрабатывает возвраты, используйте тестовый домен bounce-testing.haskimail.ru. Письмо на него создаёт в логе активности тестовый возврат и вызывает подключённые вебхуки — так же, как настоящий возврат. Это не влияет на лимиты возвратов или репутацию отправителя, поэтому мы рекомендуем этот вариант вместо генерации возвратов на вашем собственном домене.
Просто отправьте письмо (через SMTP или API, как обычно) на специальный адрес — и Haskimail не доставит его реально, а сразу пришлёт вам в вебхук и событие нужного типа:
| Адрес | Что симулирует |
|---|---|
hardbounce@bounce-testing.haskimail.ru |
🔴 Жёсткий возврат (hard) |
softbounce@bounce-testing.haskimail.ru |
🟠 Мягкий возврат (soft) |
blocked@bounce-testing.haskimail.ru |
🟣 Блокировка провайдером |
spamnotification@bounce-testing.haskimail.ru |
🩷 Жалоба на спам (FBL) |
Регистр и разделители не важны. Поддерживаются варианты вроде Hard_Bounce@…, HardBounce@…, hard-bounce@… — всё это один и тот же тип. Также распознаются короткие синонимы: hard@, soft@, block@, spam@.
Тестовый API-ключ
Чтобы проверить формат запросов и обработку ошибок в вашем коде, передайте вместо серверного ключа тестовый — HASKIMAIL_API_TEST в заголовке X-Haskimail-Server-Token. API проверит письмо и вернёт ответ в обычном формате, но письмо никуда не уйдёт и не попадёт в статистику. Тестовый ключ работает с одиночной и пакетной отправкой. Он проверяет только сам запрос — обязательные поля, адреса и вложения, а канал отправки и настройки сервера не проверяет. Чтобы проверить отправку целиком, используйте сервер «Песочница».
Проверка шаблонов
Если вы отправляете письма по шаблонам, проверяйте их перед отправкой: API покажет готовое письмо и найдёт переменные без значения. Подробнее — в статье «Проверка шаблона перед отправкой» и в документации по шаблонам.
Тестирование возвратов на вашем домене
Главное при тестировании — не навредить репутации рабочего домена. Если вы отправляете тестовые письма с вашего рабочего домена на фиктивные адреса или реальные адреса с низким уровнем вовлеченности, это может повлиять на репутацию вашего домена и снизить доставляемость в будущем.
Большой объём тестовых писем может превысить допустимую долю возвратов или снизить общую вовлечённость. Почтовые провайдеры, например Mail.ru и Gmail, оценивают репутацию отправителя по всем его письмам, поэтому неудачные тесты скажутся и на рабочих рассылках.
Поэтому для тестов используйте сервер «Песочница» и тестовые адреса bounce-testing.haskimail.ru.
Рекомендации
Чтобы проверять, как письма выглядят у получателя, заведите отдельный реальный ящик для тестов, например devtesting@example.ru, или используйте поддомен, например testing@dev.example.ru. Отправляйте тестовые письма только на такие существующие адреса.
А возвраты тестируйте только на адресах вида hardbounce@bounce-testing.haskimail.ru: вы получите вебхук нужного типа, а письма на эти адреса не учитываются в месячном лимите.
Отправка на несколько адресов
Многие почтовые сервисы, например Gmail, Яндекс Почта и Mail.ru, поддерживают адреса с «+». Если ваш адрес example@gmail.com, письма на example+1@gmail.com и example+abc@gmail.com придут в тот же ящик. Haskimail считает такие адреса разными, поэтому так удобно проверять отправку на нескольких получателей с одним ящиком.