# Haskimail: шлюз для рассылок

> Источник: https://wiki.virtualpos.ru/hc/integration/haskimail  
> Обновлено: 2026-10-10  
> Где в программе: CRM и лояльность → Клиенты → Рассылки → Настроить шлюзы для рассылки

Haskimail — сервис отправки писем. Подключите к VirtualPos свою учётную запись Haskimail, и через неё будут уходить письма [рассылок клиентам](https://wiki.virtualpos.ru/hc/crm/mailing) и [триггеров](https://wiki.virtualpos.ru/hc/crm/triggers).

## Общее описание

1. **Учётная запись** — Зарегистрируйтесь в Haskimail и войдите в личный кабинет.
1. **Отправитель** — Подтвердите адрес или домен, от имени которого будут уходить письма.
1. **Ключ** — Скопируйте API-ключ сервера.
1. **Шлюз** — Добавьте в VirtualPos шлюз типа «Haskimail.ru».
1. **Проверка** — Отправьте тестовое письмо из карточки шлюза.
1. **Модерация** — Пройдите модерацию в Haskimail, чтобы писать любым получателям.

> **Примечание:**
> Шлюз работает только с каналом Email. Что такое шлюз, как выбрать его при запуске рассылки и как сделать шлюзом по умолчанию — в статье [Рассылки клиентам](https://wiki.virtualpos.ru/hc/crm/mailing#настройки_шлюза).

## Подготовка в Haskimail

Личный кабинет [Haskimail](https://haskimail.ru/?ref=400705) открывается по адресу [lk.haskimail.ru](https://lk.haskimail.ru/?ref=400705/).

### Адрес отправителя

> **Важно:**
> **Внимание.** Адрес отправителя должен быть подтверждён в разделе **«Домены и отправители»** личного кабинета Haskimail. Письма с неподтверждённого адреса Haskimail не принимает — рассылка завершится с ошибками.

1. В личном кабинете Haskimail откройте **Домены и отправители** и нажмите **«Добавить домен или обратный адрес»**.
1. Выберите способ подтверждения.

![Выбор способа подтверждения в Haskimail](https://wiki.virtualpos.ru/_media/hc/integration/haskimail/hm-sender-add.png)

1. Выполните подтверждение: внесите DNS-записи домена или перейдите по ссылке из письма.

- *Способ* **Добавить домен** — Подтверждается домен: в его DNS-зону добавляются записи DKIM и SPF, которые покажет Haskimail. После этого отправителем может быть любой адрес на этом домене.
- *Способ* **Подтвердить обратный адрес** — Подтверждается один адрес: Haskimail присылает на него письмо со ссылкой. DNS-записи не нужны.

Подтверждённые домены и адреса видны в списке раздела. У домена показано состояние записей DKIM и SPF; ссылка **«DNS настройки»** открывает записи, которые нужно внести в DNS.

![Домен и обратный адрес в разделе «Домены и отправители»](https://wiki.virtualpos.ru/_media/hc/integration/haskimail/hm-domains.png)

Адрес, который вы подтвердили, укажите в VirtualPos в поле **«Адрес отправителя»** — буква в букву.

### API-ключ сервера

Письма в Haskimail отправляются через **SMTP-сервер** — так сервис называет отдельную среду для писем одного сайта или проекта. Первый сервер создаётся при регистрации.

1. В личном кабинете Haskimail откройте **SMTP-серверы** и нажмите на название сервера.

![Список SMTP-серверов в Haskimail](https://wiki.virtualpos.ru/_media/hc/integration/haskimail/hm-servers.png)

1. Перейдите на вкладку **API-ключи**.
1. Скопируйте значение поля **«Серверный API-ключ»**.

![Серверный API-ключ](https://wiki.virtualpos.ru/_media/hc/integration/haskimail/hm-api-key.png)

> **Примечание:**
> Нужен именно серверный API-ключ. API-ключ аккаунта, который предлагается на той же странице для управления серверами, для отправки писем не подходит.

### Тестовый режим и модерация

Новая учётная запись Haskimail работает в тестовом режиме — в шапке личного кабинета написано **«Тестовый режим»**. По сведениям Haskimail, до одобрения учётной записи письма можно отправлять только на адреса доменов, которые вы добавили и подтвердили в личном кабинете; отправка на остальные адреса недоступна.

Чтобы отправлять письма клиентам, пройдите модерацию: нажмите **«Пройти модерацию»** в шапке личного кабинета и заполните заявку. Подать её может только владелец учётной записи. Проверка обычно занимает менее 24 часов в рабочие дни.

## Настройка шлюза в VirtualPos

1. В VirtualPos откройте **CRM и лояльность → Клиенты → Рассылки → Настроить шлюзы для рассылки**.
1. Нажмите **«Добавить шлюз»** и введите название — по нему вы будете выбирать шлюз в окне рассылки.
1. В поле **«Тип шлюза»** выберите **«Haskimail.ru»**.
1. Заполните параметры и нажмите **«Сохранить»**.

![Шлюз типа «Haskimail.ru»](https://wiki.virtualpos.ru/_media/hc/integration/haskimail/gateway-form.png)

- **Токен сервера** — Серверный API-ключ из личного кабинета Haskimail. Обязательное поле. Сохранённый токен не показывается; чтобы оставить его прежним, не меняйте поле
- **Адрес отправителя** — Адрес, от имени которого уходят письма. Должен быть подтверждён в Haskimail. Обязательное поле
- **Имя отправителя** — Имя, которое получатель видит рядом с адресом, — например, название магазина
- **Адрес для ответа** — Адрес, на который придёт ответ клиента. Если не заполнен, ответ придёт на адрес отправителя

> **Совет:**
> **Совет.** Если в поле «Токен сервера» ввести `HASKIMAIL_API_TEST`, Haskimail проверит запрос, но письмо не отправит. Так можно убедиться, что шлюз настроен, не расходуя письма. Перед рабочими рассылками замените его на серверный API-ключ.

## Проверка шлюза

1. В списке шлюзов нажмите на строку шлюза — откроется его карточка.
1. В блоке **«Проверка шлюза»** введите адрес и нажмите **«Проверить»**.
1. Дождитесь ответа: «Тестовое сообщение отправлено на …». Письмо придёт с темой «Проверка шлюза VirtualPos».

![Карточка шлюза Haskimail и проверка](https://wiki.virtualpos.ru/_media/hc/integration/haskimail/gateway-view.png)

> **Совет:**
> **Совет.** Пока учётная запись Haskimail в тестовом режиме, укажите получателем тестового письма адрес на домене, подтверждённом в Haskimail: на другие адреса письмо не уйдёт.

> **Права доступа:**
> Для настройки и проверки шлюзов нужно право `console.messagegateway.*`.

## Частые ошибки

| Сообщение или ситуация | Причина | Что делать |
| --- | --- | --- |
| Заполнены не все параметры шлюза | Не заполнен токен сервера или адрес отправителя | Нажмите «Изменить» и заполните поля, отмеченные звёздочкой |
| Haskimail, HTTP …: […] … | Haskimail отклонил письмо. В скобках — код ошибки, после него — причина от Haskimail | Проверьте токен сервера, адрес отправителя и его подтверждение в Haskimail |
| Ошибка связи с Haskimail: … | Нет связи с Haskimail | Повторите проверку позже |
| Проверка проходит, а письма клиентам не уходят | Учётная запись Haskimail в тестовом режиме | Пройдите модерацию в личном кабинете Haskimail |
| Проверка проходит, но письмо не приходит | В поле «Токен сервера» указан `HASKIMAIL_API_TEST` | Замените его на серверный API-ключ |
| Письма отклоняются с ошибкой об отправителе | Адрес отправителя или его домен не подтверждены в Haskimail | Подтвердите адрес или домен в разделе «Домены и отправители» |

## Связанные разделы

- [Рассылки клиентам](https://wiki.virtualpos.ru/hc/crm/mailing) — Запуск рассылок, выбор шлюза и журнал рассылок
- [Триггеры](https://wiki.virtualpos.ru/hc/crm/triggers) — Сообщения, которые уходят сами — после покупки, регистрации, в день рождения
- [NotiSend: шлюз для рассылок](https://wiki.virtualpos.ru/hc/integration/notisend) — Письма и sms через NotiSend
- [DashaMail: шлюз для рассылок](https://wiki.virtualpos.ru/hc/integration/dashamail) — Письма через DashaMail
