Установка

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

sudo aptitude install ecss-email2fax

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

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

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

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

Во время установки будет необходимо ввести заголовок факсового сообщения.
В нем можно использовать переменные @FromEmail, @FromNumber, @ToNumber
Где:

1. @FromEmail — email отправителя письма;
2. @FromNumber — номер отправителя факса;
3. @ToNumber — номер получателя факса.

Пример ответов:

После установки данная услуга автоматически стартует и начинает свою работу.

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

Например, посмотреть текущий статус systemd-сервиса:

systemctl status ecss-email2fax.service

Настройка домена

При использовании fax2email предварительно необходимо настроить ваш домен для отправки писем (/domain/<DOMAIN>/notifier/):

admin@[ds1@ecss1#ECSS 010070]:/$ /domain/ramm.test/notifier/info              
┌───────────────────────────┬─────────┬────────────────────────┐
│         Property          │ Domain  │         Value          │
├───────────────────────────┼─────────┼────────────────────────┤
│email                      │ramm.test│sc.ssw@eltex.loc        │
│email_buffer_limit         │ramm.test│50                      │
│email_enable               │ramm.test│true                    │
│email_password             │ramm.test│password                │
│email_port                 │ramm.test│default (25)            │
│email_protection_connection│ramm.test│none                    │
│email_resend_count_max     │ramm.test│5                       │
│email_resend_timer         │ramm.test│30                      │
│email_server               │ramm.test│mail.eltex.loc          │
│email_username             │ramm.test│sc.ssw                  │
│jabber_buffer_limit        │ramm.test│50                      │
│jabber_enable              │ramm.test│false                   │
│jabber_password            │ramm.test│ylperon                 │
│jabber_port                │ramm.test│5222                    │
│jabber_reconnect_timer     │ramm.test│10                      │
│jabber_version             │ramm.test│0.0                     │
│jid                        │ramm.test│ecss-10@jabber.eltex.loc│
└───────────────────────────┴─────────┴────────────────────────┘

Также добавьте соответствующий кодек:

domain/ramm.test/media-profile/codecs-add default image T38 --enabled true

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

1. /var/log/ecss/email2fax — расположение логов
2. /var/lib/ecss/ecss-email2fax/ — хранилище промежуточных файлов
3. /usr/lib/ecss/ecss-email2fax/config.yaml — конфигурация, которую вы задали при установке

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

После установки и настройки услуги пользователи сразу могут начать им пользоваться.
Для этого достаточно отправить письмо (опционально содержащее вложением) на 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;" />