Советы и ответы от команды Haskimail
Ищите здесь статьи или выберите категории, указанные ниже.
Обзор по темам
Инструкции, полезные советы и ответы на популярные вопросы, собранные по категориям.
Приступить к работе
Перейти
Как отправлять письма
Перейти
Общие вопросы
Перейти
Аккаунт и оплата
Перейти
Рекомендации для отправки писем
Перейти
Доставляемость
Перейти
Открытия и клики
Перейти
Шаблоны
Перейти
Настройка DNS-записей
Перейти
Вебхуки
Перейти
Выделенные IP-адреса
Перейти
Отчеты DMARC
Перейти
Интеграции
Перейти
Популярные статьи
Статьи, которые сейчас читают чаще всего.
Каналы отправки. Создание, рассылка, архивация.
Добавление дополнительных каналов отправки на вашем аккаунте Haskimail позволяет создавать новые Транзакционные или Маркетинговые каналы и отправлять все письма вашего приложения через Haskimail. - Транзакционные каналы отправки Предназначены для писем, вызванных действием пользователя — например, сброс пароля или уведомление об отправке. - Маркетинговые каналы отправки Используются для сообщений, которые ваше приложение отправляет сразу многим получателям — например, уведомление об изменении условий использования. Haskimail использует отдельную инфраструктуру для маркетинговых каналов, чтобы сохранить высокую доставляемость транзакционных писем. Важно: невозможно установить маркетинговый канал по умолчанию для сервера. Канал, созданный изначально как Транзакционный, всегда будет основным. Чтобы отправлять через другие каналы, необходимо явно указывать, какой канал использовать, одним из способов ниже. Создание канала отправки - Выберите сервер, к которому хотите добавить новый канал. - Нажмите Создать канал отправки. - Укажите имя потока и его тип (Транзакционный или Маркетинговый). - Нажмите Создать, чтобы добавить канал на сервер. Рассылка через канал отправки Чтобы отправлять письма через нужный канал, Haskimail использует ID канала— уникальный идентификатор канала. Он отображается в правом верхнем углу при просмотре канала. Если вы не указываете ID канала при отправке, письмо будет отправлено через основной Транзакционный канал сервера. API При отправке писем через API Haskimail используйте параметр «MessageStream» с нужным ID канала. Пример JSON для пакетной отправки: [ { "From": "sender@example.com", "To": "recipient@customer.com", "Subject": "Обновление условий использования", "Tag": "tosupdate", "HtmlBody": "<strong>Здравствуйте</strong>, наши условия изменились...", "TextBody": "Здравствуйте, наши условия изменились...", "MessageStream": "broadcasts" }, { "From": "sender@example.com", "To": "another-recipient@customer.com", "Subject": "Обновление условий использования", "Tag": "tosupdate", "HtmlBody": "<strong>Здравствуйте</strong>, наши условия изменились...", "TextBody": "Здравствуйте, наши условия изменились...", "MessageStream": "broadcasts" } ] Пример запроса cURL: curl "https://api.haskimail.com/email/batch" \ -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "X-HaskiMail-Server-Token: ваш_токен_сервера" \ -d '[...]' Отправка шаблонов с использованием Batch: { "From": "sender@example.com", "To": "recipient@customer.com", "TemplateAlias": "tosupdate", "TemplateModel": { "customer_name": "Иван" }, "MessageStream": "broadcasts" } Запрос с шаблонами через cURL: curl "https://api.haskimail.com/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@customer.com", "TemplateAlias": "tosupdate", "TemplateModel": { "customer_name": "Иван" }, "MessageStream": "broadcasts" }, { "From": "sender@example.com", "To": "another-recipient@customer.com", "TemplateAlias": "tosupdate", "TemplateModel": { "customer_name": "Анна" }, "MessageStream": "broadcasts" } ] }' SMTP Вариант 1: Заголовок X-HM-Message-Stream Если ваш SMTP-клиент позволяет добавлять кастомные заголовки, используйте: - Сервер: smtp-broadcasts.haskimail.com - Порты: 25, 2525, или 465 - Аутентификация: plain text, CRAM-MD5, или TLS - Заголовок: X-PM-Message-Stream: broadcasts Важно: Рассылочные SMTP-потоки используют другой URL, чем транзакционные. Вариант 2: Аутентификация через реквизиты SMTP Можно использовать реквизиты SMTP, чтобы аутентифицировать отправку через конкретный канал. Для этого: - Перейдите в настройки нужного канала отправки. - Скопируйте указанные реквизиты: Архивация канала отправки В настройках канала вы можете выбрать Архивацию канала отправки. Архивированные каналы и их статистика автоматически удаляются через 45 дней. До удаления поток можно восстановить, выбрав опцию Посмотреть архивные каналы на странице сервера. Также доступны API-методы для архивации и восстановления потока.
Как отправлять письмаКакие SMTP реквизиты / API-ключи нужно использовать?
Если вы используете API: Используйте серверный API-ключ который можно найти в вашем аккаунте Haskimail, перейдя в раздел SMTP-серверы> API-ключи. Серверный API-ключ уникален для каждого сервера, который вы создаёте в Haskimail. Чтобы отправлять сообщения через определённый канал отправки нужно добавить параметр MessageStream, который указывает на идентификатор потока. Если идентификатор потока не указан, Haskimail будет отправлять сообщения через канал по умолчанию — Транзакционные сообщения. Если вы используете SMTP: - Сервер: smtp.haskimail.ru (для транзакционных сообщений) и smtp-broadcasts.haskimail.ru (для рассылок). - Порты: 25, 2525 или 465. - TLS: TLS доступен через расширение STARTTLS SMTP. Это создаёт зашифрованное соединение с нашим SMTP сервером, и все токены и контент передаются зашифрованными. Мы рекомендуем использовать TLS, если это возможно. Здесь есть два варианта аутентификации, в зависимости от того, что поддерживает ваш SMTP клиент. Разница только в конфигурации. 1. API-ключ через curl: Используйте Серверный API-ключ который можно найти, перейдя в сервер, затем в канал сообщений и в настройки. API-ключ также можно использовать как логин-пароль при отправке через SMTP. 2. Реквизиты SMTP. Их можно найти, перейдя в канал отправки — инструкции по отправке: Для более подробной информации по использованию SMTP, ознакомьтесь с нашими документами для разработчиков. Если вы используете Postfix для отправки через Haskimail, вы можете следовать нашим инструкциям по настройке в руководстве «Как настроить Postfix для отправки через Haskimail?»
ДоставляемостьКак прогреть домен для email-рассылки
Прогрев домена – важный процесс создания хорошей репутации, которая базируется на истории рассылок. Ваша задача – поэтапно, шаг за шагом, «приучать» адрес к тому, чтобы: - отправки писем осуществлялись на постоянной основе; - при этом поддерживался достаточный уровень целевых действий: открытия и клики с отсутствием жалоб на спам. Это и есть прогрев. Он помогает с течением времени повысить процент доставки электронных сообщений. Можно ли обойтись без прогрева? Нет, так как массовые рассылки с нового адреса способны закономерно вызвать массу подозрений у провайдеров, ведь у них пока еще нет статистических данных относительно жалоб и реакции пользователей (ни положительной, ни отрицательной). Представьте себе: с нового сайта начинается отправка на огромное число адресов. Рождаются логичные вопросы: - Честно ли собрана подписная база? - Не были ли приобретены адреса подписчиков у третьих лиц, чтобы рассылать спам и наживаться на доверии людей? Иногда почтовые провайдеры заранее помечают рассылку как спам. Они делают это, чтобы не рисковать. В связи с этим прогрев необходим, чтобы письма приходили к получателю, а не затерялись в папке "Спам". Как подготовиться к прогреву: простые шаги Перед тем как начать писать и отправлять email по базе, предлагаем заняться прогревом. В самом начале имеет смысл задать несколько базовых технических настроек: 1. Пропишите значения DKIM и SPF. Как это расценивает почтовый сервис? Он понимает, что вы – настоящий владелец домена, а не эксплуатируете его данные, получив их нелегитимным путем. Сама настройка заключается во внесении записей в DNS. Обычно управление DNS происходит у регистратора доменного имени или на хостинге сайта. Применение записей может занимать от 1 до 48 часов. Подробная инструкция по настройке домена в сервисе Haskimail есть в Базе Знаний. 2. Следующий шаг – активизация FBL, если вы "поднимаете" собственный сервер отправки. Такое действие помогает получать реальные статистические сведения о жалобах на рассылки. Алгоритмы могут быть разными, но чаще всего активация проводится в панели контроля рассылок. Если вы пользуетесь Haskimail, то всё уже настроено. В статистике отправки вы будете видеть статистику жалоб на спам, все они будут автоматически обрабатываться и исключаться из базы. 3. Если вы “поднимаете” свой собственный сервер отправки, то сделайте также запись, связывающую адрес с доменом сайта. Это так называемая PTR-запись. Формирование графика для прогрева Не пугайтесь. График – рабочий инструмент, который зависит от нескольких факторов: - Чистота списков. - Репутация IP отправителя письма, сайта. - Показатели активности подписной базы и прочее. Если вы выбрали сложный честный путь, то ваши списки чистые, в них реальные адреса заинтересованных людей, мало жалоб на отправку спама, все хорошо, и можно действовать открыто и смело. Стартуйте с малого – это небольшие объемы писем по сегментам. Сначала охватывайте самых активных, поэтапно увеличивая число получателей, добавляя другие сегменты с меньшей активностью. Конечно, важно отслеживать результаты. Не торопитесь и начинайте с малых объемов, чтобы иметь возможность замедлять отправку и корректировать выбранную стратегию, если что-то пойдет не так (например, активность будет низкой, письма станут попадать в спам). График прогрева может выглядеть следующим образом: В процессе прогрева вам нужно контролировать и отслеживать активность аудитории: 1. Если показатели низкие, сбрасывайте темп и не торопитесь увеличивать количество людей. 2. Постоянно проверяйтк статистику рассылок, чтобы взращивать активность. Помните, что уровень отказов не должен превышать 10%. Жалобы сводим к минимуму. Их число обязано стремиться к нулю, если вы все делаете верно (не более 1%). 3. Контролируйте, не включил ли почтовый сервер вас в черные списки.
Открытия и кликиОтслеживание ссылок. Принцип работы
Отслеживание ссылок позволяет получить информацию о том, какие действия предпринимают пользователи в письмах, которые вы им отправляете. Эта статья даст дополнительные сведения о том, как мы отслеживаем клики. Как только ваш аккаунт в Haskimail будет одобрен для отправки, отслеживание ссылок можно будет включить на уровне канала отправки или письма. Обзор Отслеживание ссылок работает путем маршрутизации ссылок, размещенных в отслеживаемых письмах, через наши серверы отслеживания на click.haskimail.ru. Когда отслеживание ссылок включено для письма, которое вы отправляете, мы сканируем HTML и/или текстовое содержание письма (в зависимости от настроек отслеживания ссылок) на наличие ссылок и заменяем их на версии с перенаправлением через домен haskimail.ru. Затем мы записываем следующие данные перед тем, как перенаправить получателя на исходный URL: - IP - User-Agent - ID ссылки - Временная метка Просмотр деталей отслеживания ссылок Успешно отслеживаемые ссылки будут отображаться в логе активности канала отправки и выглядеть так: Если открыть письмо для более подробной информации, можно увидеть данные о клике: Форматирование ссылок Не следует использовать сам URL-адрес (например, «http://example.com») в качестве текста, который будет отображаться в письме. Это может быть воспринято как подозрительная активность (например, фишинг) почтовыми сервисами и провайдерами, такими как Gmail, Yahoo и другие. Неправильно: <a href="http://example.com">http://example.com</a> Правильно: <a href="http://example.com">Посетите наш сайт</a>
Как отправлять письмаКак подтвердить домен
Подтверждение DKIM 1. Перейдите на страницу Домены и отправители: 2. Найдите нужный домен и нажмите DNS Настройки или Добавьте DKIM DNS запись. 3. Вы увидите DKIM-запись, которую нужно добавить в DNS как TXT-запись: 4. Зайдите в панель управления у вашего хостинг-провайдера или DNS-сервиса. 5. Добавьте новую TXT-запись, используя имя домена (например, dm._domainkey…) и значение, указанное на странице настроек DNS. 6. После добавления записи DKIM будет считаться подтверждённым в Haskimail в течение 48 часов. Если подтверждение не произошло автоматически, можно вручную нажать кнопку Проверка. 7. После успешного подтверждения все письма, отправленные через Haskimail с этого домена, будут подписываться с использованием DKIM. Подтверждена — теперь весь домен подтверждён по DKIM. Следующий шаг — настройка SPF-записи! Подтверждение SPF-записи SPF-запись — это специальная запись в DNS, которая показывает, какие почтовые серверы имеют право отправлять письма от имени вашего домена. 1. На той же странице настроек DNS, где вы настраивали DKIM, находятся значения для настройки SPF: 2. У вашего DNS-провайдера добавьте новую txt-запись со следующими значениями: Имя хоста: например, dashamail.ru Значение: будет указано справа (начинается с v=spf1) 3. После добавления записи SPF будет отображаться как подтверждённый в Haskimail в течение 48 часов. Если этого не произошло — нажмите кнопку Проверка вручную. 4. После подтверждения SPF-записи все письма, отправленные Haskimail от имени этого домена, будут проходить SPF-согласование. Нужны инструкции для конкретного хостинга? Вот список популярных DNS-провайдеров, с которыми можно использовать Haskimail
Приступить к работеНачало работы с Haskimail
Начать работать с Haskimail просто. Вы можете подключиться через SMTP или использовать наш API и клиентские библиотеки — выбор зависит от того, что вам удобнее. Haskimail разделяет разные каналы отправки - транзакционные письма (технические письма, уведомления о сбросе пароля или квитанции) отправляются отдельно от массовых рассылок (новостных рассылок, анонсов и других подобных сообщений). Каналы работают на разных IP-адресах. Такое разделение помогает поддерживать высокую репутацию наших IP-адресов и гарантирует, что все ваши письма будут доставляться быстро и надежно. Шаг 1. Регистрация Создание аккаунта занимает минимум времени, а бесплатный тарифный план включает 100 тестовых писем в месяц. Просто зарегистрируйтесь по ссылке. В личном кабинете уже будет создан ваш первый сервер для отправки писем. Серверы помогают организовать работу с почтой по проектам, клиентам или рабочим областям. При необходимости вы всегда можете добавить новые серверы. Шаг 2: Добавление подписей отправителя и подтвержденных доменов Для отправки писем через Haskimail необходимо настроить обратный адрес, который вы хотите использовать в поле «От кого» ваших сообщений. Если вы отправляете рассылки с email-адресов на своем домене, вы можете настроить и подтвердить его в личном кабинете. Подробнее о проверке домена отправки рассказали в статье "Как подтвердить домен" нашего блога. Мы используем подтверждение обратного адреса и проверку домена, чтобы убедиться, что вы являетесь владельцем почтовых ящиков, с которых планируете отправлять письма. Эти меры безопасности помогают поддерживать нашу безупречную репутации у почтовых провайдеров и обеспечивать надежную и быструю доставку ваших писем во "Входящие". Если вам нужно добавить домен или обратный адрес, вы можете сделать это в разделе «Домены и отправители»: После подтверждения обратного адреса вам нужно перейти к настройке верификации домена. Обратите внимание: если вы подтвердите домен, вам не нужно будет добавлять дополнительные обратные адреса для этого домена, поскольку весь домен будет авторизован для отправки. Шаг 3: Настройка DKIM и SPF Для верификации домена добавление DKIM-записи в DNS является обязательным требованием. Для каждого домена система генерирует SPF и DKIM-запись, которые необходимо добавить в DNS. Настройка DKIM: 1. Перейдите по ссылке "Добавить DKIM DNS запись" 2. На открывшейся странице вы найдете все необходимые данные для настройки. 3. Добавьте указанные DKIM и SPF в DNS вашего домена. 4. После добавления нажмите кнопку «Проверка» для подтверждения. Не нужно быть техническим специалистом для выполнения этих действий, но если вы хотите глубже разобраться в теме, у нас есть подробное руководство. Для инструкций по вашему хостингу обратитесь к нашей Базе знаний. Шаг 4: Модерация Мы вручную проверяем каждую новую учётную запись, чтобы обеспечить самую быструю доставку и высочайшую репутацию в отрасли. Заполнив эту форму, вы поможете нам лучше вас узнать. Шаг 5: Внесение изменений в код После завершения всех настроек и успешного прохождения модерации можно приступать к интеграции с вашей системой. Мы предлагаем несколько вариантов: - Использование SMTP Если вы уже работаете через SMTP, просто измените настройки, указав серверы Haskimail. Миграция займет минимум времени. - Использование API или клиентских библиотек Вы можете начать работу с API через нашу документацию или использовать готовые клиентские библиотеки для PHP. Шаг 6: Мы всегда готовы помочь Если у вас возникнут вопросы или сложности, наша команда поддержки всегда на связи. Мы понимаем, что некоторые аспекты могут вызывать затруднения, и будем рады помочь вам с переходом на Haskimail.