Задача

Организовать автоматизированный шлюз для пересылки документов полученных через электронную почту, адресатам на типовые факсовые аппараты подключенные в телефонную сеть.
Обеспечить статистику и контроль доставки с ведением базы данных по событиям

Требования к системе

Наличие доступа по протоколу POP3 к выделенному для этой цели почтовому ящику. Ящик не должен использоваться для других целей, все письма попадающие в него будут удаляться.
Наличие доступа к телефонной сети посредством VoIP (IAX2,SIP) с поддержкой aLaw или uLaw или иных средств доступных для использования совместно с Asterisk.

Условия в примере

Реальный или виртуальный сервер на базе ОС Ubuntu Server 12.04 имеющий сетевой доступ к учетным записям:

IAX2 (VoIP Asterisk пользователь: user пароль: 123 адрес: asterisk.local)
POP3 (пользователь: user пароль: 123 адрес: mail.local)

Письма автоматически формируются платформой 1Сv82 по принципу:

Адрес получателя - efax@mail.local
Тема и содержимое не важно
Только одно почтовое вложение в формате pdf (средствами платформы 1с)

Имя вложения содержит всю необходимую информацию, например:

msk_0004567_84991112233-1_9-18_1-5.pdf где:
- "_" - знак разделения значащих полей
- msk - префикс базы 1с (филиала)
- 0004567 - номер документа
- 84991112233 - номер абонента (получателя факса). 1 - добавочный номер, если указан то до набрать в тоновом режиме (например прямой номер факса автомата)
- 9-18 - время доступности факса у абонента с 9 до 18 часов
- 1-5 - дни недели, когда доступен прием факса у абонента (с пн по пт)

Принцип работы

Логический

Выполняется периодическая проверка почтового ящика и в случае обнаружения в нем писем они скачиваются системой
Генерируется случайный уникальный код, который будет участвовать во всех этапах движения этого документа и попадет в статистику
Из скачиваемых писем извлекаются вложения и складываются в папку входящих
Из этой папки выбирается файл отвечающий требованиям к формату имени
Из имени файла выделяются значащая информация и сохраняется в базу данных
Файл отправляется на доставку факсовому серверу, сам файл перемещается в папку обработка
Факсовый сервер на основании переданных параметров помещает факс в очередь на отправку
Через виртуальный модем подключенный к серверу ИП телефонии производится дозвон до получателя
С помощью синтеза голоса получатель уведомляется о сути звонка
С помощью распознавания голоса в базу данных заносится информация от получателя (напр. ФИО, должность)
По результату звонка в базу заносится информация об успешности или не успешности отправки факса с указанием причины
На том-же основании файл перемещается в соответствующую папку

По компонентам

MySQL сервер для хранения статистики
Fetchmail забирает письма с внешнего почтового ящика по протоколу pop3 и передает их Procmail
Procmail (обработчик почтовых сообщений) передает тело письма программе ripmime, а затем запускает bash-скрипт обработки
uudeview извлекает из письма прикрепленный файл и сохраняет в папку входящих
bash-скрипт анализирует формат названия файла, передает файл в Hylafax, пишет в mysql полученную информацию
Hylafax (факс сервер) получив задание выполняет дозвон через iaxmodem, получателю факса
iaxmodem подключен к локальному серверу Asterisk (можно создать множество модемов)
Asterisk выполняет подключение к городской телефонной сети через voip протокол, обеспечивает голосовое приветствие
API Google используется для синтеза и распознавания голоса в момент ответа абонента, через ARI скрипты Asterisk

Установка компонентов

Установка компонентов из репозитория

apt-get update
apt-get install lamp-server^ asterisk iaxmodem hylafax-server postfix procmail fetchmail uudeview

Мастера установки спросят пароль для сервера mysql (запомним его), libvpb0 оставим по умолчанию 7, а для Postfix Configuration выберем Без настройки

Настройка

Создание базы данных

Вся статистика работы факс-шлюза будет хранится в базе на mysql сервере.

Создадим новую базу faxstats

mysqladmin create faxstats -p

Затем войдем в консоль mysql и выполним запрос на создание таблицы и назначим права доступа:

mysql -p

USE mystathost;
CREATE TABLE
 pinggw (
  datetime DATETIME,
  hostip VARCHAR(20),
  hosteth VARCHAR(10),
  hostgwip VARCHAR(20),
  pinglost TINYINT,
  pingavg FLOAT(3),
  trafrx BIGINT,
  traftx BIGINT);
# Тут назначим права и разрешим удаленное подключение к базе
# Пользователь mystathost
# Пароль mYs1Pa_swD
grant usage on *.* to mystathost@localhost identified by 'mYs1Pa_swD';
grant all privileges on mystathost.* to mystathost@localhost;

Настройка сборщика почты

На данном этапе мы решаем задачу по подключению к почтовому, скачивание из него писем, извлечение из них вложений и запуска обработчика этих вложений

Создадим папки для сохранения вложений

mkdir /home/efax/ && cd /home/efax/
mkdir IN PROC ERR OK

Настройка fetchmail

Сохраняем копию оригинального файл конфигурации, очищаем его и пишем свои параметры

cp /etc/fetchmailrc /etc/fetchmailrc.orig
echo ""> /etc/fetchmailrc
nano /etc/fetchmailrc

set daemon         10  # Проверка новых писем (в сек)

# Параметры подключения к почтовому ящику
poll mail.local        # Адрес сервера
proto pop3             # Протокол получения писем
user user              # Логин
pass 123               # Пароль
sslproto ""            # Не ругаться на сертификат
mda 'procmail -d %T'   # Передача управления procmail

Разрешаем запуск демона (службы)

echo "START_DAEMON=yes" > /etc/default/fetchmail

procmail обработчик писем

Задача принять от fetchmail письмо и направить его в uudeview для извлечения вложений и сохранения их в папку входящих, а затем передать управление bash-скрипту.

nano /etc/procmailrc

:0
* ^From:.*
{
 :0 f
 | uudeview -iq - -p /home/efax/IN/

 :0
 | /home/efax/mailtofax
}

Скрипт пересылки письма на факс

nano /home/efax/mailtofax

#!/bin/bash
# Путь до папки с входящими
pathin=/home/efax/IN

# Путь до папки с обрабатываемыми документами
pathproc=/home/efax/PROC

# Шаблон (регулярное выражение) для выборки файлов
freg=".+_.+_.+\.pdf"

# Составляем список всех файлов соответствующих шаблону
lsfiles=`ls -tr /home/efax/IN| grep -P $freg`

# Запускаем цикл обработки всех найденных на отправку файлов
for namefile in $lsfiles; do
IFS="_"
 set -- $namefile

# Разбираем имя файла на переменные
  preffil=$1
  id=$2
  numbertel=`echo $3|awk -F "-" '{print $1}'`
  numberdtmf=`echo $3|awk -F "-" '{print $2}'`
  worktime=$4
  workdays=$5

# Перемещаем файл в обработку
mv "$pathin/$namefile" "$pathproc/$namefile"

# Генерим уникальный ключ сессии
datetime=`date +"%Y/%m/%d %T"`
  uniqid=`echo $RANDOM$datetime|openssl md5 -r|awk '{print $1}'`

# Передаем файл факс серверу
istr=`sendfax -n -d "$numbertel-$uniqid" "$pathproc/$namefile"`
# Получаем присвоенный факс сервером номер задания
  jobnumber=`echo $istr|grep -Po "request id is \d+"|awk '{print $4}'`
# Записываем в журнал
echo "$uniqid;$datetime;$preffil;$id;$numbertel;$namefile;$jobnumber" >> /var/log/mailfax.log

done

Делаем скрипт исполняемым

chmod +x /home/efax/mailtofax

Настройка Asterisk

Необходимо создать учетную запись IAX а так-же транк для подключения к провайдеру IP телефонии по SIP протоколу для совершения исходящих вызовов.

копируем оригинальный файл

cp /etc/asterisk/iax.conf /etc/asterisk/iax.conf.orig

очищаем оригинальный файл

echo ""> /etc/asterisk/iax.conf

открываем файл

nano /etc/asterisk/iax.conf

и прописываем следующий конфиг

[general]
allow=alaw

[iaxprovider]
type=peer
host=asterisk.local
username=user
fromuser=user
secret=123
qualify=yes

[910]
host=dynamic
type=friend
secret=faxfax123
requirecalltoken=no
context=from-internal

копируем оригинальный файл

cp /etc/asterisk/extensions.conf /etc/asterisk/extensions.conf.orig

очищаем оригинальный файл

echo ""> /etc/asterisk/extensions.conf

открываем файл

nano /etc/asterisk/extensions.conf

и прописываем следующий конфиг

[from-internal]
exten => _.,1,Dial(iax2/iaxprovider/${EXTEN})

Перезапускаем Asterisk

/etc/init.d/asterisk restart

Настройка IAXMODEM

Создаем конфигурацию виртуального модема

nano /etc/iaxmodem/iaxmodem-cfg.ttyIAX1

device /dev/ttyIAX1
owner uucp:uucp
mode 660
port 4570
refresh 300
server 127.0.0.1
peername 910
secret faxfax123
codec alaw

Запускаем виртуальный модем

/etc/init.d/iaxmodem start

Проверяем лог запуска

cat /var/log/iaxmodem/iaxmodem

Настройка hylafax Server

Запускаем мастер настройки

faxsetup

Отвечаем на все вопросы по умолчанию пока не появится вопрос:

Serial port that modem is connected to [ttyS0]?

Пишем имя порта ttyIAX1 и продолжаем отвечать на вопросы мастера, пока не появится запрос о добавлении второго модема Do you want to run faxaddmodem to configure another modem [yes]? . На него отвечаем No Перезапускаем hylafax

/etc/init.d/hylafax restart

EMAIL-FAX-VOIP

Содержание