﻿# Подключить электронную почту к линии

> [HTML Version](inbox.html)

Подключите электронный почтовый ящик к линии в качестве одного из каналов сбора обращений от клиентов. Пользователи смогут написать письмо на вашу корпоративную почту, а операторы ответят на запрос из интерфейса ELMA365. При этом история переписки с каждым клиентом сохранится внутри системы.

Особенности работы с линией, к которой подключена электронная почта:

1. При получении нового письма в разделе **Линии** создастся новая сессия. Её название будет соответствовать теме письма. Вы увидите имя пользователя и его почту. Если клиент уже обращался, предыдущая сессия возобновится, и сообщение отобразится в ней. Подробнее об этом читайте в статье [«Обработать обращение»](working_in_chat.md).  
В письмах будут доступны файлы только разрешённых форматов, которые заданы в разделе [Администрирование > Файлы](360024799491.md#file-extension).

2. В линиях, к которым подключена электронная почта, операторы могут начинать общение с клиентами самостоятельно. Как это сделать, читайте в статье [«Создать сессию с внешним пользователем»](create-session.md).

3. Когда для линии настроен ELMA Bot, он может реагировать на запросы пользователей: предлагать оператору подсказки для сообщений или отвечать вместо него. Подробнее о режимах работы бота читайте в статье [«Подключить бота к линии»](connect-bot.md).

````
начало внимание

````
Настроить подключение электронной почты к линии могут только пользователи, входящие в группу [Администраторы](360006871932.md#administrators).

````
конец внимание

## ````
Подключить почту

К одной линии вы можете подключить один почтовый адрес. Для этого:

1. Перейдите в **Администрирование > Линии**. 

2. Выберите линию из списка или [создайте](create_line.md) новую, нажав кнопку **+ Линия** в правом верхнем углу.

3. Перейдите на вкладку **Мессенджеры и почта **и нажмите кнопку** (button-inbox.png)**.

4. В открывшемся окне настроек выберите вкладку: 

- **Расширенные** — настройки для подключения почты с помощью протоколов SMTP и IMAP, например, для почтового адреса с корпоративным доменом; 

- **Простые** — настройки для подключения самых распространённых почтовых сервисов. На этой вкладке в полях **Сервис**\*, **Логин\*** и **Пароль\*** достаточно указать наименование сервиса и логин и пароль от подключаемой электронной почты. 

**(inbox-1.png)**

1. **Настройки учётной записи**.

- **E-mail\*** — укажите адрес подключаемой электронной почты;

- **Сервис\*** — выберите почтовый сервис из выпадающего списка: Gmail, Mail, Yandex, Rambler, Yahoo, Outlook, Office365.

Если вы подключаете почту с корпоративным доменом, выберите опцию **Другой** и заполните настройки подключения протоколов SMTP и IMAP;

- **Авторизация по OAuth2** — для подключения почтового ящика к линии можно использовать авторизацию через OAuth2. В этом случае передавать пароль от почты на стороне ELMA365 не требуется. Достаточно ввести электронный адрес в полях **E-mail\*** и **Логин\***, затем указать почтовый сервис и [авторизоваться](#connect-inbox) в нём. Это обеспечивает простоту интеграции и дополнительную безопасность учётных данных.

Использование внешней авторизации при подключении почты доступно, если администратор системы настроил модуль OAuth2 для авторизации в почтовом сервисе. Подробнее читайте в статье [«Пользовательский модуль для авторизации через сторонние сервисы»](external-oauth2-integration.md#inbox-auth-module).

````
начало внимание

````
Чтобы использование авторизации через OAuth2 для подключения почты стало доступно, [администратору системы](360006871932.md#administrators) нужно включить фича-флаг `enableLinesOauth2`. Подробнее об этом читайте в статьях [«Изменение параметров ELMA365 Enterprise»](change-settings-enterprise.md) и [«Изменение параметров ELMA365 Standard»](change-elma365standard-parameters.md). Если вы используете поставку SaaS, для включения фича‑флага обратитесь к вашему менеджеру ELMA365.

````
конец внимание

2. ````
**Настройки SMTP и IMAP подключения**.

В этих блоках наименования серверов SMTP и IMAP указываются в формате:

- имя протокола;

- ваш домен или поставщик электронной почты — отделяется точкой;

- используемый порт подключения — отделяется двоеточием.

Примеры: **smtp.myserver.com:465** и **imap.myserver.com:993**.

Параметры защиты подключения, от которых зависит цифровой порт, настраиваются администратором, создавшим электронный адрес.

Чтобы настроить подключение, заполните поля:

- **SMTP сервер\*** — укажите параметры протокола исходящей почты, включая порт, например:

	- 25 — для незащищённого соединения;

	- 465 — для соединения с шифрованием TLS;

	- 587 — для соединения с шифрованием STARTTLS;

- **IMAP сервер\* **— укажите параметры протокола входящей почты, включая порт, например: 

	- 143 — для незащищённого соединения и соединения с шифрованием STARTTLS;

	- 993 — для соединения с шифрованием TLS;

- **Защита соединения **— выберите способ шифрования данных, используемый сервером: **STARTTLS** или **TLS**. Если защита не применяется, установите **Нет**;

- **Логин\***, **Пароль\*** — укажите учётные данные для подключаемого сервера SMTP или IMAP, которые можно запросить у администратора сервера;

- **Имя пользователя** — укажите дополнительную информацию об отправителе, которую получатель увидит в письме рядом с вашим электронным адресом. Например, название компании, отдела или имя сотрудника.

Обратите внимание, в настройках некоторых почтовых сервисов необходимо дополнительно разрешить доступ к почтовому ящику по протоколу IMAP. 

Настройки доступа по протоколу на примере сервиса Yandex 

  
Для сервиса Yandex перейдите в раздел **Все настройки > Почтовые программы**. Включите опции **С сервера imap.yandex.ru по протоколу IMAP** и** Пароли приложений** **и** **OAuth-токены**. Сохраните настройки. После этого необходимо сгенерировать специальный пароль для приложения. Это нужно, чтобы обезопасить учётную запись и не сообщать сторонним сервисам основной пароль от аккаунта. Подробнее об этом читайте в документации от Yandex в статье [«Пароли приложений»](https://yandex.ru/support/id/authorization/app-passwords.html).  
  
Для создания пароля перейдите в [Управление аккаунтом](https://passport.yandex.ru/profile/) и в разделе **Пароли и авторизации** выберите **Включить пароли приложений**. Введите пароль от аккаунта, чтобы подтвердить действие, и нажмите **Создать** **новый пароль**. Укажите тип приложения **Почта**, затем введите название приложения, например, **ELMA365**, и нажмите **Создать**. В открывшемся окне скопируйте сгенерированный пароль для приложения.  
  
После создания пароля приложения вернитесь в интерфейс ELMA365 и в окне подключения электронной почты введите сгенерированный пароль приложения в поле **Пароль\***.

3. **Настройки подписи**.

В этом блоке укажите подпись, которая будет добавляться к сообщениям в линии. Клиенты увидят её во входящих письмах. Вы можете пропустить этот шаг и указать подпись позднее. 

5. Нажмите **Подключить**.

Если вы не используете OAuth2-авторизацию, соединение с почтовым сервером произойдёт автоматически на основе данных, введённых ранее.

При использовании OAuth2 выберите из списка почтовый сервис, который указали в настройках. В открывшемся окне войдите в аккаунт, используя свои учётные данные.

Когда соединение будет успешно установлено, электронная почта подключится к линии. В настройках линии на вкладке **Мессенджеры и почта** вы увидите название и статус привязанного ящика.

**(inbox-2.png)**

Теперь на вкладке **Мессенджеры и почта** вы можете:

- временно отключить канал — нажмите напротив его названия переключатель (on_button.png). Статус изменится с **Активен** на **Разорван**. Для восстановления подключения повторно используйте этот переключатель;

- изменить название канала, подключённый адрес или подпись для писем — нажмите напротив него значок карандаша;

- безвозвратно удалить мессенджер из настроек линии — нажмите значок корзины.

Подробнее об управлении подключённым каналом читайте в статьях:

- [«Удалить мессенджер или почту из линии»](delete-channel.md);

- [«Восстановить соединение с мессенджером или почтой»](reconnect-channel.md).