### Интеграция с системой позволяет отправлять письма из [**Ecvi.ru**](http://Ecvi.ru) через наш сервис **Haskimail**, что положительно сказывается на их доставляемости в папку "Входящие".

# Чтобы начать отправку:

* Вам потребуется зарегистрироваться на нашем сайте [haskimail.ru](https://haskimail.ru/) и настроить аккаунт согласно [инструкции](https://help.haskimail.ru/hc/haskimail/articles/1768991329-nachalo-raboty-s-haskimail).

* В личном кабинете нашего сервиса необходимо нажать на конкретный сервер, созданный по умолчанию, далее перейти в конкретный канал и в разделе "Настройки" получить API-ключ, который будет использован в настройках подключения:

  ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa0lhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f6962e7e6211665619a826ea6c42ae1193402220/image.png)

* Полученный API-ключ необходимо добавить в Ecvi в разделе *Администрирование - Разное - Стыковки* *-* *Email-рассылки:*

  ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2dhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--51e3e62651999833f9e1bcfb13370438c4a422f7/image.png)

  # Создание и управление рассылками

  Управление почтовыми рассылками производится в подразделе ***Рассылки*** раздела ***Клиенты***.

  Описанные ниже функции недоступны отелям, пользующимся системой на тарифе *Light*. Перейдите на тариф *Optimum* или выше, если вы хотите использовать *Рассылки*.

  ![image.png](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3NhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--40e6212b020efd7d1bb07ede3742ed1f5e261b2f/7SPimage.png)

  ## Список рассылок

  Управление рассылками осуществляется через таблицу. Для создания новой записи нажмите кнопку в правом верхнем углу экрана. Редактирование или удаление доступно по иконкам справа в строке нужной рассылки.

  В таблице отображаются два основных поля: наименование рассылки и статус «Активна». Статус определяет, будет ли рассылка использоваться для отправки (активна) или будет просто храниться в системе (неактивна).

  ## Настройка параметров

  При создании или редактировании открывается окно «Настройка e-mail рассылки», которое позволяет задать все необходимые параметры

  ![image.png](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa29hIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--94cf2f5a3add290d7eed57494f5d8ac8cf1e0003/jRJimage.png)

  На первой закладке ***Настройка рассылки*** находятся следующие поля:

  * *Имя рассылки* - используется только внутри системы, гости его не увидят.

  * *Тема рассылки* - это то, что будет вписано в тему письма, которое получит гость.

  * *Активность* - письма рассылаются только для активных рассылок.

  * *Периодичность* - определяет, как часто система будет запускать рассылку и отправлять письма. Возможные значения: однократно, день (т.е. каждый день), неделя (каждую неделю), месяц, год.

  * *Дата начала рассылки* - дата и время, когда система первый раз запустит рассылку. Будет ли рассылка повторятся и если да - как часто, определяется предыдущей настройкой (периодичность).

  ![image.png](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3dhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--af28800ed1c41acf90ce8db496cd0ddbe1fc1823/CfBimage.png)

  Вторая закладка - ***Правила*** - очень важна, именно она определяет, кому и когда будут отправляться письма. Первое, что необходимо указать - какие условия по датам мы хотим выбрать. Возможны три варианта, при выборе которых будет меняться набор последующих полей, для задания условий.

  * ***Динамическая дата***. Подразумевает создание условия типа <*сколько-то*> дней *ДО* или *ПОСЛЕ* *даты заезда* или *даты выезда* или *даты брони* (даты создания бронирования в системе) или *даты оплаты* (даты первого платежа на счете) или *дня рождения* гостя. Совместно с этим типом правила лучше создавать рассылки с периодичностью «день», т.е. такие, которые запускаются в системе ежедневно. Чтобы никого из гостей не пропустить ведь условие, что до заезда осталось, к примеру, 3 дня, сработает для брони только в определенную дату.

  * ***Интервал дат***. В этом случае мы сможем задать условие типа *дата заезда* или *дата выезда* или *дата брони* (даты создания бронирования в системе) или *дата оплаты* (даты первого платежа на счете) или *день рождения* гостя в интервале c <дата и время> по <дата и время>. Здесь можно использовать и рассылки с периодичностью *однократно* или *год*, поскольку, к примеру, поздравлять всех январских именинников мы будем только 1 раз в году (если так решили). Причем в отношении дней рождения надо учесть, что интервал дат подразумевает не дату, когда гость родился, а даты в этом году, когда гость празднует свой день рождения. Если задать периодичность «год», то в следующем году рассылка отработает точно так же. Система в этом случае не смотрит на год, а только на сами даты (дни месяцев). Конечно, помимо дней рождения мы можем использовать этот вариант правила, например, для рассылки спецпредложений всем гостям, которые заезжали к нам прошлым летом и т.п. (здесь год в дате уже будет играть роль).

  * ***Без условия по дате***. Этот вариант означает, что даты рассылка вообще не должна учитывать. Скажем, мы просто хотим разослать письма всем VIP-гостям или гражданам определенной страны.

  * ***Пол***. Здесь, пожалуй, всё должно быть понятно. Если требуется поздравить с 8 марта, выберем пол «женский».

  * ***Страны***. Помимо *Для всех стран* можно выбрать *Для страны* или *Не для страны*. Т.е. можем, например, рассылать письма на русском только для гостей из страны Россия и на английском (в другой рассылке) - для всех стран, которые не Россия.

  * ***Сегмент***. Если выбрать, то рассылка отработает только по гостям из бронирований, которым в карточке был установлен указанный сегмент (например, «Командировочные»).

  * ***VIP***. Если установлен - рассылка только для VIP гостей. Иначе - для всех.

  ![image.png](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2thIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--807ecaff5e64699e73a53f9fbd52c884c3195eda/VfMimage.png)

  Во вкладке ***Шаблон*** создается само тело письма. Здесь, во-первых, имеется специальная панель кнопок, с помощью которых можно оформить письмо не как простой текст, а как красивую страницу (для этого, возможно, придется освоиться с некоторыми базовыми понятиями HTML, но и без них кое-что можно собрать простое письмо. Во-вторых, в текст письма можно вставлять специальные «переменные», которые в итоговом письме автоматически превратятся в ФИО гостя, его номер комнаты, даты заезда и пр. Эти переменные перечислены на закладке ***Переменные***:

  ![image.png](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazBhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9ccb6d4530e8263b0f811018571bcb56d99e791d/wslimage.png)

  Помните, что в шаблон письма эти переменные надо вставлять точно в таком виде, как они приведены в списке, т.е. в двойных фигурных скобках. Проще всего их просто копировать со вкладке *Переменные* и вставлять в текст, не изменяя.

  ***Отписка от рассылки*** для гостей. Об этом важно помнить, чтобы наша рассылка не расценивалась как спам. Вам не требуется что-то специально добавлять в текст письма: в конце каждого система автоматически добавит стандартное предложение о возможности отписаться, перейдя по ссылке. Щелкнув на которой, гость увидит страницу, что его адрес удален из рассылки. При этом в карточке гостя в разделе *Клиенты - Гости* будет установлен флажок ***Без рассылок***. При необходимости вы можете как выставить этот флажок вручную, так и снять его.