# Email канал

 **Webim** предоставляет возможность интеграции с Email каналом, чтобы данные обращения также попадали в **РМО**, распределялись на операторов и обрабатывались в едином интерфейсе.

## Подключение в облаке

В облаке доступны два варианта подключения Email:

  * **Email** — пользователи пишут на ваш **email-адрес**, а вы настраиваете автоматическую пересылку входящих писем на сгенерированный адрес **Webim**.

  * **Email IMAP** — Webim подключается к почтовому ящику по IMAP для получения входящих писем, а отправка ответов выполняется по SMTP.

### Подключение Email

  1. Откройте приложение или веб-версию **Webim** и кликните на пункт **Каналы общения** в меню слева.

  1. Выберите **Email**, нажмите **Добавить канал**.

    ![Добавление email канала](https://webim.ru/kb/img/channels/mail/e-mail/add-email-channel.webp)

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

  1. Скопируйте сгенерированную почту, нажмите **Сохранить**.

    ![Форма добавления email канала](https://webim.ru/kb/img/channels/mail/e-mail/email-channel-form.webp)

  1. Произведите настройки со стороны почтового сервиса, примеры: [Mail.ru](#mail-ru), [Yandex](#yandex), [Gmail](#gmail).

  1. Оставьте вкладку с настройками открытой. В новой вкладке откройте **Рабочее место оператора Webim**, скопируйте код подтверждения из сообщения.

    ![Код подтверждения](https://webim.ru/kb/img/channels/mail/e-mail/message-with-verification-code.webp)

  1. Вернитесь в настройки почты и вставьте скопированный код подтверждения из предыдущего шага.

  1. Сохраните настройки почты.

### Подключение канала Email IMAP {: #imap-setup }

  1. Откройте приложение или веб-версию **Webim** и кликните на пункт **Каналы общения** в меню слева.

  1. Выберите **Email IMAP**, нажмите **Добавить канал**.

    ![Добавление канала Email IMAP](https://webim.ru/kb/img/channels/mail/e-mail/add-email-channel-imap.webp){ style="width: 705px; max-width: 100%" }

  1. Заполните настройки **SMTP**. Они используются для отправки ответов и исходящих сообщений.

    ![Настройки SMTP](https://webim.ru/kb/img/channels/mail/e-mail/email-channel-imap-smtp-form.webp){ style="width: 765px; max-width: 100%" }

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

    ![Настройки IMAP](https://webim.ru/kb/img/channels/mail/e-mail/email-channel-imap-imap-form.webp){ style="width: 765px; max-width: 100%" }

  1. Сохраните настройки почты.

## Подключение для hosted-клиентов { #hosted }

В hosted-инсталляциях почтовый канал может работать через **Mailgun** или **по IMAP и SMTP**.

**Канал Email IMAP** можно подключить и на hosted-инсталляции. Используйте инструкцию выше: [Подключение канала Email IMAP](#imap-setup).

### Регистрация и подготовка Mailgun {: #mailgun-setup }

  1. Зарегистрируйте аккаунт на сайте [Mailgun](https://www.mailgun.com/) и подтвердите адрес электронной почты.

  1. В интерфейсе Mailgun добавьте домен отправки (рекомендуется поддомен, например `mg.example.com`).

  1. Настройте DNS-записи для домена.

  1. Дождитесь верификации домена в Mailgun (после распространения DNS-записей).

  1. Откройте конфигурацию сервера (обычно `/etc/webim/main.ini`).

  1. В интерфейсе Mailgun получите Sending API key и запишите его в `main.ini`: `channels_email_mailgun_api_key_v2 = "XXXXXXXXXXXXXXXXXXXX"`.

  1. В разделе безопасности вебхуков Mailgun получите Webhook Signing Key и запишите его в `main.ini`: `channels_email_mailgun_webhook_signing_key = <значение>`.

  1. Убедитесь, что домен Mailgun указан в `partner_settings.domain` (account config).

  1. Webim валидирует параметры `timestamp`, `token`, `signature` в каждом вебхуке Mailgun. При неверной подписи возвращается HTTP 403.

  1. Примените конфигурацию, перезапустив сервисы **Webim** в вашей инсталляции.

После этого канал **Email** создаётся в интерфейсе так же, как описано выше: **Каналы общения → Email → Добавить канал**, далее подтвердите адрес.

## Подпись в исходящих ответах { #email-signature }

В форме канала **Email** задаётся **подпись** — общий для канала текст, который добавляется в конец исходящих писем. Блок подписи в теле письма следует за текстом ответа оператора и начинается со строки-разделителя `--` (два дефиса); далее при включённых опциях выводятся имя и должность оператора на отдельных строках, затем текст подписи канала.

Один и тот же текст подписи канала может сочетаться с данными **конкретного оператора**, который отправил ответ:

  * **Добавить имя оператора в подпись** — выводится отображаемое имя оператора; если оно не задано в профиле — полное имя из профиля.
  * **Добавить должность оператора в подпись** — выводится значение поля **Должность** в карточке сотрудника в разделе **Сотрудники** в Панели управления. Поле **Должность** добавлено в профиль сотрудника в рамках этой же доработки. Если должность не заполнена, отдельная строка с должностью не добавляется, даже если опция включена.

При необходимости в текст подписи канала можно вставить ссылку на изображение; отображение у получателя зависит от почтового клиента.

Пока в настройках канала не указан текст подписи, блок подписи к письму не формируется (в том числе имя и должность не подставляются).

После блока подписи может следовать цитирование предыдущей переписки с посетителем.

## Настройка пересылки в Mail.ru { #mail-ru }

  1. В левом нижнем углу нажмите **Настройки**.

    ![Открытие настроек почты mail.ru](https://webim.ru/kb/img/channels/mail/e-mail/open-mailru-settings.webp)

  1. Далее в том же углу нажмите **Все настройки**.

    ![Открытие настроек почты mail.ru](https://webim.ru/kb/img/channels/mail/e-mail/open-mailru-general-settings.webp)

  1. Перейдите на вкладку **Фильтры** и нажмите **Добавить пересылку**.

    ![Добавление пересылки](https://webim.ru/kb/img/channels/mail/e-mail/add-redirect.webp)

  1. В открывшейся форме вставьте адрес пересылки **Webim** и нажмите **Сохранить**.

    ![Ввод адреса пересылки](https://webim.ru/kb/img/channels/mail/e-mail/enter-webim-redirect-address.webp)

## Настройка пересылки в Yandex { #yandex }

  1. Перейдите в **Правила обработки почты**.

    ![Правила обработки почты](https://webim.ru/kb/img/channels/mail/e-mail/yandex-rules.webp)

  1. Нажмите **Создать правило**.

    ![Кнопка Создать правило](https://webim.ru/kb/img/channels/mail/e-mail/yandex-create-rule.webp)

  1. Выберите **Переслать по адресу** и введите адрес, который был сгенерирован в **Webim**.

    ![Настройка пересылки по адресу](https://webim.ru/kb/img/channels/mail/e-mail/yandex-forward-mail.webp)

## Настройка переадресации в Gmail { #gmail }

  1. В правом верхнем углу откройте **Настройки почты -> Все настройки**.

    ![Настройки почты](https://webim.ru/kb/img/channels/mail/e-mail/open-gmail-settings.webp)

  1. Выберите вкладку **Пересылка и POP/IMAP**, нажмите **Добавить адрес пересылки**, в открывшемся окне вставьте скопированный на шаге 3 адрес, нажмите **След.**.

    ![Добавление адреса пересылки](https://webim.ru/kb/img/channels/mail/e-mail/gmail-add-forward-address.webp)

  1. Адрес добавлен, нажмите **ОК**.

    ![Подтверждение](https://webim.ru/kb/img/channels/mail/e-mail/gmail-confirmation.webp)

  1. Выберите **Пересылать копии входящих сообщений на адреса**.

    ![Пересылать копии входящих сообщений на адреса](https://webim.ru/kb/img/channels/mail/e-mail/gmail-forward-mail-copies-to-addresses.webp)

  1. Нажмите **Сохранить изменения**.

    ![Сохранение изменений](https://webim.ru/kb/img/channels/mail/e-mail/gmail-save.webp)

## Настройка переадресации сервера

Корректно настроить **переадресацию** писем на сгенерированный нами Email на уровне пользователя почтового клиента невозможно. Поэтому, если вы используете собственный почтой сервер, то обратитесь к администраторам почтового сервера для настройки переадресации. Обратите внимание, что в письмо не должны добавляться никакие новые заголовки и не должно изменяться поле **Отправитель**.

!!! Note "N.B."
    Обратите внимание на смежные понятия, описанные ниже:

      * Клиентские приложения (напр. **Outlook**, **Thunderbird**) делают **remailing** (**пересылку**) с изменением сообщения. Изменяться оно может цитированием, сдвигом, добавлением заголовком или всем вместе.

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

Мы не гарантируем корректную работу канала Email, если писать непосредственно на сгенерированную нами почту. Нужно писать на указанный Вами адрес, с тем чтобы уже оттуда письма автоматически переадресовывались нам. В этом случае обращения должны корректно поступать в **Webim**.

---

Источник: https://webim.ru/kb/channels/mail/email.html