Email канал
Webim предоставляет возможность интеграции с Email каналом, чтобы данные обращения также попадали в РМО, распределялись на операторов и обрабатывались в едином интерфейсе.
Подключение в облаке
В облаке доступны два варианта подключения Email:
-
Email — пользователи пишут на ваш email-адрес, а вы настраиваете автоматическую пересылку входящих писем на сгенерированный адрес Webim.
-
Email IMAP — Webim подключается к почтовому ящику по IMAP для получения входящих писем, а отправка ответов выполняется по SMTP.
Подключение Email
-
Откройте приложение или веб-версию Webim и кликните на пункт Каналы общения в меню слева.
-
Выберите Email, нажмите Добавить канал.
Добавление email канала -
Заполните поля в соответствии с пояснениями (все они обязательны к заполнению). Обратите внимание, что для интеграции нужно присылать письма именно на Ваш адрес, а уже с него они должны автоматически пересылаться на сгенерированный нами. В противном случае корректная работа интеграции не гарантируется.
-
Скопируйте сгенерированную почту, нажмите Сохранить.
Форма добавления email канала -
Произведите настройки со стороны почтового сервиса, примеры: Mail.ru, Yandex, Gmail.
-
Оставьте вкладку с настройками открытой. В новой вкладке откройте Рабочее место оператора Webim, скопируйте код подтверждения из сообщения.
Код подтверждения -
Вернитесь в настройки почты и вставьте скопированный код подтверждения из предыдущего шага.
-
Сохраните настройки почты.
Подключение канала Email IMAP
-
Откройте приложение или веб-версию Webim и кликните на пункт Каналы общения в меню слева.
-
Выберите Email IMAP, нажмите Добавить канал.
Добавление канала Email IMAP -
Заполните настройки SMTP. Они используются для отправки ответов и исходящих сообщений.
Настройки SMTP -
Заполните настройки IMAP. Они используются для получения входящих писем. Внизу формы можно указать отдел, в который автоматически будут направляться почтовые диалоги.
Настройки IMAP -
Сохраните настройки почты.
Подключение для hosted-клиентов
В hosted-инсталляциях почтовый канал может работать через Mailgun или по IMAP и SMTP.
Канал Email IMAP можно подключить и на hosted-инсталляции. Используйте инструкцию выше: Подключение канала Email IMAP.
Регистрация и подготовка Mailgun
-
Зарегистрируйте аккаунт на сайте Mailgun и подтвердите адрес электронной почты.
-
В интерфейсе Mailgun добавьте домен отправки (рекомендуется поддомен, например
mg.example.com). -
Настройте DNS-записи для домена.
-
Дождитесь верификации домена в Mailgun (после распространения DNS-записей).
-
Откройте конфигурацию сервера (обычно
/etc/webim/main.ini). -
В интерфейсе Mailgun получите Sending API key и запишите его в
main.ini:channels_email_mailgun_api_key_v2 = "XXXXXXXXXXXXXXXXXXXX" -
В разделе безопасности вебхуков Mailgun получите Webhook Signing Key и запишите его в
main.ini:channels_email_mailgun_webhook_signing_key = <значение> -
Убедитесь, что домен Mailgun указан в
partner_settings.domain(account config). -
Webim валидирует параметры
timestamp,token,signatureв каждом вебхуке Mailgun. При неверной подписи возвращается HTTP 403. -
Примените конфигурацию, перезапустив сервисы Webim в вашей инсталляции.
После этого канал Email создаётся в интерфейсе так же, как описано выше: Каналы общения → Email → Добавить канал, далее подтвердите адрес.
Подпись в исходящих ответах
В форме канала Email задаётся подпись — общий для канала текст, который добавляется в конец исходящих писем. Блок подписи в теле письма следует за текстом ответа оператора и начинается со строки-разделителя -- (два дефиса); далее при включённых опциях выводятся имя и должность оператора на отдельных строках, затем текст подписи канала.
Один и тот же текст подписи канала может сочетаться с данными конкретного оператора, который отправил ответ:
- Добавить имя оператора в подпись — выводится отображаемое имя оператора; если оно не задано в профиле — полное имя из профиля.
- Добавить должность оператора в подпись — выводится значение поля Должность в карточке сотрудника в разделе Сотрудники в Панели управления. Поле Должность добавлено в профиль сотрудника в рамках этой же доработки. Если должность не заполнена, отдельная строка с должностью не добавляется, даже если опция включена.
При необходимости в текст подписи канала можно вставить ссылку на изображение; отображение у получателя зависит от почтового клиента.
Пока в настройках канала не указан текст подписи, блок подписи к письму не формируется (в том числе имя и должность не подставляются).
После блока подписи может следовать цитирование предыдущей переписки с посетителем.
Настройка пересылки в Mail.ru
-
В левом нижнем углу нажмите Настройки.
Открытие настроек почты mail.ru -
Далее в том же углу нажмите Все настройки.
Открытие настроек почты mail.ru -
Перейдите на вкладку Фильтры и нажмите Добавить пересылку.
Добавление пересылки -
В открывшейся форме вставьте адрес пересылки Webim и нажмите Сохранить.
Ввод адреса пересылки
Настройка пересылки в Yandex
-
Перейдите в Правила обработки почты.
Правила обработки почты -
Нажмите Создать правило.
Кнопка Создать правило -
Выберите Переслать по адресу и введите адрес, который был сгенерирован в Webim.
Настройка пересылки по адресу
Настройка переадресации в Gmail
-
В правом верхнем углу откройте Настройки почты -> Все настройки.
Настройки почты -
Выберите вкладку Пересылка и POP/IMAP, нажмите Добавить адрес пересылки, в открывшемся окне вставьте скопированный на шаге 3 адрес, нажмите След..
Добавление адреса пересылки -
Адрес добавлен, нажмите ОК.
Подтверждение -
Выберите Пересылать копии входящих сообщений на адреса.
Пересылать копии входящих сообщений на адреса -
Нажмите Сохранить изменения.
Сохранение изменений
Настройка переадресации сервера
Корректно настроить переадресацию писем на сгенерированный нами Email на уровне пользователя почтового клиента невозможно. Поэтому, если вы используете собственный почтой сервер, то обратитесь к администраторам почтового сервера для настройки переадресации. Обратите внимание, что в письмо не должны добавляться никакие новые заголовки и не должно изменяться поле Отправитель.
N.B.
Обратите внимание на смежные понятия, описанные ниже:
-
Клиентские приложения (напр. Outlook, Thunderbird) делают remailing (пересылку) с изменением сообщения. Изменяться оно может цитированием, сдвигом, добавлением заголовком или всем вместе.
-
В случае forwarding (переадресации), изменяется получатель (на того, кому пересылается), а отправитель остаётся без изменений.
Мы не гарантируем корректную работу канала Email, если писать непосредственно на сгенерированную нами почту. Нужно писать на указанный Вами адрес, с тем чтобы уже оттуда письма автоматически переадресовывались нам. В этом случае обращения должны корректно поступать в Webim.