Установка

Для установки услуги необходимо установить пакет из репозитория 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 }} - номер на который было отправлено сообщение.

Переменные нужно подставлять в таком виде: {ctx['number']

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

<td style="color: #ffffff; font-size: 16px; font-family: tahoma, arial, verdana, sans-serif; line-height: 20px;">
  Не удалось передать факсовое сообщение: {{ctx['Message-ID'].replace('<','').replace('>','')}}
</td