Приступить к работе
От Сергей
От Сергей
Первые шаги в Haskimail: регистрация, модерация, подтверждение домена, выбор между API и SMTP и тестирование без риска.
Начало работы с Haskimail
Начать работу с Haskimail просто. Подключиться можно через SMTP или через API и официальные библиотеки — выбирайте то, что удобнее. Haskimail отправляет транзакционные письма (уведомления о сбросе пароля, квитанции, технические письма) отдельно от массовых рассылок (новостей, анонсов и других подобных писем). Для этого в каждом сервере есть каналы отправки, и разные каналы работают на разных IP-адресах. Такое разделение помогает поддерживать высокую репутацию наших IP-адресов, чтобы ваши письма доставлялись быстро и надёжно. Шаг 1. Регистрация Создание аккаунта занимает пару минут, а бесплатный тариф включает 100 писем в месяц. Зарегистрируйтесь по ссылке. Укажите имя, рабочий email и пароль, отметьте согласие с офертой и АнтиСПАМ-политикой и с обработкой персональных данных и нажмите «Зарегистрироваться». Форма регистрации в Haskimail В личном кабинете уже будет создан ваш первый сервер для отправки писем. Серверы помогают разделить почту по проектам, клиентам или рабочим областям. При необходимости можно добавить ещё серверы — всего в аккаунте их может быть до 3. Подробнее — в статье «Лимиты аккаунта». Шаг 2. Добавление адреса отправителя или домена Чтобы отправлять письма через Haskimail, нужно добавить адрес, который будет стоять в поле «От кого». Если вы отправляете письма с адресов на своём домене, удобнее сразу подтвердить весь домен. Как это сделать, рассказываем в статье «Как подтвердить домен». Подтверждение адреса и домена нужно, чтобы убедиться, что вы владеете почтовыми ящиками, с которых планируете отправлять письма. Это помогает нам поддерживать безупречную репутацию у почтовых провайдеров и быстро доставлять ваши письма во «Входящие». Добавить домен или адрес отправителя можно в разделе «Домены и отправители»: Раздел «Домены и отправители» и кнопка «Добавить домен или обратный адрес» Обратите внимание: если домен подтверждён, отдельно добавлять адреса на этом домене не нужно — отправка разрешена со всего домена. Шаг 3. Настройка DKIM и SPF Чтобы подтвердить домен, обязательно нужно добавить DKIM-запись в DNS. Для каждого домена система создаёт DKIM- и SPF-записи, которые нужно добавить в DNS. Как настроить: 1. В разделе «Домены и отправители» нажмите DNS настройки у нужного домена. Ссылка «DNS настройки» у домена в разделе «Домены и отправители» 2. На открывшейся странице будут все данные для настройки. 3. Добавьте указанные DKIM- и SPF-записи в DNS вашего домена. 4. После добавления нажмите кнопку «Проверка». Страница «Настройки DNS» неподтверждённого домена: кнопки «Проверка» у DKIM и SPF Специальных знаний для этого не нужно. Пошаговые инструкции для популярных регистраторов и хостингов собраны в разделе «Настройка DNS-записей». Шаг 4. Модерация Мы вручную проверяем каждый новый аккаунт, чтобы сохранять быструю доставку и высокую репутацию наших IP-адресов. Чтобы отправить аккаунт на проверку, заполните анкету в личном кабинете — она поможет нам лучше узнать ваш проект. Подробнее — в статье «Модерация аккаунта». Отправка аккаунта на модерацию в личном кабинете Haskimail Шаг 5. Подключение к вашей системе Когда настройки готовы и модерация пройдена, подключите Haskimail к своему приложению. SMTP. Если ваше приложение уже отправляет письма через SMTP, достаточно поменять настройки: сервер smtp.haskimail.ru, порт 587 (STARTTLS), 465 (SSL), 25 или 2525 (TLS). Логин и пароль — SMTP-реквизиты канала из его настроек. Подробнее — в документации по SMTP. API и библиотеки. Начните с руководства по отправке через API или используйте официальные библиотеки для Go, PHP, Python, Node.js и Java. Если вы переезжаете с другого сервиса, пройдите чек-лист переезда. Незнакомые термины объяснены в «Словаре терминов». Шаг 6. Мы всегда готовы помочь Если возникнут вопросы или сложности, напишите в поддержку — поможем с настройкой и переходом на Haskimail.
Словарь терминов
Короткие определения терминов, которые встречаются в личном кабинете, API и статьях базы знаний. Устройство аккаунта Аккаунт — ваша учётная запись в Haskimail. Объединяет серверы, домены, пользователей, тариф и оплату. Сервер (SMTP-сервер) — рабочая область внутри аккаунта: проект, клиент или окружение. У каждого сервера свои каналы, шаблоны, API-ключи и настройки отслеживания. В аккаунте до 3 серверов — см. «Лимиты аккаунта». Сервер «Песочница» — сервер, письма из которого проходят все проверки, но не доставляются получателям. Нужен для тестов — см. «Сервер «Песочница»». Канал отправки — поток писем одного типа внутри сервера. Бывает транзакционным (письма одному получателю в ответ на его действие) и маркетинговым (одинаковые письма многим получателям). У каждого канала свои SMTP-реквизиты, статистика, стоп-лист и вебхуки — см. «Каналы отправки». Входящий канал — канал, который принимает письма и передаёт их вашему приложению в виде JSON — см. «Как принимать входящие письма». Отправители и домены Адрес отправителя — адрес в поле «От кого». Отправлять можно с подтверждённого адреса или с любого адреса подтверждённого домена. В кабинете он называется «обратный адрес». Подтверждение домена — добавление DKIM- и SPF-записей в DNS домена, после которого с него можно отправлять письма с любого адреса — см. «Как подтвердить домен». DKIM, SPF, DMARC — стандарты, по которым почтовые сервисы проверяют, что письмо действительно отправлено с вашего домена. Подробнее: DKIM, SPF, DMARC. Return-Path — служебный адрес, на который почтовые серверы возвращают сообщения о недоставке. По умолчанию Haskimail использует свой домен, чтобы обрабатывать возвраты. Ключи и доступ Серверный API-ключ — ключ для отправки писем и работы с данными одного сервера. Передаётся в заголовке X-Haskimail-Server-Token. API-ключ аккаунта — ключ для операций со всем аккаунтом: серверы, домены, перенос шаблонов, MCP-сервер. Передаётся в заголовке X-Haskimail-Account-Token. SMTP-реквизиты — логин и пароль канала для отправки по SMTP. По ним Haskimail понимает, через какой канал отправить письмо. Подробнее — в статье «Типы ключей». Письма и события Тег — метка письма, например welcome или order. По тегам фильтруют статистику и события. Метаданные — произвольные пары «ключ — значение», привязанные к письму. См. «Теги и метаданные писем». MessageID — уникальный идентификатор письма, который API возвращает при отправке. По нему письмо связывают с событиями. Возврат (bounce) — сообщение сервера получателя о том, что письмо не доставлено: жёсткий, мягкий, блокировка или спам-блокировка — см. «Возвраты, блокировки и жалобы на спам». Жалоба на спам — получатель отметил доставленное письмо как спам. Стоп-лист — адреса, на которые письма канала больше не отправляются: после жёсткого возврата, жалобы, отписки или добавленные вручную. В кабинете — вкладка «Стоп-списки» канала. Вебхук — HTTP-запрос, который Haskimail отправляет на ваш URL при событии с письмом — см. «Модульные вебхуки». Лог активности — список писем канала с их статусами и событиями за последние 45 дней. Прогрев — постепенное увеличение объёма отправки с нового домена или IP-адреса, чтобы почтовые сервисы накопили о нём положительную историю — см. «Как прогреть домен».
Модерация аккаунта
Сразу после регистрации в Haskimail письма можно отправлять только на адреса доменов, которые вы добавили и подтвердили в аккаунте. Отправка на остальные адреса откроется после модерации. Мы вручную проверяем каждый новый аккаунт, чтобы убедиться, что через него не будут рассылаться письма, которые навредят репутации наших IP-адресов и доставляемости писем других клиентов. Как отправить аккаунт на проверку? Отправить заявку может только владелец аккаунта. Кнопка для этого есть в личном кабинете. Кнопка отправки заявки на модерацию в личном кабинете Haskimail Сколько длится проверка? Обычно меньше 24 часов в рабочие дни, в выходные — немного дольше. О результате мы сообщим. Какие письма подходят для Haskimail, рассказываем в статье «Массовые и транзакционные письма». Что можно делать до одобрения? Пока аккаунт на проверке, вы можете: 1. Отправлять письма на домены, которые вы добавили и подтвердили в аккаунте. 2. Работать с API. 3. Создавать и использовать шаблоны. 4. Приглашать других пользователей в аккаунт. 5. Настраивать и проверять вебхуки. 6. Тестировать отправку: сервер «Песочница» принимает письма на любые адреса, а на тестовые адреса bounce-testing.haskimail.ru можно писать с любого сервера. Обратите внимание: отслеживание ссылок включается только после модерации. Что делать, если аккаунт не прошёл модерацию? Если вы считаете, что аккаунт отклонён по ошибке, напишите на support@haskimail.ru и приложите примеры писем, которые планируете отправлять через Haskimail. Мы рассмотрим заявку повторно.
Как настроить отправку писем из приложения
Чтобы отправлять письма из своего приложения через Haskimail, пройдите шесть шагов: 1. Выберите способ отправки: API или SMTP. 2. Подтвердите адреса или домены, с которых будете отправлять письма. 3. Настройте каналы отправки для разных типов писем. 4. Отправьте тестовое письмо. 5. Подключите Haskimail к приложению. 6. Подключите вебхуки и шаблоны. Шаг 1. Выберите API или SMTP Отправлять письма можно обоими способами. Выбор зависит от того, сколько вы готовы менять в коде приложения. Способ Плюсы Минусы API Доступны все возможности Haskimail. В ответе приходят ID письма и коды ошибок. Есть официальные библиотеки для популярных языков Нужно дорабатывать код приложения и обновлять его при изменениях в API SMTP Почти не нужно менять код: достаточно поменять настройки почты в приложении. Легко перейти с другого сервиса Недоступны пакетная отправка, шаблоны и подробные коды ошибок Шаг 2. Подтвердите адреса для отправки После регистрации в аккаунте автоматически появится первый сервер. Серверы помогают разделять отправку по проектам, клиентам или окружениям — как папки на компьютере. У каждого сервера свои API-ключи и свои настройки отслеживания открытий и ссылок. Внутри сервера письма разделяются по каналам отправки. Транзакционные каналы — для персональных писем, которые уходят в ответ на действия пользователя: приветствие, сброс пароля, чек. Маркетинговые — для массовых писем: анонсов, новостей, рассылок. Отправлять письма можно с подтверждённого адреса или с любого адреса подтверждённого домена. Так Haskimail убеждается, что почтовые ящики принадлежат вам: это защищает от спама и помогает сохранять хорошую репутацию у почтовых сервисов. Количество адресов и доменов не ограничено. Подтверждение адреса отправителя Сразу после регистрации кабинет предложит добавить адрес отправителя. Позже новые адреса можно добавить в разделе Домены и отправители. Раздел «Домены и отправители» и кнопка «Добавить домен или обратный адрес» Нажмите Подтвердить обратный адрес и укажите адрес, который будет стоять в поле «От кого». На него придёт письмо со ссылкой для подтверждения. Страница «Добавить домен или обратный адрес»: кнопка «Подтвердить обратный адрес» Подтверждение домена После подтверждения домена можно отправлять письма с любого адреса на нём. Например, после подтверждения example.ru можно отправлять письма с someone@example.ru. 1. Откройте раздел Домены и отправители. 2. Нажмите Добавить домен и введите домен. Страница «Добавить домен или обратный адрес»: кнопка «Добавить домен» 3. Скопируйте DKIM- и SPF-записи и добавьте их в DNS домена. Подробнее — в статье «Как подтвердить домен». Страница «Настройки DNS» домена 4. Дождитесь подтверждения. Изменения в DNS вступают в силу до 48 часов, но обычно быстрее. Шаг 3. Настройте каналы отправки Создайте отдельный канал для каждого типа писем. Тогда статистика и уведомления по каждому типу будут видны отдельно. Это помогает и с отписками. Если получатель отпишется от канала с новостями, он продолжит получать важные письма из другого канала, например об изменении условий использования. Массовые рассылки лучше отправлять с поддомена, а транзакционные письма — с основного домена. Так советуют крупные почтовые сервисы, в том числе Mail.ru: репутация рассылок не будет влиять на доставку важных транзакционных писем. В API канал указывается параметром MessageStream, в SMTP — реквизитами канала. Подробнее — в статье «Каналы отправки: создание, отправка, архивация». Каналы отправки сервера и кнопка «Создать канал отправки» Шаг 4. Отправьте тестовое письмо Когда адрес или домен подтверждён, отправьте тестовое письмо. Пока аккаунт на модерации, отправлять можно только на адреса подтверждённых доменов. Письмо можно отправить из Postman или другого HTTP-клиента или командой cURL в терминале. Серверный API-ключ выпускается на вкладке API-ключи сервера — подробнее в статье «Как сменить серверный API-ключ». curl "https://api.haskimail.ru/email" \ -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "X-Haskimail-Server-Token: ваш_ключ_сервера" \ -d '{ "From": "sender@example.com", "To": "receiver@example.com", "Subject": "Haskimail test", "TextBody": "Hello dear Haskimail user.", "HtmlBody": "<html><body><strong>Hello</strong> dear Haskimail user.</body></html>" }' Шаг 5. Подключите Haskimail к приложению Подробные инструкции — в документации для разработчиков: отправка через API и отправка через SMTP. Готовый код для популярных языков — в статье «Официальные библиотеки». Шаг 6. Подключите вебхуки и шаблоны Вебхуки Haskimail отправляет вебхуки о доставке, открытиях, кликах, возвратах, жалобах на спам и изменениях подписки. Вебхук — это HTTP POST-запрос с JSON на адрес, который вы указали в настройках канала отправки. Так приложение узнаёт о событиях сразу, без лишних запросов к API. С помощью вебхуков можно: - узнавать, что письмо доставлено или открыто; - получать данные о кликах по ссылкам; - сразу узнавать о возвратах и жалобах на спам. Вебхуки всех событий приходят в одном формате. Например, так выглядит уведомление о доставке: { "event": "delivered", "recipient": "ivan@example.com", "email": "ivan@example.com", "message_id": "a41d7c9e2b6f4e0d8c3b5a1f9e7d2c60", "code": "", "description": "", "error": "", "bounce_category": "", "user_id": "48213", "campaign_id": "orders", "member_id": "0", "event_time": "2026-10-07 14:30:15", "event_time_utc": "2026-10-07 11:30:15", "secret": "5f2b0c1d9a7e4c3b8d6f1a2e3c4b5d6e", "custom_vars": "{\"order_id\":\"1042\"}", "server_id": 11834, "stream_id": "2081" } Поле event показывает тип события: delivered — доставка, opened — открытие, clicked — клик, bounced — возврат, complained — жалоба на спам, subscriptionchange — изменение подписки. По полю message_id событие легко связать с отправленным письмом. У возвратов дополнительно заполнены поля code, error и bounce_category с причиной недоставки. Событие доставки означает, что письмо принял почтовый сервер получателя. Попало ли оно во «Входящие» или в спам, по нему узнать нельзя. Подробнее — в разделе «Вебхуки» и в документации. Шаблоны Шаблоны позволяют хранить вёрстку писем в Haskimail, а из приложения передавать только данные. Подробнее — в статье «Использование шаблонов в Haskimail».
Способы интеграции с Haskimail
Задачи у всех разные: кому-то нужно просто отправлять сервисные письма, кому-то — встроить почту в продукт и собирать аналитику. Haskimail подходит и агентствам с десятками клиентов, и разработчикам собственных приложений. Подключитесь один раз через SMTP или API — и дальше письма уходят сами. Рассказываем о самых популярных сценариях. Простое подключение через SMTP Если вам нужна надёжная доставка без ежедневной работы с отчётами, подойдёт подключение по SMTP. Если ваше приложение уже отправляет письма через SMTP, переход на Haskimail займёт пару минут: укажите сервер smtp.haskimail.ru и SMTP-реквизиты канала из его настроек. Это идеальный вариант, если расширенные возможности платформы вам не нужны. Настроили один раз — и письма доходят, а вы занимаетесь своим бизнесом. Продвинутая интеграция через API Если вам важны данные и аналитика, используйте API. С ним Haskimail встраивается прямо в ваше приложение: вы получаете данные о письмах, показываете их в нужных местах и следите за эффективностью транзакционных писем. Через API доступны: - события по каждому письму: доставка, открытия, клики; - сводная статистика; - пакетная отправка до 500 писем за запрос; - шаблоны; - подробные коды ответов и автоматические повторные попытки при временных отказах. Для Go, PHP, Python, Node.js и Java есть официальные библиотеки: они берут на себя запросы к API и разбор ответов, поэтому интеграция занимает несколько строк кода. Работа с клиентами агентства Если вы агентство и отправляете письма от имени клиентов, в Haskimail это легко организовать. - Отдельные серверы и каналы для клиентов. Аккаунт состоит из серверов, а серверы — из каналов отправки. В аккаунте до 3 серверов, поэтому клиентов удобно разделять каналами внутри сервера: у каждого канала своя статистика, стоп-лист и SMTP-реквизиты. Если нужно больше серверов, напишите в поддержку — подберём индивидуальные условия. Подробнее — в статье «Лимиты аккаунта». - Простое подтверждение доменов. Добавьте пару DNS-записей — и можно отправлять письма с домена клиента. Домены можно добавлять и через API. Подробнее — в статье «Как подтвердить домен». - Шаблоны. Если у клиентов похожие письма — сброс пароля, уведомления, счета, — используйте готовые HTML- и текстовые шаблоны и адаптируйте их под каждого клиента прямо в интерфейсе. Небольшие проекты Haskimail отлично подходит для малого бизнеса и собственных небольших проектов. С API и подробной документацией интеграция занимает минимум времени, и о почте больше не нужно думать. Если проект вырастет, Haskimail вырастет вместе с ним: начните с базовой настройки и подключайте продвинутые возможности по мере необходимости. А для старта есть бесплатный тариф на 100 писем в месяц.
Массовые и транзакционные письма
Нас часто спрашивают, чем транзакционные письма отличаются от массовых (маркетинговых). Разбираем разницу и объясняем, как каналы отправки Haskimail помогают доставлять письма обоих типов. Что такое транзакционные письма? Транзакционное письмо — это персональное и обычно срочное сообщение одному получателю. Чаще всего оно отправляется в ответ на действие пользователя на сайте или в приложении, и получатель его ждёт. Примеры: - приветственное письмо после регистрации; - подтверждение заказа; - уведомление о новом комментарии; - сброс пароля. В Haskimail такие письма отправляются через транзакционный канал. Что такое массовые письма? Массовое письмо — это одинаковое сообщение, которое отправляется сразу многим получателям. Отдельного действия от получателя для отправки не требуется. Примеры: - анонсы новых продуктов; - новостные рассылки; - акции и промо-письма; - уведомления об изменении условий обслуживания. В Haskimail такие письма отправляются через канал массовых рассылок. Почему их нужно разделять? У транзакционных и массовых писем разные источники и разные риски. Если отправлять их с одного IP-адреса, почтовые сервисы могут принять срочное транзакционное письмо за маркетинговую рассылку. Это приводит к задержкам и проблемам с доставкой. В Haskimail транзакционные и массовые письма не смешиваются и отправляются с разных диапазонов IP-адресов. Такое разделение рекомендуют и крупные почтовые сервисы, в том числе Mail.ru, Яндекс и Gmail. Оно помогает провайдерам правильно определять, какие письма можно доставлять во «Входящие». Вам ничего не нужно настраивать: достаточно отправлять письма через подходящий канал, а IP-адреса Haskimail подберёт автоматически. Можно ли отправлять массовые письма через Haskimail? Да. В каждом сервере есть канал для массовых рассылок, и через него можно отправлять анонсы, новостные рассылки и другие маркетинговые письма. Скорость и доставляемость при этом остаются такими же высокими, как у транзакционных писем. Как сохранить хорошую репутацию Чтобы почтовые сервисы доверяли вашим письмам, регулярно проверяйте несколько показателей. - Отправляйте полезные письма. Транзакционные письма должны быть действительно нужны клиенту — тогда их открывают и читают. В массовых рассылках следите за качеством базы и контента. - Держите жалобы на спам ниже 0,1%. Если доля жалоб приближается к 0,3%, почтовые сервисы начинают отправлять письма в спам. - Держите возвраты ниже 2%. Отправляйте письма только на существующие адреса и регулярно чистите базу от неактивных адресов. - Настройте аутентификацию. Подтвердите домен по DKIM и SPF и добавьте DMARC — см. «Как подтвердить домен». Подробнее — в статье «Как улучшить доставку писем». Как работают каналы отправки? Каналы отправки — это способ направлять разные типы писем через отдельную инфраструктуру. Каждый канал относится к одному из типов: транзакционный (письма одному получателю) или массовый (письма многим получателям). Haskimail отправляет письма каждого канала через свои IP-адреса, чтобы оптимизировать доставку для обоих типов. Как создать канал и отправлять через него письма, рассказываем в статье «Каналы отправки: создание, отправка, архивация».
Как перейти на Haskimail с другого сервиса
Если вы уже отправляете письма через другой сервис, переезд на Haskimail занимает от часа до нескольких дней — в зависимости от объёма и числа интеграций. Пройдите по шагам ниже, чтобы письма не терялись, а репутация не пострадала. 1. Подготовьте аккаунт 1. Зарегистрируйтесь и отправьте аккаунт на модерацию. 2. Решите, как разделить письма: какие серверы и каналы нужны. Транзакционные письма и рассылки держите в разных каналах — см. «Массовые и транзакционные письма». 2. Подтвердите домен, не ломая старую отправку 1. Добавьте домен в разделе «Домены и отправители» и внесите DKIM-запись Haskimail. DKIM-записи разных сервисов отличаются селектором и не мешают друг другу — старую запись пока не удаляйте. 2. Добавьте Haskimail в существующую SPF-запись через include, не создавая вторую запись. Старый сервис из SPF удалите только после полного переезда. См. «Как правильно объединять SPF-записи». 3. Перенесите стоп-листы Адреса, которые отписались, пожаловались на спам или дали жёсткий возврат у прежнего сервиса, не должны получать письма и через Haskimail. Выгрузите их из старого сервиса и добавьте в стоп-лист нужного канала — вручную (до 50 адресов за раз) или через API стоп-листов. Подробнее — в статье «Как восстановить неактивный адрес». 4. Перенесите шаблоны Если вы храните шаблоны у прежнего сервиса, создайте их в Haskimail. Переменные в Haskimail пишутся в двойных фигурных скобках, например {{name}} — см. «Использование шаблонов». 5. Переключите отправку - SMTP — замените сервер, порт и реквизиты на smtp.haskimail.ru и SMTP-реквизиты канала — см. «Какие SMTP-реквизиты и API-ключи нужно использовать?». - API — подключите официальную библиотеку или отправляйте запросы к https://api.haskimail.ru. Сначала проверьте интеграцию на сервере «Песочница» или с тестовым ключом. 6. Наращивайте объём постепенно Даже если домен давно используется, почтовые сервисы заметят смену IP-адресов отправки. Переводите трафик частями: например, сначала транзакционные письма, затем рассылки, начиная с самых активных получателей. См. «Как прогреть домен». 7. Подключите вебхуки и проверьте результат Настройте вебхуки на доставку, возвраты и жалобы, а первые дни следите за статистикой канала: возвраты должны быть ниже 2%, жалобы — ниже 0,1%. Если нужна помощь с переездом, напишите на support@haskimail.ru — подскажем по вашему случаю.
Сервер «Песочница»: руководство по использованию
Что такое сервер «Песочница» Сервер «Песочница» — это безопасная тестовая среда внутри Haskimail. Она работает как обычный сервер, но письма из неё не доставляются получателям. Главное о «Песочнице»: - Ни одно письмо из «Песочницы» не попадёт в реальный почтовый ящик. - Все возможности сохраняются: можно отправлять письма через API и SMTP и следить за событиями в интерфейсе, через API или с помощью вебхуков. - Письма проходят через инфраструктуру Haskimail, поэтому их статусы и события можно анализировать так же, как у обычных писем. - Тестовые письма учитываются в месячном лимите тарифа. - Пока аккаунт на модерации, из «Песочницы» можно отправлять письма на любые адреса — они всё равно никуда не уходят. Кому пригодится «Песочница» - Новым пользователям — чтобы спокойно разобраться в Haskimail без риска для рабочих рассылок. - Разработчикам и интеграторам — чтобы тестировать и отлаживать интеграцию по API и SMTP в изолированной среде. Как создать сервер «Песочница» 1. Начните создавать новый сервер в Haskimail. 2. В настройках выберите тип сервера «Песочница». Создание сервера: выбран тип «Песочница» 3. Задайте имя сервера, выберите цвет и нажмите «Создать сервер». Готово. Что можно проверить в «Песочнице» - Отправку писем через API или SMTP (без реальной доставки). - Правильность запросов и обработку ответов API. - Обработку событий — доставки, открытий, кликов, отписок. Для этого отправляйте письма на специальные тестовые адреса: события появятся в интерфейсе и придут на вебхуки. - Реакцию вашего приложения на разные события и статусы. - Настройки каналов, правила обработки входящей почты и другие функции — без риска для рабочих процессов. Важно знать - Письма учитываются в лимите. Хотя письма не доставляются, они проходят через систему и считаются в месячном лимите отправки. Учитывайте это при планировании тестов. - Доставку проверить нельзя. «Песочница» не подходит, чтобы проверить, попадают ли письма во «Входящие» или в «Спам»: реальной доставки нет. - Изолированная среда. «Песочница» отделена от рабочих серверов: настройки, получатели и статистика не пересекаются.
Как тестировать письма перед отправкой
Прежде чем отправлять письма реальным получателям, проверьте их на тестовых отправках. Удобнее всего завести для этого отдельное тестовое окружение: так вы безопасно найдёте проблемы с отправкой и отображением писем. Вот что для этого есть в 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 считает такие адреса разными, поэтому так удобно проверять отправку на нескольких получателей с одним ящиком.