# Интеграция с почтовым сервером (SMTP)

# Настройка печати через почту

## Цель

Настройка функции отложенной печати через электронную почту: пользователь отправляет письмо с вложением на специальный адрес, вложение добавляется в его персональную очередь печати.

---

## Как работает

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

---

## Предусловия

- Настроена интеграция с почтовым сервером (SMTP)
- Имеется почтовый ящик для приёма писем с заданиями печати (IMAP-доступ)

---

## Шаги настройки

### Шаг 1. Настройка почтового ящика для приёма заданий

Перейдите в панель администратора ПринтМенеджера: **Настройки → Системные настройки → Настройки электронной почты** и укажите следующие параметры:

- **PRINT_MAILBOX_HOST** — адрес IMAP-сервера.
- **PRINT_MAILBOX_PORT** — порт на котором работает IMAP-сервер.
- **PRINT_MAILBOX_NAME** — адрес почты, через который задания попадают в очередь печати. Сотрудник может отправить на него файл, и он попадет в его очередь печати.  
- **PRINT_MAILBOX_PASSWORD** — пароль для аутентификации на сервере электронной почты (IMAP); не пароль от электронной почты, а пароль для почтовых приложений. Это разные пароли, для почтовых приложений генерируется у почтового провайдера отдельно. У Яндекса, например, тут: [https://id.yandex.ru/profile/apppasswords-list](https://id.yandex.ru/profile/apppasswords-list) .
- **PRINT_MAILBOX_USE_SSL** — флаг, который задает шифрование по протоколу SSL.
- **PRINT_MAILBOX_USE_TLS** — флаг, который задает шифрование по протоколу TLS.

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

### Шаг 2. Проверка

Отправьте тестовое письмо с документом с почты сотрудника на почту, указанную в **PRINT_MAILBOX_NAME**. Убедитесь, что задание появилось в очереди пользователя в Printum.

---

## Ожидаемый результат

После отправки письма с вложением документ появляется в персональной очереди пользователя и доступен для печати на устройстве.

---

## Связанные страницы

- [Настройка подключения к почтовому серверу](http://wiki.printum.io/books/4-integracii/page/nastroika-podkliuceniia-k-poctovomu-serveru)
- [Настройка гостевой печати через почту](http://wiki.printum.io/books/4-integracii/page/nastroika-gostevoi-pecati-cerez-poctu)

# Настройка гостевой печати через почту

## Цель

Активация гостевой печати через почту — возможность печати для пользователей, которых нет в списке сотрудников Printum.

---

## Как работает

Гость отправляет письмо с вложением на специальный адрес. Система автоматически создаёт гостевую учётную запись и добавляет задание в гостевую очередь. В ответном письме гость получает PIN-код. Используя PIN-код на МФУ со встроенным приложением, гость авторизуется и распечатывает документ.

---

## Предусловия

- Настроена интеграция с почтовым сервером (SMTP)
- Настроена печать через почту (параметр `PRINT_MAILBOX_NAME`)

---

## Шаги настройки

### Шаг 1. Включить гостевую печать

Перейдите в панель администратора ПринтМенеджера: **Настройки → Системные настройки → Настройки электронной почты**.

Включите параметр `GUEST_PRINT_VIA_MAIL`.

### Шаг 2. Проверка

Отправьте письмо с документом с адреса, которого нет в списке сотрудников, на адрес `PRINT_MAILBOX_NAME`. Убедитесь, что:

- В мониторинге и ПринтМенеджере создан сотрудник-гость в группе «Гости».
- На адрес отправителя пришло ответное письмо с PIN-кодом.
- Гость может авторизоваться на МФУ по PIN-коду и распечатать задание.

---

## Ожидаемый результат

Пользователь, не зарегистрированный в системе, получает PIN-код по почте и может распечатать отправленный документ через МФУ.

---

## Связанные страницы

- [Настройка подключения к почтовому серверу](http://wiki.printum.io/books/4-integracii/page/nastroika-podkliuceniia-k-poctovomu-serveru)
- [Настройка печати через почту](http://wiki.printum.io/books/4-integracii/page/nastroika-pecati-cerez-poctu)