Описание

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

Установка

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

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

ВопросПояснениеПример ответа
SIP user (without domain):Укажите пользователя, с которого будут совершаться звонки для передачи email2fax 9999
SIP password:Пароль пользователя, с которого будут совершаться звонки email2fax
IPv4 SIP server:Укажите IP-адрес и порт который вы выбрали для sip-трафика в рамках домена, где был создан пользователь (9999 в нашем примере)  192.168.116.168:5051
Enter sip listen port:Укажите порт, который вы выбрали для работы email2fax5080
SIP domain:Укажите доменramm.test
Time between attempts to check message:Укажите время между попытками проверки сообщений

1.5


Re-Try count for wait fax message:Укажите количество попыток для факсимильного сообщения15
IPv4 host:Выберите IP-адрес хоста192.168.116.168
Log level:Выберите уровень логирования, где:
  • debug — максимальный уровень 
  • info — только информирующие сообщение
  • error — только сообщения об ошибках
error
Header for fax messages:Введите заголовок факсового сообщенияEMAIL2FAX
Enter the mail that will be used if the sender is unknown:Введите почту, которая будет использована, если отправитель неизвестен sc.ssw@eltex.loc
Mail inspection frequency in sec:Частота проверки почты в секундах10
what are you want to configure?Выберите проток работы с почтойpop3
[pop3] Enter email:Введите почту sc.ssw@eltex.loc
[pop3] Email password:Укажите пароль
[pop3] port:Укажите порт110
[pop3] Use ssl?Использовать ли sslNo
[smtp] Enter email:Введите почтуsc.ssw@eltex.loc
[smtp] Use password (authentication)?Использовать ли пароль для авторизацииYes
[smtp] Email password:Введите пароль
[smtp] port:Укажите порт25
[smtp] Use ssl?Использовать ли sslNo
[smtp] Enter title:Введите заголовокEmail2Fax-Report
[smtp] Enter path to template:Введите путь до шаблоновecss/ecss-email2fax/emailer/template

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

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

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

systemctl status ecss-email2fax.service

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

При использовании fax2email предварительно необходимо настроить ваш домен для отправки писем:

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│
└───────────────────────────┴─────────┴────────────────────────┘
BASH

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

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

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

  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;" />
CODE