Инструкции и ответы на частые вопросы о Haskimail
Ищите здесь статьи или выберите категории, указанные ниже.
Обзор по темам
Инструкции, полезные советы и ответы на популярные вопросы, собранные по категориям.
Приступить к работе
Первые шаги в Haskimail: регистрация, модерация, подтверждение домена, выбор между API и SMTP и тестирование без риска.
Перейти
Отправка писем
Как отправлять письма через API и SMTP: реквизиты, каналы, пакетная отправка, коды ошибок, настройка Postfix и Sendmail.
Перейти
Входящие письма
Как принимать письма в своё приложение: входящий канал, вебхук, свой домен и правила блокировки.
Перейти
Домены и аутентификация
Подтверждение домена, DKIM, SPF и DMARC, а также пошаговые инструкции для популярных регистраторов и хостингов.
Перейти
Доставляемость
Как добиться попадания во «Входящие»: прогрев, возвраты, жалобы, стоп-листы, выделенные IP и советы по содержанию писем.
Перейти
Статистика и отслеживание
Отслеживание открытий и кликов, статистика каналов и разбивка по устройствам, почтовым клиентам и браузерам.
Перейти
Шаблоны
Шаблоны писем: создание, переменные, псевдонимы, проверка перед отправкой и перенос между серверами.
Перейти
Вебхуки
Уведомления о доставке, возвратах, жалобах, открытиях, кликах и отписках в реальном времени.
Перейти
Аккаунт, пользователи и оплата
Вход, профиль, пользователи и роли, безопасность, API-ключи, лимиты, тарифы и оплата.
Перейти
Интеграции и библиотеки
Официальные библиотеки, MCP-сервер, руководства для фреймворков и готовые интеграции с сервисами.
Перейти
Популярные статьи
Статьи, которые сейчас читают чаще всего.
Каналы отправки: создание, отправка, архивация
Каналы отправки помогают разделять письма разных типов внутри одного сервера. В каждом сервере можно создать дополнительные каналы двух типов. - Транзакционные каналы — для писем, которые отправляются в ответ на действие пользователя: сброс пароля, подтверждение заказа, уведомление об отправке. - Маркетинговые каналы — для писем, которые ваше приложение отправляет сразу многим получателям: новостные рассылки, анонсы, уведомления об изменении условий использования. Маркетинговые каналы работают на отдельной инфраструктуре, чтобы рассылки не влияли на доставляемость транзакционных писем. Важно: основным каналом сервера всегда остаётся транзакционный канал, созданный вместе с сервером. Маркетинговый канал нельзя сделать каналом по умолчанию. Чтобы отправить письмо через другой канал, его нужно явно указать одним из способов ниже. Как создать канал 1. Выберите сервер, в который хотите добавить канал. 2. Нажмите Создать канал отправки. Кнопка «Создать канал отправки» на вкладке «Каналы отправки» сервера 3. Укажите название канала и его тип: транзакционный или маркетинговый. 4. Нажмите Создать. Как отправить письмо через нужный канал У каждого канала есть ID — уникальный идентификатор. Он показан в правом верхнем углу страницы канала. Если канал при отправке не указан, письмо уходит через основной транзакционный канал сервера. ID канала в правом верхнем углу страницы канала отправки Через API Передайте ID канала в параметре MessageStream. Пример пакетной отправки через канал с ID 3007: curl "https://api.haskimail.ru/email/batch" \ -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "X-Haskimail-Server-Token: ваш_ключ_сервера" \ -d '[ { "From": "sender@example.com", "To": "recipient@example.com", "Subject": "Обновление условий использования", "Tag": "tosupdate", "HtmlBody": "<strong>Здравствуйте</strong>, наши условия изменились...", "TextBody": "Здравствуйте, наши условия изменились...", "MessageStream": "3007" }, { "From": "sender@example.com", "To": "another-recipient@example.com", "Subject": "Обновление условий использования", "Tag": "tosupdate", "HtmlBody": "<strong>Здравствуйте</strong>, наши условия изменились...", "TextBody": "Здравствуйте, наши условия изменились...", "MessageStream": "3007" } ]' Так же канал указывается при пакетной отправке по шаблонам. Ключи в TemplateModel — это переменные шаблона вместе с фигурными скобками: curl "https://api.haskimail.ru/email/batchWithTemplates" \ -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "X-Haskimail-Server-Token: ваш_ключ_сервера" \ -d '{ "Messages": [ { "From": "sender@example.com", "To": "recipient@example.com", "TemplateAlias": "tosupdate", "TemplateModel": { "{{customer_name}}": "Иван" }, "MessageStream": "3007" }, { "From": "sender@example.com", "To": "another-recipient@example.com", "TemplateAlias": "tosupdate", "TemplateModel": { "{{customer_name}}": "Анна" }, "MessageStream": "3007" } ] }' Подробнее о пакетной отправке — в статье «Пакетная отправка писем через API». Через SMTP При отправке по SMTP канал определяется по SMTP-реквизитам: у каждого канала свой логин и пароль. Чтобы отправить письмо через нужный канал: 1. Откройте настройки канала. 2. Скопируйте его SMTP-реквизиты: Блок SMTP в настройках канала: хост, порты, логин и пароль (значения заменены на демонстрационные) 3. Укажите их в настройках вашего SMTP-клиента: сервер smtp.haskimail.ru, порт 587 (STARTTLS), 465 (SSL), 25 или 2525 (TLS). Архивация канала В настройках канала можно нажать Архивировать канал. Архивный канал и его статистика автоматически удаляются через 45 дней. Блок «Архивировать канал» в настройках канала отправки Пока канал не удалён, его можно восстановить: на странице сервера выберите Посмотреть архивные каналы. Кнопка «Посмотреть архивные каналы» под списком каналов сервера Архивировать и восстанавливать каналы можно и через API.
Отправка писемКакие SMTP-реквизиты и API-ключи нужно использовать?
Какие данные нужны для подключения, зависит от способа отправки: через API или через SMTP. Если вы отправляете через API Используйте серверный API-ключ. Его выпускают в личном кабинете: SMTP-серверы → ваш сервер → API-ключи → Выпустить новый ключ. У каждого сервера свои ключи, значение показывается сразу после выпуска. Ключ передаётся в заголовке X-Haskimail-Server-Token. Как выпустить и заменить ключ — в статье «Как сменить серверный API-ключ». Вкладка «API-ключи» сервера: список ключей с датой создания, сроком действия и статусом, форма «Выпустить новый ключ» (значения ключей заменены на демонстрационные) Чтобы отправить письмо через определённый канал, укажите в запросе параметр MessageStream с ID канала. Если параметр не указан, письмо уйдёт через транзакционный канал сервера по умолчанию. Не смешивайте транзакционные и маркетинговые письма в одном канале — это важно для доставляемости. ID канала в правом верхнем углу страницы канала отправки — его передают в параметре MessageStream Если вы отправляете через SMTP Параметр Значение Сервер smtp.haskimail.ru Порт 587 (STARTTLS), 465 (SSL), 25 или 2525 (TLS) Логин и пароль SMTP-реквизиты канала отправки Вместо реквизитов канала можно авторизоваться серверным API-ключом: укажите его и как логин, и как пароль. SMTP-реквизиты есть у каждого канала. Найти их можно в настройках канала: SMTP-серверы → ваш сервер → канал → Инструкции по отправке → SMTP или на вкладке Настройки канала. По логину и паролю Haskimail понимает, через какой канал отправлять письмо, поэтому для транзакционных писем и для рассылок используйте реквизиты соответствующих каналов. Если реквизиты попали к посторонним, их можно перевыпустить в настройках канала. Вкладка «Инструкции по отправке» → SMTP: хост, порты и реквизиты канала (значения заменены на демонстрационные) Соединение с сервером всегда шифруется: на портах 25 и 2525 — по TLS, на порту 587 — через STARTTLS, на порту 465 — сразу по SSL. Подробнее — в документации по SMTP. Если вы отправляете письма через Postfix, воспользуйтесь инструкцией «Как настроить Postfix для отправки через Haskimail».
ДоставляемостьКак прогреть домен для email-рассылки
Прогрев домена — это постепенное создание хорошей репутации у почтовых сервисов на основе истории ваших рассылок. Задача — шаг за шагом показать почтовым сервисам, что с вашего домена: - письма отправляются регулярно; - получатели их открывают и переходят по ссылкам, а жалоб на спам почти нет. Можно ли обойтись без прогрева? Нет. У почтовых сервисов ещё нет данных о реакции получателей на письма с нового домена, поэтому большая рассылка с него вызывает подозрения. Представьте: с нового сайта вдруг уходят письма на огромное число адресов. Сразу возникают вопросы: - честно ли собрана база подписчиков? - не купили ли адреса у третьих лиц, чтобы рассылать спам? Чтобы не рисковать, почтовые сервисы могут сразу отправить такие письма в спам. Прогрев нужен, чтобы письма попадали во «Входящие». Как подготовиться к прогреву: простые шаги Перед первой рассылкой сделайте базовые технические настройки: 1. Настройте DKIM и SPF. Так почтовые сервисы убедятся, что вы действительно владеете доменом. Записи добавляются в DNS у регистратора домена или на хостинге и начинают действовать в течение 1–48 часов. Подробная инструкция — в статье «Как подтвердить домен». Также рекомендуем настроить DMARC. 2. Получайте данные о жалобах (FBL). Если вы отправляете через Haskimail, это уже настроено: жалобы на спам видны в статистике, а адреса пожаловавшихся автоматически попадают в стоп-список. Если у вас собственный почтовый сервер, подключите FBL в панелях почтовых сервисов. 3. PTR-запись нужна только для собственного почтового сервера: она связывает его IP-адрес с доменом. В Haskimail это уже сделано. Формирование графика для прогрева Скорость прогрева зависит от нескольких факторов: - насколько чистая база; - репутация IP-адреса и домена отправителя; - насколько активны подписчики. Если база чистая и в ней реальные адреса заинтересованных людей, прогрев пройдёт быстро. Начинайте с небольших объёмов: сначала отправляйте самым активным подписчикам, затем постепенно добавляйте менее активные сегменты и следите за результатами. Не торопитесь: на малых объёмах проще заметить проблему — низкую активность или попадание в спам — и замедлиться. Пример графика прогрева: Пример графика прогрева домена Во время прогрева следите за показателями: 1. Если открытий и кликов мало, снизьте темп и не увеличивайте число получателей. 2. Регулярно проверяйте статистику: доля возвратов должна быть ниже 2%, жалоб на спам — ниже 0,1%. 3. Проверяйте, не попал ли ваш домен в чёрные списки, например нашим инструментом.
Статистика и отслеживаниеОтслеживание ссылок. Принцип работы
Отслеживание ссылок показывает, по каким ссылкам в ваших письмах переходят получатели. Включить его можно после того, как аккаунт пройдёт модерацию, — для всего сервера или для отдельного письма. Обзор Когда отслеживание включено, Haskimail находит ссылки в HTML-версии, текстовой версии или в обеих — в зависимости от настроек — и заменяет их на ссылки через домен отслеживания Haskimail или через ваш собственный поддомен, если он настроен (см. ниже). Когда получатель переходит по ссылке, мы сохраняем данные о клике и сразу перенаправляем его на исходный адрес. Сохраняются: - IP - User-Agent - ID ссылки - Временная метка Просмотр деталей отслеживания ссылок Успешно отслеживаемые ссылки будут отображаться в логе активности канала отправки и выглядеть так: Отслеживаемая ссылка в логе активности канала отправки Отслеживаемая ссылка в логе активности канала отправки, подробный вид Если открыть письмо для более подробной информации, можно увидеть данные о клике: Данные о клике в карточке письма Свой домен отслеживания По умолчанию ссылки в письмах ведут через домен отслеживания Haskimail. Чтобы в ссылках был ваш домен, настройте свой поддомен отслеживания: 1. Откройте раздел Домены и отправители и нажмите DNS настройки у нужного домена. 2. В блоке Кастомный домен трекинга укажите поддомен этого домена, например track.example.ru. 3. Нажмите Включить трекинг. 4. Добавьте в DNS домена CNAME-запись, которая ведёт с этого поддомена на haski.email, например track.example.ru → haski.email. Точное значение показано в том же блоке. Блок «Кастомный домен трекинга» на странице «Настройки DNS» домена Свой поддомен отслеживания улучшает доставляемость и узнаваемость: получатели видят в ссылках ваш домен, а не домен сервиса. Форматирование ссылок Не используйте сам адрес ссылки как её текст. Если текст ссылки выглядит как один адрес, а ведёт она через сервер отслеживания, почтовые сервисы, например Gmail и Mail.ru, могут принять письмо за фишинг. Неправильно: <a href="http://example.com">http://example.com</a> Правильно: <a href="http://example.com">Посетите наш сайт</a>
Домены и аутентификацияКак подтвердить домен
Чтобы отправлять письма со своего домена, его нужно подтвердить: добавить в DNS домена две TXT-записи — DKIM и SPF. Обе записи Haskimail создаёт сам, вам остаётся скопировать их к своему DNS-провайдеру. Подтверждение DKIM 1. Перейдите на страницу Домены и отправители: Раздел «Домены и отправители» 2. Найдите нужный домен и нажмите DNS Настройки или Добавьте DKIM DNS запись. Ссылка «DNS настройки» у домена 3. Откроется DKIM-запись, которую нужно добавить в DNS как TXT-запись: Страница «Настройки DNS»: DKIM-запись dm._domainkey типа TXT (значение демонстрационное) 4. Откройте панель управления DNS у вашего регистратора или хостинга. 5. Добавьте TXT-запись: - Имя (хост): dm2._domainkey — полное имя будет dm2._domainkey.ваш-домен.ru. У доменов, добавленных раньше, запись называется dm._domainkey и содержит ключ 1024 бита — такой ключ мы рекомендуем перевыпустить (см. шаг 7). Всегда копируйте имя со страницы настроек; - Значение: строка, которая начинается с v=DKIM1; — скопируйте её целиком со страницы настроек. 6. Haskimail проверяет записи автоматически, обычно в течение 48 часов. Чтобы не ждать, нажмите кнопку Проверка. 7. Если ключ DKIM нужно заменить — например, чтобы перейти со старого ключа 1024 бита на ключ 2048 бит или после утечки, — нажмите Перевыпустить ключ рядом с записью. После этого обновите значение TXT-записи у DNS-провайдера и снова нажмите Проверка. 8. Когда DKIM подтверждён, статус сменится на Подтверждена, и все письма с этого домена будут подписываться DKIM. Следующий шаг — SPF. Подтверждённый домен: статусы «DKIM Подтвержден» и «SPF подтвержден» Подтверждение SPF SPF-запись показывает, каким почтовым серверам разрешено отправлять письма от имени вашего домена. 1. Значения для SPF находятся на той же странице настроек DNS, что и DKIM: Страница «Настройки DNS»: SPF-запись типа TXT для самого домена со значением v=spf1 include:_spf.haskisender.ru ~all 2. У вашего DNS-провайдера добавьте TXT-запись: - Имя (хост): @ — то есть сам домен, например example.ru; - Значение: строка, которая начинается с v=spf1, — скопируйте её со страницы настроек. Актуальный механизм Haskimail — include:_spf.haskisender.ru. Старый вариант include:_spf.dashasender.ru пока работает, но его лучше заменить на новый. 3. Важно: у домена может быть только одна SPF-запись. Если она уже есть, не создавайте вторую, а добавьте в существующую механизм include Haskimail. Как это сделать — в статье «Как правильно объединять SPF-записи». 4. SPF подтвердится автоматически в течение 48 часов, или нажмите Проверка вручную. После этого письма с вашего домена будут проходить проверку SPF. Свой домен отслеживания На той же странице есть необязательный блок Кастомный домен трекинга. Он нужен, чтобы ссылки в письмах вели через ваш поддомен, а не через домен Haskimail. Подробнее — в статье «Отслеживание ссылок. Принцип работы». Инструкции для конкретных регистраторов и хостингов — в разделе «Настройка DNS-записей».
Приступить к работеНачало работы с 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.