Email канал
Webim предоставляет возможность интеграции с Email каналом, чтобы данные обращения также попадали в РМО, распределялись на операторов и обрабатывались в едином интерфейсе. Это реализовано при помощи настройки переадресации писем в Панель управления Webim.
Подключение в облаке
-
Откройте приложение или веб-версию Webim и кликните на пункт Каналы общения в меню слева.
-
В боковом меню выберите Каналы общения, выберите Email, нажмите Добавить канал.
Добавление email канала -
Заполните поля в соответствии с пояснениями (все они обязательны к заполнению). Обратите внимание, что для интеграции нужно присылать письма именно на Ваш адрес, а уже с него они должны автоматически пересылаться на сгенерированный нами. В противном случае корректная работа интеграции не гарантируется.
-
Скопируйте сгенерированную почту, нажмите Сохранить.
Форма добавления email канала -
Произведите настройки со стороны почтового сервиса, примеры: Mail.ru, Yandex, Gmail.
-
Оставьте вкладку с настройками открытой. В новой вкладке откройте Рабочее место оператора Webim, скопируйте код подтверждения из сообщения.
Код подтверждения -
Вернитесь в настройки почты и вставьте скопированный код подтверждения из предыдущего шага.
-
Сохраните настройки почты.
Подключение для hosted-клиентов
В hosted-инсталляциях почтовый канал работает только через Mailgun.
Регистрация и подготовка 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 → Добавить канал, далее подтвердите адрес.
Настройка пересылки в Mail.ru
-
В левом нижнем углу нажмите Настройки.
Открытие настроек почты mail.ru -
Далее в том же углу нажмите Все настройки.
Открытие настроек почты mail.ru -
Перейдите на вкладку Фильтры и нажмите Добавить пересылку.
Добавление пересылки -
В открывшейся форме вставьте адрес пересылки Webim и нажмите Сохранить.
Ввод адреса пересылки
Настройка пересылки в Yandex
-
Перейдите в Правила обработки почты.
Правила обработки почты -
Нажмите Создать правило.
Кнопка Создать правило -
Выберите Переслать по адресу и введите адрес, который был сгенерирован в Webim.
Настройка пересылки по адресу
Настройка переадресации в Gmail
-
В правом верхнем углу откройте Настройки почты -> Все настройки.
Настройки почты -
Выберите вкладку Пересылка и POP/IMAP, нажмите Добавить адрес пересылки, в открывшемся окне вставьте скопированный на шаге 3 адрес, нажмите След..
Добавление адреса пересылки -
Адрес добавлен, нажмите ОК.
Подтверждение -
Выберите Пересылать копии входящих сообщений на адреса.
Пересылать копии входящих сообщений на адреса -
Нажмите Сохранить изменения.
Сохранение изменений
Настройка переадресации сервера
Корректно настроить переадресацию писем на сгенерированный нами Email на уровне пользователя почтового клиента невозможно. Поэтому, если вы используете собственный почтой сервер, то обратитесь к администраторам почтового сервера для настройки переадресации. Обратите внимание, что в письмо не должны добавляться никакие новые заголовки и не должно изменяться поле Отправитель.
N.B.
Обратите внимание на смежные понятия, описанные ниже:
-
Клиентские приложения (напр. Outlook, Thunderbird) делают remailing (пересылку) с изменением сообщения. Изменяться оно может цитированием, сдвигом, добавлением заголовком или всем вместе.
-
В случае forwarding (переадресации), изменяется получатель (на того, кому пересылается), а отправитель остаётся без изменений.
Мы не гарантируем корректную работу канала Email, если писать непосредственно на сгенерированную нами почту. Нужно писать на указанный Вами адрес, с тем чтобы уже оттуда письма автоматически переадресовывались нам. В этом случае обращения должны корректно поступать в Webim.