Настройка fax-to-email и email-to-fax в Askozia PBX
Askozia PBX — это Asterisk в веб-обёртке, и большинство задач в ней решается мышкой, а остальное — правкой конфигов. Разбираем три типовые задачи: виртуальный факс с доставкой на почту и отправкой из письма, голосовое меню с донабором и перехват вызова по *8.
Что такое Askozia PBX
Askozia PBX — дистрибутив IP-АТС на базе Asterisk с собственным веб-интерфейсом. Он ставился на небольшие серверы и встраиваемые устройства, а настройка большинства функций сводилась к формам в браузере. Для нестандартных задач в интерфейсе был встроенный редактор конфигурационных файлов Asterisk: можно было напрямую дописать диалплан или параметры абонентов.
Стандартный вход в веб-интерфейс после установки — пользователь admin, пароль askozia. По SSH заходят под root с тем же паролем, что у администратора веб-интерфейса. Пароль по умолчанию нужно сменить сразу после первого входа: станции с заводскими учётными данными быстро находят и используют для звонков за чужой счёт.
Ниже три задачи, которые чаще всего приходится решать на такой станции.
1. Голосовое меню с донабором внутреннего номера
Задача: на входящий звонок проигрывается приветствие, во время которого можно набрать внутренний номер. Если звонящий ничего не набрал — вызов уходит в группу или очередь.
Встроенный редактор маршрутов Askozia позволяет проиграть файл, но прерываемое приветствие (Background) удобнее описать вручную в extensions.conf:
[ivr-main]
exten => s,1,Answer()
same => n,Set(CHANNEL(language)=ru)
same => n,Background(/storage/usbdisk1/askoziapbx/media/sounds/custom/welcome)
same => n,WaitExten(4)
; донабор трёхзначного внутреннего номера
exten => _XXX,1,Dial(SIP/${EXTEN},45,tT)
same => n,Hangup()
; ничего не набрали — в группу 902, созданную в редакторе маршрутов
exten => t,1,Dial(Local/902@internal-caller-transfer)
exten => i,1,Playback(pbx-invalid)
same => n,Goto(s,1)
[from-trunk-custom]
exten => 666,1,Goto(ivr-main,s,1)
Путь к медиафайлам зависит от того, куда установлена система, а имя файла пишется без расширения. В настройках транка остаётся указать, что входящие вызовы идут на номер 666, — на виртуальный автосекретарь.
2. Перехват вызова по *8
Перехват позволяет ответить на звонок, который поступил на соседний телефон. Если группы перехвата из интерфейса не работают, их можно задать прямо в параметрах абонентов:
[201]
callgroup=1
pickupgroup=1
[202]
callgroup=1
pickupgroup=1
Код перехвата задаётся в features.conf, по умолчанию это *8:
[general]
pickupexten = *8
Главная ловушка: числовые группы ограничены диапазоном 0–63. Если указать, например, callgroup=100, ошибки не будет, но перехват не сработает. В новых версиях Asterisk есть именованные группы (named_call_group, named_pickup_group) — у них ограничения на количество нет.
3. Fax-to-email и email-to-fax
Как это устроено
- Приём (fax-to-email). Факс приходит в канал, Asterisk сохраняет его в TIFF, преобразует в PDF и отправляет письмом через SMTP-клиент
msmtp. - Отправка (email-to-fax). Пользователь пишет письмо с вложением на служебный ящик. Станция с помощью
fetchmailпо POP3 забирает письма, конвертирует вложение и отправляет его в канал на номер, указанный в теме письма.
Для приёма и отправки обязательно используйте разные почтовые ящики, иначе принятые факсы начнут отправляться по кругу.
Настройка в интерфейсе Askozia
- В разделе учётных записей откройте Факс и создайте виртуальный факс: внутренний номер, отображаемый номер (АОН) и адрес, на который приходят входящие факсы.
- Заполните параметры отправки: адрес POP3-сервера, ящик для заданий на отправку, логин и пароль.
- Укажите доверенные адреса — только письма с них принимаются к отправке. Без этого списка ваш факс сможет использовать любой, кто узнает адрес ящика.
- Настройте SMTP-клиент в разделе почты и отправьте тестовое письмо из интерфейса.
- Направьте входящий номер факса на созданный виртуальный факс.
Историю и статусы отправки показывает раздел Архив факсов. Очередь исходящих заданий лежит в /storage/usbdisk1/askoziapbx/faxspool — если факс «завис», начинать поиск стоит отсюда.
То же на чистом Asterisk
На обычном Asterisk схема собирается из модулей res_fax и res_fax_spandsp (нужна библиотека spandsp). Приём факса:
[fax-in]
exten => 4951234500,1,Answer()
same => n,Set(FAXFILE=/var/spool/asterisk/fax/${STRFTIME(${EPOCH},,%Y%m%d-%H%M%S)}-${CALLERID(num)}.tif)
same => n,ReceiveFAX(${FAXFILE})
same => n,Hangup()
exten => h,1,System(/usr/local/bin/fax2mail.sh "${FAXFILE}" "${CALLERID(num)}" "${FAXSTATUS}")
Скрипт доставки на почту:
#!/bin/bash
# fax2mail.sh — TIFF -> PDF -> письмо
TIF="$1"; FROM="$2"; STATUS="$3"
[ "$STATUS" = "SUCCESS" ] || exit 0
PDF="${TIF%.tif}.pdf"
tiff2pdf -o "$PDF" "$TIF"
echo "Входящий факс с номера $FROM" | mutt -s "Факс от $FROM" -a "$PDF" -- fax@example.com
tiff2pdf входит в пакет libtiff-tools, mutt отправляет письмо через локальный почтовый агент.
Для отправки документ нужно привести к факсовому TIFF. Это делает Ghostscript:
gs -q -dNOPAUSE -dBATCH -sDEVICE=tiffg3 -sPAPERSIZE=a4 -r204x196 \
-sOutputFile=/var/spool/asterisk/fax/out.tif document.pdf
После этого вызов создаётся call-файлом, а в диалплане после ответа выполняется SendFAX(/var/spool/asterisk/fax/out.tif). Забирать письма из ящика по-прежнему удобно через fetchmail с обработчиком, который сохраняет вложение и запускает конвертацию.
Через интернет факсы надёжнее передавать по протоколу T.38: в pjsip.conf у транка включается t38_udptl=yes, если оператор его поддерживает. Передача факса звуком по G.711 работает, но чувствительна к потерям пакетов и джиттеру.
Актуальность
Askozia PBX больше не развивается, а её последние версии построены на устаревших ветках Asterisk с chan_sip. Для новой установки стоит выбрать живой продукт: MikoPBX продолжает линию Askozia, есть также FreePBX или чистый Asterisk. Основы ручной настройки описаны в статье о базовой настройке Asterisk после установки, а примеры для современных версий используют PJSIP: Dial(PJSIP/...) вместо Dial(SIP/...).
Сам факс постепенно уходит, но во многих организациях его всё ещё требуют, и связка «факс — почта» остаётся самым удобным способом избавиться от бумажного аппарата.
Частые вопросы
Почему факс принимается, а письмо не приходит?
Проверьте настройки SMTP-клиента в разделе почты и отправьте тестовое письмо из интерфейса. На чистом Asterisk ищите ошибку в журнале почтового агента (msmtp, postfix) и в выводе скрипта, который отправляет файл.
Можно ли использовать один ящик для приёма и отправки факсов?
Нет. Если входящие факсы приходят в тот же ящик, из которого станция забирает задания на отправку, они начнут отправляться обратно и процесс зациклится. Нужны два разных ящика.
Почему перехват по *8 не работает?
Абоненты должны быть в одной группе: у того, кому звонят, call_group, у перехватывающего — pickup_group с тем же номером. Числовые группы ограничены диапазоном 0–63; если указать больше, перехват молча не срабатывает.
Чем заменить Askozia PBX сегодня?
Askozia больше не развивается. Её идеи продолжает MikoPBX — открытая АТС на Asterisk с веб-интерфейсом; также можно выбрать FreePBX или чистый Asterisk с конфигурацией из этой статьи.