Отправка почты на факс (Email to Fax)
Описание
Данная услуга предназначен для передачи сообщений посредством 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
Где:
- @FromEmail — email отправителя письма;
- @FromNumber — номер отправителя факса;
- @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: | Укажите порт, который вы выбрали для работы email2fax | 5080 |
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: | Выберите уровень логирования, где:
| 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? | Использовать ли ssl | No |
[smtp] Enter email: | Введите почту | sc.ssw@eltex.loc |
[smtp] Use password (authentication)? | Использовать ли пароль для авторизации | Yes |
[smtp] Email password: | Введите пароль | |
[smtp] port: | Укажите порт | 25 |
[smtp] Use ssl? | Использовать ли ssl | No |
[smtp] Enter title: | Введите заголовок | Email2Fax-Report |
[smtp] Enter path to template: | Введите путь до шаблонов | ecss/ecss-email2fax/emailer/template |
После установки данная услуга автоматически стартует и начинает свою работу.
При необходимости, можно управлять его работой, используя штатные средства, характерными для любого systemd-сервиса.
Например, посмотреть текущий статус systemd-сервиса:
systemctl status ecss-email2fax.service systemctl status ecss-email2fax-mail.service systemctl status ecss-email2fax-sip.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
Иерархия файлов
- /var/log/ecss/email2fax — расположение логов
- /var/lib/ecss/ecss-email2fax/ — хранилище промежуточных файлов
- /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;" />