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

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

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

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

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

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

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

Личный кабинет DashaMail открывается по адресу [lk.dashamail.ru](https://lk.dashamail.ru/).

### Домен отправителя

> **Важно:**
> **Внимание.** Домен адреса отправителя должен быть подтверждён в личном кабинете DashaMail. По сведениям DashaMail, без настроенных записей DKIM и SPF письма не уходят — рассылка завершится с ошибками.

1. В личном кабинете DashaMail нажмите на свой адрес в правом верхнем углу и выберите **«Мои домены»**.

![Меню учётной записи DashaMail](https://wiki.virtualpos.ru/_media/hc/integration/dashamail/dm-account-menu.png)

1. На странице **«Настройка доменов отправки»** введите домен, с адресов которого будут уходить письма, и нажмите **«добавить новый»**.

![Добавление домена отправки в DashaMail](https://wiki.virtualpos.ru/_media/hc/integration/dashamail/dm-domains.png)

1. Внесите в DNS-зону домена записи DKIM и SPF, которые DashaMail покажет в таблице под формой.
1. Дождитесь, когда DashaMail подтвердит записи. Изменение DNS может занять продолжительное время; красное поле в таблице означает, что запись пока недействительна.

> **Примечание:**
> У домена может быть только одна SPF-запись. Если она у вас уже есть, замените её на запись от DashaMail, как подсказывает личный кабинет.

Отправителем в VirtualPos может быть адрес на подтверждённом домене — например, `shop@example.com` для домена `example.com`. Адреса на общедоступных почтовых сервисах для этого не подходят: подтвердить чужой домен нельзя.

### API-ключ

1. В меню учётной записи DashaMail выберите **«Интеграции»**, затем в строке разделов — **Интеграции → API-ключи**.
1. В блоке **«Выпустить новый ключ»** введите название — например, «VirtualPos», выберите срок действия и нажмите **«Выпустить ключ»**.

![Выпуск API-ключа в DashaMail](https://wiki.virtualpos.ru/_media/hc/integration/dashamail/dm-api-keys.png)

1. Сразу скопируйте значение ключа.
1. В таблице **«Ваши ключи»** поставьте у нового ключа галочку в колонке **«Транзакц. API»** — она разрешает отправку транзакционных писем.

![Ключ с включённой галочкой «Транзакц. API»](https://wiki.virtualpos.ru/_media/hc/integration/dashamail/dm-keys-table.png)

> **Важно:**
> **Внимание.** У нового ключа DashaMail отправка транзакционных писем выключена. VirtualPos отправляет письма именно так, поэтому без этой галочки письма через шлюз не уйдут.

> **Примечание:**
> Без двухфакторной авторизации DashaMail показывает значение ключа один раз — сразу после выпуска. Если ключ не сохранён, выпустите новый. Храните ключ как пароль и выпускайте для VirtualPos отдельный ключ: его можно отозвать, не затрагивая другие интеграции.

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

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

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

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

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

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

Если отправить не удалось, рядом с кнопкой появится ответ DashaMail — см. [Частые ошибки](https://wiki.virtualpos.ru/hc/integration/dashamail#частые_ошибки).

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

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

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

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

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