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