Shkerka.ruзаметки админа
Asterisk и IP-АТС

Настройка fax-to-email и email-to-fax в Askozia PBX

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция Shkerka.ru

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

  1. В разделе учётных записей откройте Факс и создайте виртуальный факс: внутренний номер, отображаемый номер (АОН) и адрес, на который приходят входящие факсы.
  2. Заполните параметры отправки: адрес POP3-сервера, ящик для заданий на отправку, логин и пароль.
  3. Укажите доверенные адреса — только письма с них принимаются к отправке. Без этого списка ваш факс сможет использовать любой, кто узнает адрес ящика.
  4. Настройте SMTP-клиент в разделе почты и отправьте тестовое письмо из интерфейса.
  5. Направьте входящий номер факса на созданный виртуальный факс.

Историю и статусы отправки показывает раздел Архив факсов. Очередь исходящих заданий лежит в /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 с конфигурацией из этой статьи.