VoIP.Mor — integración solo-lectura com o sistema externo de tarifación VoIP MOR
Esta wiki cubre el módulo VoIP.Mor de Quaza: la integración que permite consultar usuarios SIP, saldos y llamadas que corren en el servidor MOR (Magnificent Open Router) — um sistema externo de tarifación VoIP. Importante: la integración es solo lectura. Quaza no crea usuarios ni altera saldos — solo trae datos del banco del MOR para mostrar en las pantallas. Audiencia: proveedores que ofrecen telefonía VoIP tercerizada vía MOR y necesitan consultar datos de los clientes dentro de Quaza. Atención: esta funcionalidad asume integración con MOR (kolmisoft) específica de Brasil; revisá tu instalación.
Resumen en una línea: VoIP.Mor es un módulo de consulta al banco MOR (sistema externo de tarifación VoIP). Quaza accede al banco del MOR vía una conexión separada (config.php → connection['mor']), lee las tablas users e calls, y muestra usuarios SIP + saldos + historial de llamadas dentro de Quaza. Todo lo que crea/cobra/termina llamada se hace en el propio MOR — Quaza solo observa. Si la conexión cae, las pantallas quedan vacías.
VoIP.Mor ≠ Telefonía nativa. Quaza tiene un módulo separado de
Telefonia
propio (VoIP/MVNO interno). VoIP.Mor es específicamente
integración con sistema EXTERNO MOR. No confundas — son funcionalidades independientes.
Por qué existe la integración con MOR
Algunos proveedores ofrecen telefonía VoIP a los clientes pero no quieren operar la tarifación dentro de Quaza. En vez de eso, usan el MOR (Magnificent Open Router) — un sistema open-source / comercial específico para VoIP que hace ruteo, tarifación por destino, prepago/pospago, etc. El MOR está en otra máquina, con su propio banco de datos.
El cliente del proveedor crea cuenta en el MOR (vía otro camino — aprovisionamiento externo, integración separada) y usa el softphone/ATA para llamar. El MOR cobra. Pero el equipo de atención y financiero del proveedor usa Quaza en el día a día — necesita ver saldo, ver llamadas, identificar problemas. Ahí entra el módulo VoIP.Mor: lee el banco del MOR y muestra dentro de Quaza.
| Qué hace el MOR |
Qué hace Quaza (VoIP.Mor) |
| Rutea llamadas SIP |
No involucrado |
| Cobra por minuto / por destino |
Solo consulta el saldo resultante |
| Aprovisiona usuarios SIP |
No crea — solo lista los existentes |
| Mantiene CDR (historial de llamadas) |
Lee el CDR para mostrar historial |
| Tarifa prepago y pospago |
Muestra qué modalidad usa cada user |
| Aplica tarifas y descuentos |
Muestra tarifa configurada por user |
Glosario
| Termo |
O que é |
| MOR |
Magnificent Open Router — sistema externo de VoIP/tarifación. Quaza se conecta a su banco para consulta. |
| Usuario VoIP / SIP user |
Cuenta registrada en el MOR (username + contraseña + saldo + tarifa + tipo). Es lo que el cliente usa para autenticar en el softphone/ATA. |
| Saldo |
Crédito disponible (prepago) o límite de crédito (pospago). Actualizado en tiempo real por el MOR según las llamadas suceden. |
| Tarifa |
Tabla de precios por destino (R$/min o Gs/min). Define cuánto cuesta cada minuto para cada destino (Brasil fijo, celular, internacional, etc). |
| Período de cobranza |
Ciclo de cierre (mensual/semanal) usado en pospago. |
| CDR (Call Detail Record) |
Registro de llamada — origen, destino, duración, costo. Cada llamada genera un CDR en el banco del MOR. |
| Template |
Modelo de configuración reutilizable (tarifa default, modalidad, idioma) usado para crear nuevos usuarios en el MOR de forma estandarizada. |
| Conexão MOR |
Configuración técnica en config.php — connection id mor apuntando al banco MySQL/PostgreSQL del MOR externo. |
| Prepago |
Cliente recarga antes; llamadas debitan hasta llegar a cero. |
| Pospago |
Cliente llama durante el mes; recibe factura al final. |
| Aprovisionamiento |
Creación de usuario SIP en el MOR. NO se hace por Quaza — va por otro camino (script externo, panel admin del MOR, integración aparte). |
Flujo general — llamada → tarifación → consulta
CLIENTE MOR (sistema externo) QUAZA (VoIP.Mor)
(softphone) |
| | |
| 1. Marca número | |
|------------------------->| |
| (SIP INVITE) | |
| | 2. MOR autentica |
| | usuario (saldo > 0?) |
| | Rutea llamada |
| | |
| 3. Conversación corre | |
|<------------------------>| |
| | |
| 4. Termina llamada | |
|------------------------->| |
| | 5. MOR calcula costo |
| | Debita del saldo |
| | Graba CDR en "calls" |
| | Actualiza "users.saldo" |
| | |
| OPERADOR (financiero/ | |
| soporte del proveedor) | |
|-------------------------------------------------------->
| 6. Abre Quaza → VoIP.Mor → Usuario |
| | |
| | 7. SELECT * FROM users |
| |<---------------------------|
| | (vía connection "mor") |
| |--------------------------->|
| | | 8. Muestra lista
| | | Usuario | Saldo
| | | 1234 | R$ 12,50
| | | 5678 | R$ 0,00
| | |
| | | 9. Operador hace clic
| | | en un usuario
| | | para detalles
| | 10. SELECT llamadas |
| |<---------------------------|
| | de "calls" del user |
| |--------------------------->|
| | | 11. Historial
| | | - 5min para 21988887777
| | | - R$ 0,50
Leé el diagrama: la llamada sucede enteramente entre Cliente y MOR — Quaza no está en ese camino. Solo después, cuando alguien del equipo del proveedor abre Quaza, es que él consulta el banco del MOR para mostrar los datos. Por eso la integración es "solo lectura".
Prerrequisitos
-
Servidor MOR funcionando con banco accesible por la red de Quaza (firewall liberado).
-
Credenciales de banco del MOR (host, porta, user, password) — recomendado un usuario solo lectura para evitar accidentes.
-
Configuración em
config.php de Quaza:
'connections' => [
'mor' => [
'host' => '10.0.0.50',
'port' => 3306,
'database' => 'mor',
'username' => 'quaza_readonly',
'password' => 'xxxxxxxx',
],
],
-
Permiso en Quaza para los usuarios que van a acceder la pantalla VoIP.Mor (ACL).
Pantallas del módulo
| Pantalla |
Caminho |
Qué hace |
| Usuario VoIP.Mor |
VoIP.Mor → Usuario |
Lista los usuarios SIP registrados en el MOR. Muestra código, username, saldo, tarifa, tipo (pré/pós), idioma. Puede editar datos de registro que quedan solo en Quaza (vínculo a cliente). |
| Configuración VoIP.Mor |
VoIP.Mor → Configuración |
Singleton — parámetros financieros locales del proveedor (días hasta vencimiento de factura, valor mínimo de cobranza PF/PJ, descripción default). |
| Template |
VoIP.Mor → Template |
Modelos para crear usuarios (tarifa default, tipo, idioma). No crea en el MOR — solo ayuda estandarización en Quaza para contexto. |
| Log VoIP.Mor |
VoIP.Mor → Log |
Registro de operaciones que Quaza hizo (generalmente accesos / consultas). Útil para debug. |
Botones típicos en la caixa-maneira
| Botão |
Qué hace |
| Ver cliente |
Abre el registro del cliente Quaza vinculado a ese usuario VoIP (si hay vínculo). |
| Historial de llamadas |
Lista CDRs del usuario (llamadas recientes con duración y costo). |
| Editar (datos locales) |
Permite ajustar campos que quedan en el banco de Quaza (ej: vínculo con Cliente, observaciones). NO altera nada en el MOR. |
Integraciones y limitaciones
Lo que VoIP.Mor SE INTEGRA
| Sistema |
Tipo de integración |
| MOR (banco externo) |
Conexión MySQL/PostgreSQL configurada em config.php → connections.mor. Tablas usadas: users (registro de SIP users) e calls (historial de llamadas). |
| Cliente Quaza
|
Vínculo opcional — un usuario VoIP.Mor puede estar asociado a un cliente Quaza para rastreo. |
Lo que VoIP.Mor NO hace
1. No crea usuarios en el MOR. Para registrar un cliente nuevo en el MOR, va por el panel admin del propio MOR o por un script de aprovisionamiento externo. Quaza solo consulta.
2. No altera saldo. Recarga de saldo, ajuste manual, devolución — todo directo en el MOR.
3. No hace cobranza automática. Cobrar a factura mensal pospago dos clientes no sucede vía VoIP.Mor — necesitás exportar del MOR (reporte) y registrar manualmente en
cuenta a pagar/cobrar
do Quaza.
4. No sincroniza con Telefonía nativa. Si usás también el módulo
Telefonia
nativo de Quaza, él es completamente separado — otra base, otras pantallas, otros usuarios.
5. No rutea llamadas. Quaza no actúa en el camino de la llamada SIP. Todo es MOR.
Trampas frecuentes
1. Conexión MOR caída = todas las pantallas vacías. Si la conexión con el banco del MOR cae (firewall, banco fuera, credencial inválida), las pantallas muestran lista vacía sin mensaje de error claro. Antes de reportar como bug, verificá si el MOR está accesible: mysql -h MOR_HOST -u USER -p desde el servidor Quaza.
2. Saldo mostrado puede estar desactualizado. El saldo se lee en el momento de la consulta. Si el cliente está en llamada ACTIVA mientras consultás, el saldo real es menor al mostrado (va debitando segundo a segundo). No dependas del número para decisiones críticas en tiempo real.
3. Solo lectura — click en "Editar" no cambia MOR. Los botones "Editar" de las pantallas alteran solo campos LOCALES en Quaza (vínculo con cliente, observaciones). Para cambiar tarifa, modalidad o saldo en el MOR, andá al panel del MOR.
4. Cobranza de la factura VoIP es manual. No hay generación automática de cobranza a partir del consumo VoIP del MOR. Exportá del MOR al final del mes, registrá en Quaza como cuenta a cobrar.
5. Aprovisionamiento de novos usuarios é OUTRA história. Cliente nuevo de VoIP necesita SIP user creado en el MOR. Quaza no hace eso. Tené un proceso definido (script, panel MOR, equipo técnico) para esa parte.
6. Performance malo con base MOR grande. Tabela calls en proveedores antiguos puede tener millones de líneas. Listar sin filtro queda lento. Siempre filtrá por usuario o período corto.
7. Versión del MOR importa. Existen varias versiones del MOR (antiguo Magnificent Router, kolmisoft MOR, forks). La integración asume estructura estándar (users, calls). Si la versión usa nombres diferentes, la integración se rompe.
FAQ
¿Qué es MOR?
MOR = Magnificent Open Router — un sistema VoIP open-source/comercial bastante usado por proveedores para rutear/tarifar llamadas SIP. No es de Quaza — es un software de terceros (kolmisoft.com). Quaza solo lee su banco.
¿Quaza sustituye al MOR?
No. Si querés parar de usar MOR, considerá el módulo Telefonia nativo
do Quaza (que hace tarifación propia) — pero es un proyecto separado. VoIP.Mor es solo consulta, no es alternativa al MOR.
¿Puedo crear un usuario SIP por Quaza?
No. Registro de SIP user es directo en el MOR (panel admin del MOR o script). Quaza solo lee después.
¿El saldo que Quaza muestra es confiable?
Sí, en el momento de la consulta. Pero si el cliente está llamando ahora, el saldo real disminuye en tiempo real — Quaza no refleja eso instantáneamente.
¿Cómo integrar la cobranza VoIP en la facturación de Quaza?
Hoy, manualmente: exporta reporte de consumo do MOR (por cliente, en el mes), y registralo como conta a receber
en Quaza para cada cliente. Podés automatizar con script SQL/cron, pero no viene listo.
¿El log muestra historial de qué?
Operaciones que Quaza hizo (accesos a las pantallas VoIP.Mor, ediciones locales). No es el CDR — CDR está en el banco del MOR.
¿Y si el equipo técnico tira abajo el MOR para mantenimiento?
Las pantallas Quaza VoIP.Mor quedan vacías durante el mantenimiento. No se puede trabajar en ellas — esperá que el MOR vuelva.
¿Puedo usar Quaza con otro sistema VoIP que no sea MOR?
No con el módulo VoIP.Mor — él es específico del MOR. Para otro sistema (FreeSWITCH custom, Asterisk com tarifação própria, etc.), sería necesario desarrollo custom de integración. Considerá usar el módulo Telefonia nativo
en paralelo.
¿Versión del MOR soportada?
Quaza asume estructura estándar (kolmisoft MOR — tablas users, calls con schema clásico). Versiones muy antiguas o forks con schema modificado pueden romperse. Probá antes de pasar a producción.
¿Hay forma de sincronizar usuario Quaza ↔ usuario MOR automáticamente?
No nativamente. Vos vinculás manualmente — editás el usuario VoIP.Mor en Quaza y vinculás a un cliente Quaza por CPF/CNPJ o ID.
Documentos relacionados