Описание

Данная услуга предназначен для передачи сообщений посредством email на факс получателя по произвольному номеру телефона.

Установка

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