Установка

Для установки услуги необходимо установить пакет из репозитория ecss10 на один или несколько хостов ecss:

sudo aptitude install ecss-email2fax

В процессе установки необходимо ответить на соответствующие вопросы:

• параметры sip-аккаунта абонента, от имени которого служба будет взаимодействовать с софтсвичем и осуществлять вызовы на факс-аппараты;
• задать параметры email-экаунта, который будет использовать услугу, в том числе параметры подключения к pop3/imap/smtp серверам;
• другие настройки, например количество попыток доставки, необходимость отправки репортов об успешной или не успешной доставке и т.д;

При установке пакета производится попытка автоматически определить сервер почты по логину(email2fax@eltex.loc), если домен имеет запись MX, то подставляется по умолчанию именно эта запись(также остаётся возможность изменить), если же не удалось получить запись,то подставляется mail.${DOMAIN} (mail.eltex.loc)

При введении заголовка факса, следует учитывать, что не все символы корректны([]<>) — наличие данных символов заставляет факс не печатать заголовок.

После установки данная услуга автоматически стартует и начинает свою работу.
При необходимости,можно управлять его работой используя штатные средства, характерными для любого systemd сервиса.
Например посмотреть текущий статус systemd-сервиса:

systemctl status ecss-email2fax.service

Иерархия файлов

1. /var/log/ecss/email2fax — расположение логов
2. /var/lib/ecss/ecss-email2fax/ — хранилище промежуточных файлов

Порядок использования

После установки и настройки услуги пользователи сразу могут начать им пользоваться.
Для этого достаточно отправить письмо (опционально содержащее вложением) на email, выделенный для данной услуги, где в теме письма указать телефонный номер получателя.
Услуга, при получении данного отправления, начнет автоматический дозвон и отправку полученного сообщения по факсу с использованием штатных протоколов (T38,G711/wbd)
По окончании отправителю будет сформирован отчет об успешной или не успешной доставке (если данная опция была активирована при установке)

Шаблонизация почтовых отчетов

В случае необходимости изменения отправляемой информации в отчетах, можно воспользоваться шаблонами.
Дефолтные шаблоны лежат по пути /usr/lib/ecss/ecss-email2fax/emailer/template. Можно создать свою папку с кастомными шаблонами и использовать их. Для этого потребуется переопределить путь до шаблонов, которые будет использовать E2F.

Шаблоны должны иметь имена failure и success, также в них можно использовать различные переменные, которые берутся из системы. Список переменных:

• {{ email }} — email отправителя;
• {{ date }} — дата отправки сообщения;
• {{ time }} — время отправки сообщения;
• {{ number }} — номер на который было отправлено сообщение.

Также имеется возможность использования собственных изображений, отправляемые в почтовых отчетах. Для этого в папку /usr/lib/ecss/ecss-email2fax/emailer/template/images требуется скопировать собственные изображения или логотипы.
После чего изменить почтовый отчет нужным образом. Пример failure.html:

<img src="cid:logo.png" alt="X" width="16" height="16" style="display: block;" />