# Создание каталога для рассылки почты

## 1. **Введение**

Каталог для рассылки почты — способ отправки сформированных сообщений на почтовые ящики получателей. Отправка сообщения производится с использованием специального каталога, в записях которого фиксируются адреса получателей, тема и текст сообщения. Текст сообщения может быть задан как обычный текст, так и произвольная HTML-разметка. Каталог позволяет удобно отправлять сообщения путем создания новых записей и следить за историей всех отправленных сообщений.

## **2. Принцип работы**

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LACZmmM2xUWbZxyRr4s%2Fuploads%2FmN2SNcbiYrUbR2fKJqZl%2F5%D0%A1%D1%85%D0%B5%D0%BC%D0%B0_%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D1%8B.jpg?alt=media\&token=6ed11d9b-63b8-4883-898f-56483ae7b1b0)

При создании записи в каталоге «Уведомления» срабатывает сценарий по отправке сообщения по данным из полей созданной записи. После выполнения в записи появляется информация о статусе отправки и сообщение отправляется адресату.

## **3. Реализация**

### **3.1. Настройка структуры каталога «Уведомления»**

Создайте каталог «Уведомления», данный каталог будет содержать информацию о всех осуществленных рассылках. Создание записи в каталоге инициирует рассылку сообщения на почтовые адреса, указанные в записи каталога. Настройка полей представлена на скриншоте ниже, создавать поля необходимо в том же порядке:

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LACZmmM2xUWbZxyRr4s%2Fuploads%2FPbb6wLmJ2TzsxVX8eiM5%2F1%D0%A1%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0_%D0%9A%D0%B0%D1%82%D0%B0%D0%BB%D0%BE%D0%B3%D0%B0.png?alt=media\&token=85e08596-9762-4876-a8bd-77c7997568ef)

* **Создано** (Дата)\
  Описание: содержит информацию дате начала рассылки.\
  Настройки: по умолчанию текущая дата и время.
* **Статус** (Статус)\
  Описание: информация о результате рассылки.
* **Получатели** (Контакт)\
  Описание: Почтовые адреса получателей.
* **Отправитель** (Контакт)\
  Описание: Почтовый адрес отправителя.
* **Тема** (Текст)\
  Описание: Тема письма.
* **Тип текста** (Статус)\
  Описание: Выбор типа данных в поле «Текст». Значения поля: «TEXT», «HTML».
* **Текст** (Текст)\
  Описание: Сообщение отправляемое по почте.
* **Вложения** (Файл)\
  Описание: Прикрепляемые к сообщению документы.

### **3.2. Настройка автоматизации**

#### **3.2.1. Создание записи сценария**

Создайте новую запись в системном каталоге «Сценарии». Заполните обязательные поля карточки произвольным образом и прикрепите в поле «Сценарий» [следующий файл](https://drive.google.com/file/d/1UWCBzrNEju3rt6PO-0IqBL6Pn_KzYKEq/view?usp=sharing), нажав на кнопку «Загрузить…»:

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LACZmmM2xUWbZxyRr4s%2Fuploads%2FWhJGh94UBpOE65SD5KOW%2F%D0%97%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%B8%D1%82%D1%8C%20%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B9.png?alt=media\&token=c4db574f-f412-4d43-8b3d-56a1cdc7bdfd)

#### **3.2.2. Создание записи события**

Перейдите в системный в каталог «События» (обычно он находится в отделе Управление) и создайте новую запись. Заполните запись следующим образом:

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LACZmmM2xUWbZxyRr4s%2Fuploads%2FtW9RIKc5CCwRwB1ckLMk%2F2%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F.png?alt=media\&token=9177f719-db19-43af-ba1b-4952e8f123bb)

В поле «Выполнить» в качестве сценария выберите созданный на предыдущем шаге сценарий.

**3.2.3. Настройка файла сценария**

Сценарий для отправки сообщения выглядит следующим образом:

<figure><img src="https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LACZmmM2xUWbZxyRr4s%2Fuploads%2FrfUGiJYpuNzAhW9bnrnu%2Fscenariy.png?alt=media&#x26;token=dd7ffd8c-b658-4ec5-bf3d-f1dc4a2bdd2c" alt=""><figcaption></figcaption></figure>

В загруженном сценарии отредактируйте следующие компоненты, согласно комментариям внутри них:

**Компоненты «Отправка почты».**

* Адрес сервера и Порт: укажите действующий логин и пароль почтового ящика в кавычках.

**Компоненты** **«Фиксируем удачную отправку» и «Фиксируем ошибку отправки».**

* Каталог: укажите ID каталога «Уведомления», либо из выпадающего списка выберите каталог «Уведомления».

## **4. Тестирование**

### **4.1. Каталог «Уведомления»**

Создайте запись в каталоге «Уведомления». В поле «Отправитель» введите почту, аналогичную почте в компоненте разработанного сценария. В поле «Получатели» введите почты всех получателей. Выберите тип письма, введите его тему, текст и при необходимости приложите вложения. Пример заполнения представлен ниже:

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LACZmmM2xUWbZxyRr4s%2Fuploads%2FIH9KwGwjsPatI1yLvEDc%2F7%D0%A4%D0%BE%D1%80%D0%BC%D0%B0.png?alt=media\&token=8006d228-651f-4ccf-802a-bb90c7083fb7)

После заполнения всех необходимых полей сохраните запись.

### 4.2. Результат

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

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LACZmmM2xUWbZxyRr4s%2Fuploads%2FF5WUl9eLYgz9tkK84BdQ%2F8%D0%A0%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82.png?alt=media\&token=aa8c1d68-fff2-4a93-9586-5236bcf565e4)