Haskimail: шлюз для рассылок
Haskimail — сервис отправки писем. Подключите к VirtualPos свою учётную запись Haskimail, и через неё будут уходить письма рассылок клиентам и триггеров.
Общее описание
- Учётная запись Зарегистрируйтесь в Haskimail и войдите в личный кабинет.
- Отправитель Подтвердите адрес или домен, от имени которого будут уходить письма.
- Ключ Скопируйте API-ключ сервера.
- Шлюз Добавьте в VirtualPos шлюз типа «Haskimail.ru».
- Проверка Отправьте тестовое письмо из карточки шлюза.
- Модерация Пройдите модерацию в Haskimail, чтобы писать любым получателям.
Шлюз работает только с каналом Email. Что такое шлюз, как выбрать его при запуске рассылки и как сделать шлюзом по умолчанию — в статье Рассылки клиентам.
Подготовка в Haskimail
Личный кабинет Haskimail открывается по адресу lk.haskimail.ru.
Адрес отправителя
Внимание. Адрес отправителя должен быть подтверждён в разделе «Домены и отправители» личного кабинета Haskimail. Письма с неподтверждённого адреса Haskimail не принимает — рассылка завершится с ошибками.
- В личном кабинете Haskimail откройте Домены и отправители и нажмите «Добавить домен или обратный адрес».
- Выберите способ подтверждения.
- Выполните подтверждение: внесите DNS-записи домена или перейдите по ссылке из письма.
- Способ Добавить домен Подтверждается домен: в его DNS-зону добавляются записи DKIM и SPF, которые покажет Haskimail. После этого отправителем может быть любой адрес на этом домене.
- Способ Подтвердить обратный адрес Подтверждается один адрес: Haskimail присылает на него письмо со ссылкой. DNS-записи не нужны.
Подтверждённые домены и адреса видны в списке раздела. У домена показано состояние записей DKIM и SPF; ссылка «DNS настройки» открывает записи, которые нужно внести в DNS.
Адрес, который вы подтвердили, укажите в VirtualPos в поле «Адрес отправителя» — буква в букву.
API-ключ сервера
Письма в Haskimail отправляются через SMTP-сервер — так сервис называет отдельную среду для писем одного сайта или проекта. Первый сервер создаётся при регистрации.
- В личном кабинете Haskimail откройте SMTP-серверы и нажмите на название сервера.
- Перейдите на вкладку API-ключи.
- Скопируйте значение поля «Серверный API-ключ».
Нужен именно серверный API-ключ. API-ключ аккаунта, который предлагается на той же странице для управления серверами, для отправки писем не подходит.
Тестовый режим и модерация
Новая учётная запись Haskimail работает в тестовом режиме — в шапке личного кабинета написано «Тестовый режим». По сведениям Haskimail, до одобрения учётной записи письма можно отправлять только на адреса доменов, которые вы добавили и подтвердили в личном кабинете; отправка на остальные адреса недоступна.
Чтобы отправлять письма клиентам, пройдите модерацию: нажмите «Пройти модерацию» в шапке личного кабинета и заполните заявку. Подать её может только владелец учётной записи. Проверка обычно занимает менее 24 часов в рабочие дни.
Настройка шлюза в VirtualPos
- В VirtualPos откройте CRM и лояльность → Клиенты → Рассылки → Настроить шлюзы для рассылки.
- Нажмите «Добавить шлюз» и введите название — по нему вы будете выбирать шлюз в окне рассылки.
- В поле «Тип шлюза» выберите «Haskimail.ru».
- Заполните параметры и нажмите «Сохранить».
| Токен сервера | Серверный API-ключ из личного кабинета Haskimail. Обязательное поле. Сохранённый токен не показывается; чтобы оставить его прежним, не меняйте поле |
| Адрес отправителя | Адрес, от имени которого уходят письма. Должен быть подтверждён в Haskimail. Обязательное поле |
| Имя отправителя | Имя, которое получатель видит рядом с адресом, — например, название магазина |
| Адрес для ответа | Адрес, на который придёт ответ клиента. Если не заполнен, ответ придёт на адрес отправителя |
Совет. Если в поле «Токен сервера» ввести HASKIMAIL_API_TEST, Haskimail проверит запрос, но письмо не отправит. Так можно убедиться, что шлюз настроен, не расходуя письма. Перед рабочими рассылками замените его на серверный API-ключ.
Проверка шлюза
- В списке шлюзов нажмите на строку шлюза — откроется его карточка.
- В блоке «Проверка шлюза» введите адрес и нажмите «Проверить».
- Дождитесь ответа: «Тестовое сообщение отправлено на …». Письмо придёт с темой «Проверка шлюза VirtualPos».
Совет. Пока учётная запись Haskimail в тестовом режиме, укажите получателем тестового письма адрес на домене, подтверждённом в Haskimail: на другие адреса письмо не уйдёт.
Частые ошибки
| Сообщение или ситуация | Причина | Что делать |
|---|---|---|
| Заполнены не все параметры шлюза | Не заполнен токен сервера или адрес отправителя | Нажмите «Изменить» и заполните поля, отмеченные звёздочкой |
| Haskimail, HTTP …: […] … | Haskimail отклонил письмо. В скобках — код ошибки, после него — причина от Haskimail | Проверьте токен сервера, адрес отправителя и его подтверждение в Haskimail |
| Ошибка связи с Haskimail: … | Нет связи с Haskimail | Повторите проверку позже |
| Проверка проходит, а письма клиентам не уходят | Учётная запись Haskimail в тестовом режиме | Пройдите модерацию в личном кабинете Haskimail |
| Проверка проходит, но письмо не приходит | В поле «Токен сервера» указан HASKIMAIL_API_TEST | Замените его на серверный API-ключ |
| Письма отклоняются с ошибкой об отправителе | Адрес отправителя или его домен не подтверждены в Haskimail | Подтвердите адрес или домен в разделе «Домены и отправители» |