Перейти к основному содержимому

Факс

MonoPbx отправляет и принимает факсы по SIP. Пользователи отправляют PDF из веб-клиента, а полученные факсы приходят по электронной почте в виде PDF. Протокол факса T.30 выполняется в отдельном процессе-движке (mpbx-faxd, на основе SpanDSP), поэтому в АТС ничего из него не встроено.

Установка факс-движка​

Движок поставляется в виде отдельного образа и использует сеть контейнера АТС, потому что медиапорты, которые АТС выделяет для факсового звонка, привязываются именно там.

# From deploy/compose/prod: start the PBX with the fax engine next to it.
docker compose -f compose.yaml -f compose.fax.yaml up -d
docker compose -f compose.yaml -f compose.fax.yaml ps

compose.fax.yaml задаёт за вас три параметра [fax] АТС:

ПараметрПеременная окруженияЗначение
engineMPBX__FAX__ENGINEtcp://127.0.0.1:7310 (управляющий порт движка, только loopback, без аутентификации) или абсолютный путь к программе движка.
spoolMPBX__FAX__SPOOLКаталог, общий с движком, для принятых страниц и документов на отправку.
media_ipMPBX__FAX__MEDIA_IPАдрес, на котором движок привязывает свои медиапотоки; он должен быть доступен с медиаретранслятора.

Для АТС также должны быть настроены стек SIP и файловое хранилище (PDF хранятся в файловом хранилище компании). Движок может запускаться после АТС: АТС продолжает повторные попытки и проверяет движок каждые 10 секунд. Пока движок недоступен, факсы в очереди ждут, а не завершаются ошибкой, а входящие факсовые вызовы отклоняются. Метрика mpbx_fax_engine_up равна 1, пока движок отвечает, и 0, пока он недоступен; mpbx_fax_engine_restarts_total считает переподключения. Настройте оповещение на mpbx_fax_engine_up == 0 дольше нескольких минут.

Движок работает без каких-либо привилегий (capabilities), с файловой системой только для чтения, 256 МБ памяти и одним процессором. Он обрабатывает не более 16 одновременных звонков, по 30 минут и 200 страниц каждый, и 64 МБ на документ.

Факсовые линии​

В разделе Администрирование, Факсовые линии добавьте по одной линии на каждый номер факса:

  • Номер: номер в формате +E.164. Он должен быть DID одной из транковых линий компании, потому что входящий звонок на него принимает факс-движок. Номер может принадлежать только одной линии.
  • Отправлять на: до 10 адресов электронной почты; каждый получает все факсы этой линии.
  • T.38 и Резерв G.711: см. следующий раздел.
  • Включена: выключенная линия не отвечает на звонки.

Пользователь, которому разрешено отправлять факсы (право fax:write), использует раздел Факс в веб-клиенте: вводит номер назначения, выбирает PDF (до 10 МиБ) и отправляет. В списке видны факсы, отправленные этим пользователем; администратор видит все факсы компании. У каждого факса с документом есть кнопка Скачать, а факс в очереди можно отменить. У обычных пользователей нет прав на факс, пока администратор не выдаст роли fax:read или fax:write.

T.38 или G.711​

  • Сквозная передача G.711 (аудио) работает у любого оператора, который сохраняет звук чистым: без эхоподавления, без манипуляций с джиттер-буфером, без транскодирования. Она дольше устанавливается и чувствительна к потерям пакетов.
  • T.38 передаёт факс как пакеты данных (UDPTL) и гораздо лучше переносит потери пакетов. Требуется транк с поддержкой T.38. АТС предлагает T.38 через re-INVITE, если линия это разрешает и другая сторона заявляет о поддержке, и никогда не предлагает его на участках SRTP или WebRTC.

При включённых обоих вариантах (по умолчанию) АТС сначала пробует T.38 и переходит на G.711, если оператор отказывает или не отвечает на re-INVITE. Отключайте Резерв G.711 только тогда, когда оператор гарантирует T.38; тогда отказ приводит к ошибке факса t38_refused. Отключите T.38 для оператора, который некорректно отвечает на re-INVITE. Исходящие факсы набираются по обычному плану набора от имени отправляющего пользователя, поэтому действуют правила защиты от телефонного мошенничества и правила исходящих вызовов.

Ограничения​

ЧтоОграничение
ДокументPDF, не более 10 МиБ (иначе MPBX-FAX-DOCUMENT-INVALID)
РазрешениеPDF растеризуется в 204 x 196 dpi, чёрно-белый (по порогу)
Страниц в факсе200
Длительность звонка30 минут
Параллельные звонки16 на движок
Повторные попытки3 попытки с интервалами 5 и 15 минут при занято, нет ответа и ошибках линии; сбои, которые повтор не исправит (неверный документ, нет общего режима, отказ T.38), завершаются ошибкой сразу
ХранилищеФаксы учитываются в квоте хранилища факсов компании; полученный факс сверх квоты отклоняется

Хранение​

PDF каждого завершённого факса (отправленного и полученного) по умолчанию хранится 365 дней, затем удаляется; факс остаётся в истории с пометкой, что его документа больше нет (MPBX-FAX-DOCUMENT-GONE). Задайте MPBX_FAX_RETENTION_DAYS, чтобы изменить значение по умолчанию для всей установки (0 хранит всё). Администратор компании может задать собственный срок в разделе Голос и медиа, Факсовые линии, в форме Хранение документов (от 1 до 3650 дней; 0 хранит всё для этой компании; пустое значение следует значению по умолчанию для установки). Удаления учитываются в журнале аудита. Скачивания PDF факса также попадают в аудит.

Доставка по почте​

Полученный факс преобразуется в один PDF, сохраняется в файловом хранилище компании и отправляется по почте на каждый адрес линии: PDF во вложении, номер отправителя, число страниц и время в тексте письма. Почта уходит через почтовые настройки компании. Если почтовый провайдер недоступен, факс не теряется: он сохраняется и отображается как доставленный с пометкой mail_failed, а пользователи скачивают его из веб-клиента. Каждый полученный факс порождает событие fax.received, каждый отправленный — fax.sent, каждая ошибка — fax.failed; подпишитесь через вебхук или WebSocket событий.

Устранение неполадок​

ПризнакЧто проверить
Факсы остаются в очередиmpbx_fax_engine_up равна 0: проверьте docker compose ps и журналы движка; см. MPBX-FAX-ENGINE-UNAVAILABLE. Факс со временем повтора ждёт этого времени.
Входящий звонок не принимается как факсНомер должен точно (+E.164) совпадать с включённой линией и быть DID транка той же компании.
Ошибка t38_refused или no_t38_mediaОператор не поддерживает T.38: разрешите резерв G.711.
Много t30_timeout или искажённые страницы на G.711Потери пакетов или обработка звука на пути. Используйте T.38, отключите эхоподавление и кодеки, кроме PCMU/PCMA, на транке и убедитесь, что media_ip доступен с медиаретранслятора.
Ошибка rasterize_failed или document_errorPDF повреждён или защищён паролем. Распечатайте его в новый PDF и отправьте снова.
Факс получен, но письма нетПроверьте почтовые настройки компании; у факса отметка mail_failed. PDF по-прежнему в списке.
При скачивании сообщается, что документа больше нетЕго удалило хранение.

Доказательство того, что весь путь работает, — тест с замыканием deploy/faxd/tests/e2e.sh: он отправляет PDF от имени пользователя, растеризует и передаёт его через два настоящих движка, принимает на второй линии и проверяет сохранённый PDF, письма, события и скачивание. Проверки с настоящим факсимильным аппаратом или T.38 оператора выполняются в вашей лаборатории.

В консоли​

Откройте Голос и медиа, Факсовые линии (/admin/fax-lines). Для просмотра страницы нужно право settings:read, для изменения — settings:write.

  • Добавляйте факсовую линию, изменяйте её (название, номер, получатели e-mail, T.38, резерв G.711 и отвечает ли линия на звонки) или удаляйте.
  • Форма Хранение документов задаёт, как долго хранится PDF завершённого факса. Сам факс остаётся в истории.