Fax
MonoPbx envía y recibe fax por SIP. Los usuarios envían un PDF desde el cliente web y reciben los faxes por correo electrónico como PDF. El protocolo de fax T.30 se ejecuta en un proceso de motor independiente (mpbx-faxd, basado en SpanDSP), por lo que nada de él se enlaza dentro del PBX.
Instalar el motor de fax
El motor se distribuye como su propia imagen y comparte la red del contenedor del PBX, porque allí se enlazan los puertos de medios que el PBX asigna a una llamada de fax.
# 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 define por usted los tres ajustes [fax] del PBX:
| Ajuste | Variable de entorno | Significado |
|---|---|---|
engine | MPBX__FAX__ENGINE | tcp://127.0.0.1:7310 (el puerto de control del motor, solo en loopback, sin autenticación) o la ruta absoluta del programa del motor. |
spool | MPBX__FAX__SPOOL | Directorio compartido con el motor para las páginas recibidas y los documentos por enviar. |
media_ip | MPBX__FAX__MEDIA_IP | Dirección en la que el motor enlaza sus medios; debe ser accesible desde el relé de medios. |
El PBX también necesita configurados su pila SIP y el almacenamiento de archivos (los PDF se guardan en el almacén de archivos de la empresa). El motor puede iniciar después del PBX: el PBX sigue reintentando y comprueba el motor cada 10 segundos. Mientras el motor está caído, los faxes en cola esperan en lugar de fallar, y las llamadas de fax entrantes se rechazan. La métrica mpbx_fax_engine_up vale 1 mientras el motor responde y 0 mientras está caído; mpbx_fax_engine_restarts_total cuenta las reconexiones. Configure una alerta para mpbx_fax_engine_up == 0 durante más de unos minutos.
El motor se ejecuta sin ninguna capacidad, con un sistema de archivos de solo lectura, 256 MB de memoria y una CPU. Atiende como máximo 16 llamadas simultáneas, de 30 minutos y 200 páginas cada una, y 64 MB por documento.
Líneas de fax
En Administración, Líneas de fax agregue una línea por cada número de fax:
- Número: el número
+E.164. Debe ser un DID de una de las troncales de la empresa, porque el motor de fax contesta las llamadas entrantes a ese número. Un número puede pertenecer a una sola línea. - Enviar a: hasta 10 direcciones de correo; cada una recibe todos los faxes de esta línea.
- T.38 y Respaldo G.711: vea la sección siguiente.
- Habilitada: una línea deshabilitada no se contesta.
Un usuario que puede enviar faxes (permiso fax:write) usa Fax en el cliente web: escribe el destino, elige un PDF (hasta 10 MiB) y lo envía. La lista muestra los faxes que envió el usuario; un administrador ve todos los faxes de la empresa. Cada fax con documento tiene un botón Descargar, y un fax en cola se puede cancelar. Los usuarios comunes no tienen permiso de fax hasta que un administrador otorgue fax:read o fax:write a un rol.
T.38 o G.711
- El paso directo de G.711 (audio) funciona con cualquier operador que mantenga el audio limpio: sin cancelación de eco, sin trucos de búfer de jitter, sin transcodificación. Tarda más en iniciar y es sensible a la pérdida de paquetes.
- T.38 envía el fax como paquetes de datos (UDPTL) y tolera mucho mejor la pérdida de paquetes. Requiere una troncal compatible con T.38. El PBX ofrece T.38 mediante un re-INVITE cuando la línea lo permite y el otro lado lo anuncia, y nunca sobre tramos SRTP o WebRTC.
Con ambas opciones activadas (el valor predeterminado), el PBX prueba primero T.38 y recurre a G.711 cuando el operador lo rechaza o no responde al re-INVITE. Desactive el Respaldo G.711 solo cuando el operador garantice T.38; entonces un rechazo hace fallar el fax con t38_refused. Desactive T.38 para un operador que responde mal al re-INVITE. Los faxes salientes se marcan mediante el plan de marcación normal como el usuario que envía, por lo que se aplican las reglas contra fraude telefónico y de salida.
Límites
| Qué | Límite |
|---|---|
| Documento | PDF, máximo 10 MiB (de lo contrario MPBX-FAX-DOCUMENT-INVALID) |
| Resolución | El PDF se rasteriza a 204 x 196 dpi, en blanco y negro (umbral) |
| Páginas por fax | 200 |
| Duración de la llamada | 30 minutos |
| Llamadas en paralelo | 16 por motor |
| Reintentos | 3 intentos, separados 5 y 15 minutos, para ocupado, sin respuesta y errores de línea; los fallos que un reintento no puede corregir (documento inválido, sin modo común, T.38 rechazado) fallan de inmediato |
| Almacenamiento | Los faxes cuentan contra la cuota de almacenamiento de fax de la empresa; un fax recibido que exceda la cuota se rechaza |
Conservación
El PDF de cada fax terminado (enviado y recibido) se conserva 365 días de forma predeterminada y luego se elimina; el fax permanece en el historial con una nota de que su documento ya no existe (MPBX-FAX-DOCUMENT-GONE). Defina MPBX_FAX_RETENTION_DAYS para otro valor predeterminado de toda la instalación (0 conserva todo). Un administrador de la empresa puede definir su propio periodo en Voz y multimedia, Líneas de fax, en el formulario Conservación de documentos (de 1 a 3650 días; 0 conserva todo para esa empresa; vacío sigue el valor predeterminado de la instalación). Las eliminaciones se cuentan en el registro de auditoría. Las descargas del PDF de un fax también se auditan.
Entrega por correo
Un fax recibido se convierte en un solo PDF, se guarda en el almacén de archivos de la empresa y se envía por correo a cada dirección de la línea, con el PDF adjunto y el número del remitente, las páginas y la hora en el texto. El correo sale mediante la configuración de correo de la empresa. Si el proveedor de correo está caído, el fax no se pierde: se guarda y aparece como entregado con la nota mail_failed, y los usuarios lo descargan desde el cliente web. Cada fax recibido genera el evento fax.received, cada uno enviado fax.sent y cada fallo fax.failed; suscríbase con un webhook o con el WebSocket de eventos.
Solución de problemas
| Síntoma | Qué revisar |
|---|---|
| Los faxes permanecen en cola | mpbx_fax_engine_up vale 0: revise docker compose ps y los registros del motor; vea MPBX-FAX-ENGINE-UNAVAILABLE. Un fax con hora de reintento espera hasta ella. |
| La llamada entrante no se contesta como fax | El número debe coincidir exactamente (+E.164) con una línea habilitada y ser un DID de una troncal de la misma empresa. |
Falla con t38_refused o no_t38_media | El operador no admite T.38: permita el respaldo G.711. |
Muchos t30_timeout o páginas distorsionadas en G.711 | Pérdida de paquetes o procesamiento de audio en la ruta. Use T.38, desactive la cancelación de eco y los códecs distintos de PCMU/PCMA en la troncal, y asegúrese de que media_ip sea accesible desde el relé de medios. |
Falla con rasterize_failed o document_error | El PDF está dañado o protegido con contraseña. Imprímalo en un PDF nuevo y envíelo de nuevo. |
| Fax recibido pero sin correo | Revise la configuración de correo de la empresa; el fax muestra mail_failed. El PDF sigue en la lista. |
| La descarga dice que el documento ya no existe | La conservación lo eliminó. |
La prueba de que toda la ruta funciona es la prueba de loopback deploy/faxd/tests/e2e.sh: envía un PDF como usuario, lo rasteriza y lo transmite a través de dos motores reales, lo recibe en una segunda línea y verifica el PDF almacenado, los correos, los eventos y la descarga. Las pruebas con un fax físico real o con T.38 de un operador se hacen en su laboratorio.
En la consola
Abra Voz y multimedia, Líneas de fax (/admin/fax-lines). Necesita settings:read para ver la página y settings:write para modificarla.
- Agregue una línea de fax, edite una (nombre, número, destinatarios de correo, T.38, respaldo G.711 y si la línea contesta llamadas) o elimínela.
- El formulario Conservación de documentos define cuánto tiempo se conserva el PDF de un fax terminado. El fax en sí permanece en el historial.