Telefonia — VoIP Fixa e Móvel (MVNO)
El módulo
Telefonia de Quaza gestiona os
serviços de voz que el provedor ofrece además de internet:
-
Telefonia Fija (VoIP) — números fijos en el estándar SIP que corren sobre la red de datos (Tip, SaperX, Magnus Billing, Summit)
-
Telefonia Móvil (MVNO) — operador virtual que revende chips celulares con seu marca (Brazmóvel, Tá Telecom, Bora, DryTelecom, Gertel)
Esta wiki cobre
registros (integradores, planes, números, usuários, chips),
operação (CDR, grupos) e
faturación (importación periódica de os integradores → mensalidade do cliente).
Visão geral — arquitectura do módulo
La telefonia en Quaza tem tres capas: registro, operação y cobrança. Todo gira alrededor do Integrador, que es el puente entre el gateway externo (Tip, Brazmóvel, etc.) y Quaza.
┌──────────────────────────────────────────────────────────────────────┐
│ GATEWAYS EXTERNOS (operadoras) │
│ Tip / SaperX / Magnus (VoIP fija) · Brazmóvel / Tá Telecom (MVNO)│
└──────────────────────────────────────────────────────────────────────┘
↓ (API/FTP/banco) ↑ provisionamiento
┌──────────────────────────────────────────────────────────────────────┐
│ INTEGRADOR (Quaza) │
│ config gateway · día corte · forma importación CDR · empresa fiscal │
└──────────────────────────────────────────────────────────────────────┘
↓ ↓ ↓
PLAN USUARIO NÚMERO
(tarifa, (extensión SIP / (DID — teléfono
franquicia) línea MVNO) público)
↕
TARJETA SIM
(solo MVNO)
↓ ↓ ↓
┌──────────────────────────────────────────────────────────────────────┐
│ CDR (Call Detail Record — uma línea por llamada) │
│ origen · destino · duración · tarifa · costo · valor · fecha/hora │
└──────────────────────────────────────────────────────────────────────┘
↓ (consolidación mensual)
┌──────────────────────────────────────────────────────────────────────┐
│ FACTURACIÓN (mensual por usuário/plan) │
│ minutos LC/LDN/LDI/VC + valor minutaje + franquicia + total │
└──────────────────────────────────────────────────────────────────────┘
↓
FINANCIERO (mensalidade do cliente)
→ boleto única con Internet + Telefonia
Por que existen dos "Números"? Quaza tem telefonia-numero (fijo) y telefonia-numeromvno (móvil) porque las enums de gateway son diferentes: el fijo solo acepta gateways de VoIP (Tip, SaperX, Magnus, Summit) y el MVNO solo acepta operadoras móviles. Misma estructura, telas separadas — facilita la operação.
Glossário
Conceptos fundamentales
| Termo |
Significado |
Onde aparece |
| VoIP |
Voice over IP. Llamada de voz que circula por internet usando el protocolo SIP (telefonia fija moderna). |
Integrador (tipo fija), Usuário SIP |
| MVNO |
Mobile Virtual Network Operator. Operadora móvil virtual — revendes chips de uma operadora real (Vivo/Claro/Tim/Personal/Tigo) con tu marca. |
Integrador (tipo MVNO), Chip SIM, Número MVNO |
| SIP |
Session Initiation Protocol. Protocolo que crea/cierra llamadas VoIP. Cada Usuário SIP es uma "extensión" en el gateway. |
Usuário (Fijo): campos usuário + senha |
| DID |
Direct Inward Dialing. Número público que suena directo en la extensión SIP do cliente. En Quaza es el registro "Número". |
Número (Fijo) |
| ICCID |
ID único do chip físico (impreso en la placa do SIM card). No cambia incluso si el número se porta. |
Chip SIM (MVNO) |
| Portabilidade |
Migración do número entre operadoras (cliente cambia de provedor manteniendo el número). |
Número (Fijo) → flag portado; Chip SIM → situaçãoPortabilidade
|
| CDR |
Call Detail Record. Uma línea por llamada — origen, destino, duración, tarifa, costo. Es la materia prima da faturación. |
Extracto CDR (importado de os gateways) |
| Franquicia |
Paquete de minutos prepagos en el plan (ej: 100min LC incluidos). Lo que exceda se cobra por minuto. |
Plan: minutosLc/LDN/LDI/VC
|
| Cadencia |
Tiempo mínimo cobrado / múltiplo de cobrança. Estándar Anatel: 60/6 (mín 60s, depois cobra cada 6s). |
Plan: cadenciaLc/LDN/...
|
Tipos de llamada (siglas Anatel)
| Sigla |
Tipo de llamada |
Exemplo |
| LC |
Local — misma área DDD/característica |
SP→SP (11→11) |
| LDN |
Larga Distancia Nacional |
SP→RJ (11→21) |
| LDI |
Larga Distancia Internacional |
PY→Argentina |
| VC1 |
Móvil local (celular mismo DDD) |
AS fijo → AS celular |
| VC2 |
Móvil regional (misma región) |
AS → CDE celular |
| VC3 |
Móvil nacional fuera da región |
AS → Encarnación celular |
Por que separar VC1/VC2/VC3? Anatel/Conatel definieron tarifas máximas diferentes para cada tipo. El plan permite franquicia y tarifa específicas, y el CDR se clasifica automáticamente por el gateway de origen.
Gateways soportados
| Gateway |
Tipo |
Forma de integración |
| Summit |
VoIP fija |
API HTTP |
| Tip |
VoIP fija |
WebService + FTP (importación CDR) |
| SaperX |
VoIP fija |
API HTTP |
| Magnus Billing |
VoIP fija |
Acesso directo al banco MySQL |
| Tá Telecom |
MVNO |
API HTTP (provisionamiento + CDR) |
| DryTelecom |
MVNO |
API HTTP |
| Bora |
MVNO |
API HTTP |
| Brazmóvel |
MVNO |
API HTTP (envío en lote) |
| Gertel |
MVNO |
API HTTP |
1. Integrador — configuração do gateway
Caminho: Telefonia → Integradores
O Integrador es la configuração técnica que conecta a Quaza con el gateway de telefonia. Sin integrador, nada funciona. Es lo primero a registrar.
Campos principales
| Campo |
O que é |
Atendimento |
| Descripción |
Nome interno do integrador |
Aparece en todos os relatórios. Usa nombre claro tipo "VoIP Principal" o "MVNO Personal" |
| Gateway |
O que operadora/provedor de telefonia (Tip, Brazmóvel, etc.) |
Define as opciones de número/plan que aparecen depois |
| Forma de Importación |
Como Quaza va a obtener os CDRs do gateway: API, WebService, FTP |
Depende do gateway. Tip = WebService + FTP, MVNO = API |
| Período Importación CDR |
Frecuencia: Diario / Semanal / Mensual |
Diario es el estándar. Mensual solo para gateways lentos |
| Día de Corte |
Día do mes donde la faturación "cierra" y empieza un nuevo ciclo |
Ej: día 25 — minutaje 26/abr a 25/may gera fatura de mayo |
| Día de Faturación |
Día en que el financiero se gera para el cliente |
Geralmente algunos días depois do corte |
| Valor Faturación |
Valor fijo cobrado al cliente por mes (independiente do uso) |
Común en MVNO: suscripción mensual do chip |
| Cod País / Cod Área |
Cód. internacional (595) y cód. de área principal do provedor |
Usado en el parser de números |
| Servidor/Usuário/Senha BD |
Acesso al banco do gateway (solo Magnus) |
Credenciales sensibles — usuário solo lectura |
| URL API / Cliente ID / Secret |
Credenciales OAuth da API do gateway |
Solicitar en el portal da operadora |
| Gerar Financieros |
Si la faturación gera mensalidade automática |
Apaga si quieres revisar antes de gerar |
Atenção: nunca registres dos integradores do mismo gateway con el mismo día de corte/faturación — Quaza pode confundirse y duplicar CDRs. Si precisas dos integradores Tip (ej: para empresas diferentes), usa empresas fiscales distintas.
2. Plan de Telefonia
Caminho: Telefonia → Planes
El Plan define franquicia + tarifas que se aplican al CDR para gerar la faturación. Es como el "plan de internet" do contrato, pero para voz.
Estructura de un plan
| Bloque |
Campos |
O que faz |
| Identificación |
Descripción, Código Integrador, Integrador |
Nome interno + código en el gateway (deve coincidir) |
| Valor Predeterminado |
Mensalidade base do plan (Gs.) |
Cobrado todos os meses incluso sin uso. Tipo "línea + 100min" |
| Franquicia (minutos) |
minutosLc, minutosLdn, minutosLdi, minutosVc1/2/3 |
Minutos incluidos por categoría — no se cobran |
| Mínimo (minutos) |
minimoLc, minimoLdn, ... |
Tiempo mínimo cobrado por llamada (ej: 30s = 0.5min) |
| Tarifa (Gs./min) |
tarifaLc, tarifaLdn, ... |
Valor por minuto excedente a la franquicia (hasta 6 decimales) |
| Cadencia |
cadenciaLc = "60/6" |
Mínimo / múltiplo. 60/6 = cobra mín 60s, depois cada 6s |
Leyendo la cadencia: formato min/mult. 60/6 significa "cobra al menos 60 segundos, depois agrega de 6 en 6". Uma llamada de 65s se cobra como 66s (60+6). Estándar Anatel es 60/6 — otras cadencias (30/30, 0/1) son acuerdo comercial específico.
Plan Ilimitado: algunos planes comerciales ofrecen minutos "ilimitados". En Quaza eso se traduce en franquicia muy alta (10.000min) + tarifa cero o en valorPadrao alto + franquicia que cubre uso normal. No há flag específica "ilimitado".
3. Número (Fijo)
Caminho: Telefonia → Números (Fijo)
O Número es el teléfono público (DID) que suena en la extensión SIP do cliente. Es el "número externo" — el que el cliente pone en la tarjeta de visita y que otros marcan para hablar con él.
Campos principales
| Campo |
O que é |
| Número |
Teléfono completo con cód. internacional+área (ej: 595212110001 = +595 21 211-0001) |
| Integrador |
Por que gateway se enruta ese número |
| Usuário |
Extensión SIP vinculada (1 número pode sonar en 1 extensión) |
| Cidade |
Ciudad da numeración (define cód. de área) |
| Reservado |
Sim = bloqueado para nuevas asignaciones (ej: número antiguo de cliente cancelado en cuarentena) |
| Portado |
Sim = vino de otra operadora (cliente trajo el número) |
| Fecha Liberación |
Quando el número quedó disponible para uso |
Reservado vs Vinculado: un número pode estar vinculado (campo Usuário lleno — en uso) o libre (campo Usuário vazio — disponible para asignar). El "Reservado=Sí" es uma tercera categoría: libre pero no deve asignarse — en cuarentena.
4. Usuário SIP (Fijo)
Caminho: Telefonia → Usuários (Fijo)
El Usuário es la extensión SIP que corre en la PABX/softphone do cliente. Tem usuário + senha SIP que el aparato usa para autenticar en el gateway VoIP.
Campos principales
| Campo |
O que faz |
| Usuário / Senha |
Credenciales SIP — configuradas en el aparato/softphone do cliente |
| Integrador / Plan |
Onde está registrado y como se tarifica |
| Contrato |
Vínculo con contrato do cliente (para cobrança) |
| Grupo |
Agrupamiento lógico (departamento, proyecto) |
| Limite |
Límite de crédito mensual — si lo supera, bloquea llamadas |
| Bloquea LC/LDN/LDI/VC1/VC2/VC3 |
Categorías bloqueadas (ej: bloquea LDI para evitar costo internacional) |
| Habilita BINA |
Identificación de chamada (CLID) — caller ID |
| Habilita Cobrar (cobrança revertido) |
Permite llamada por cobrar (collect call) |
| Usuário Transferencia |
A onde redirige si la extensión está ocupada/offline |
Trampa — bloqueo LDI por defecto: la mayoría de os provedores bloquea LDI (internacional) por defecto para evitar fraude de invasión SIP. El cliente que necesite llamar al exterior deve solicitar liberación explícita y el operador desmarca "Bloquea LDI" + define límite alto.
5. Chip SIM (MVNO)
Caminho: Telefonia → Chips (MVNO)
O Chip SIM es la tarjeta física que va en el celular do cliente. Cada chip tem ICCID único (grabado en el plástico) + un Número MVNO asociado + Plan.
Campos principales
| Campo |
O que é |
| ICCID |
ID único do chip (19-20 dígitos impresos en la tarjeta) |
| Usuário |
Usuário MVNO asociado (hace contrato con cliente) |
| Número |
Número MVNO activo en el chip (cód. internacional+área+9 dígitos) |
| Número Portado |
Si el cliente portó número de otra operadora, el número anterior queda aquí |
| Plano |
Plan MVNO en vigor (5GB, 10GB, ilimitado, etc.) |
| Situação |
Disponible / Activo / Suspendido / Cancelado |
| Situação Portabilidade |
Sin portabilidad / En curso / Esperando autorización / Concluida / Cancelada / Falla |
| Fecha Cancelamento |
Quando el chip fue cancelado (si aplica) |
Ciclo de vida do chip: Estoque (Disponível) → Vendido (Ativo, com número e cliente) → eventualmente Cancelado/Suspenso. A integração com a operadora MVNO faz o provisionamiento automático quando o chip muda de estado.
6. Número MVNO
Caminho: Telefonia → Números (MVNO)
O Número MVNO es el teléfono celular (cód. internacional+área+9 dígitos) asignado al chip. Tela espejo de Número Fijo, pero filtra solo gateways MVNO.
Por que tela separada? Conforme o glossário, no Quaza Número (Fijo) e Número MVNO são duas listagens do mesmo cadastro filtradas por tipo de gateway. Vantagem: evita misturar numeração fixa e móvel ao atribuir, e bloqueia ações inválidas (não dá pra colocar número fixo em chip MVNO).
7. Grupo de Telefonia
Caminho: Telefonia → Grupos
O Grupo es un agrupamiento lógico de usuários SIP — útil para relatórios ("cuánto gastó el equipo comercial?") y para reglas de enrutamiento avanzado.
| Campo |
O que é |
| Descripción |
Nome do grupo (Comercial, Atendimento, Suporte) |
| Código Integrador |
Código correspondiente en el gateway (si el gateway tem grupos propios) |
| Integrador |
En que integrador vive el grupo |
Uso típico: empresa con 50 extensiones crea 3 grupos (Comercial 25, Suporte 15, Directoría 10). En el relatório CDR pode ver gasto por grupo. En algunos gateways también permite reglas tipo "grupo X solo pode llamar a LC".
8. Faturación
Caminho: Telefonia → Faturación
O Faturamento consolida todos os CDRs de un mes por usuário, aplica franquicia/tarifa do plan y gera el valor a cobrar. Ese valor se convierte en mensalidade en el financiero do cliente.
Columnas do listado
| Columna |
O que mostra |
| Cliente / Contrato |
Cliente final vía Usuário→Contrato |
| Usuário |
Extensión SIP / línea MVNO |
| Faturado |
Sí/Não — si ya generó financiero |
| Mes Referencia |
Mes cerrado (ej: 04/2026) |
| Valor Minutaje |
Total do excedente (chamadas além da franquicia) |
| Valor Total |
Valor minutaje + valor predeterminado do plan |
Fluxo de geración
-
1CDR importado: Diariamente Quaza extrae do gateway as llamadas do día anterior
-
2Día de corte: En el día configurado en el Integrador, el cron CierreFaturacion consolida CDRs do ciclo (ej: 26/abr–25/may)
-
3Cálculo: Para cada usuário: suma minutos por categoría (LC/LDN/LDI/VC1-3) → resta franquicia → multiplica por la tarifa → valor minutaje
-
4Faturación creada: Linha en
telefoniaFaturamento con totales
-
5Día de faturación: En el día configurado, gera financiero (mensalidade) y marca Faturado=Sí
-
6Mensalidade do cliente: Aparece en la boleto consolidada junto con la internet
Atendimento — Faturado=No: se um faturamento ficar
Faturado=Não depois do dia de faturamento, significa que o cron falhou ou que
Gerar Financieros=Não no Integrador. Use "Importar Faturamentos" pra reprocessar ou gere manualmente em
Cliente → Financiero
.
Fluxos típicos passo-a-passo
Fluxo 1: Habilitar telefonia VoIP para nuevo cliente
| Passo |
Onde |
O que fazer |
| 1 |
Telefonia → Números |
Selecioner un número Libre + No Reservado da lista. Anotar el ID. |
| 2 |
Telefonia → Usuários (Fijo) |
Agregar usuário SIP: vincular al Contrato do cliente, elegir Plan, definir límite, dejar BloqueaLDI marcado. |
| 3 |
Telefonia → Números |
Editar el número elegido → vincular al Usuário creado. |
| 4 |
Gateway externo |
Confirmar que Quaza envió as credenciales vía API/WS. Si manual: criar usuário SIP en Tip/SaperX con mismo usuário/senha. |
| 5 |
Cliente |
Entregar credenciales (usuário SIP + senha + servidor + puerto) para configurar softphone/ATA/IP phone. |
| 6 |
Cliente hace prueba |
Llama desde otro teléfono al número; prueba origen (llamada saliente) — confirma que está autenticado. |
Fluxo 2: Vender chip MVNO nuevo
| Passo |
Onde |
O que fazer |
| 1 |
Telefonia → Números MVNO |
Verificar si há números libres do operador (Brazmóvel, etc.) |
| 2 |
Telefonia → Usuários (MVNO) |
Criar usuário MVNO: contrato cliente, Plan MVNO (5GB), límite |
| 3 |
Telefonia → Chip SIM |
Agregar chip: escanear ICCID, vincular Usuário, Número, Plan, situación=Activo |
| 4 |
API operadora |
Quaza envía activación. Si manual: portal Brazmóvel → activar ICCID |
| 5 |
Cliente |
Entrega física do chip + recibo con número y plan |
Fluxo 3: Portabilidad de número (cliente trae número de otra operadora)
| Passo |
Onde |
O que fazer |
| 1 |
Cliente |
Solicita portabilidad — proporciona número actual + CI/RUC + copia fatura anterior |
| 2 |
Quaza (manual fuera do sistema) |
Solicitar Conatel/ABR — protocolo de portabilidad — informando operadora donadora |
| 3 |
Telefonia → Chip SIM (MVNO) |
Registrar chip con situaciónPortabilidad = "En curso" |
| 4 |
Esperar 1-3 días hábiles |
Cuando ABR/Conatel apruebe, cambiar situaciónPortabilidad = "Concluida" |
| 5 |
Telefonia → Número (Fijo) |
Para portabilidad VoIP: marcar Portado=Sí en el número nuevo |
| 6 |
Cliente recibe SMS/email |
Operadora antigua corta el servicio; nueva operadora activa en < 2h |
Fluxo 4: Fin de mes — gerar fatura de telefonia
| Passo |
Onde |
Quién hace |
| 1 |
Cron diario |
Importa CDRs do día anterior do gateway (automático) |
| 2 |
Telefonia → Extracto CDR |
Operador verifica si la importación corrió (líneas con fecha de ayer) |
| 3 |
Día de corte llegó |
Cron CierreFaturacion consolida (automático) |
| 4 |
Telefonia → Faturación |
Operador revisa — todos os usuários activos tienen línea do mes? Alguno con valor cero? |
| 5 |
Día de faturación |
Cron gera financieros (automático) — Faturado=Sí |
| 6 |
Cliente
→ Financeiro |
Verifica que la mensalidade subió con el valor de telefonia |
Pegadinhas frequentes
1. Llamadas por cobrar se vuelven pérdida si "Habilita Cobrar" está activo por defecto
Si el cliente recibe muchas llamadas por cobrar (vendedores llamando), paga por as recibidas. Default seguro: dejar Habilita Cobrar=No y activar solo bajo pedido con contrato adicional.
2. Fraude SIP — invasión de senha débil
Senhas SIP cortas/obvias (1234, igual al usuário) son blanco de robots que invaden y hacen miles de llamadas internacionales en horas. Sempre usa senha aleatoria 16+ chars. Y mantén BloqueaLDI=Sí por defecto — pedido manual para liberar.
3. ICCID vs Número — no confundas
ICCID es do chip físico (no cambia). Número es el teléfono (pode portarse/cambiar). Busca por el ICCID cuando el cliente traiga el chip para cancelar, no por el número (cliente pode olvidar).
4. Importación CDR atrasada — verifica el cron
Si en la tela Extracto CDR solo aparece llamada antigua, el cron de importación está parado. Verifica
Tarefas Financieras
y logs do gateway. Importación manual por el botón "Realizar Importación" funciona para recuperar.
5. Faturación cero para usuário activo
Cliente llama reclamando: "mi telefonia no se está cobrando hace 2 meses!" — probablemente el usuário SIP se registró sin contrato, entonces no há cliente para cobrar. Solución: vincular contrato y ejecutar "Importar Faturaciones" en el mes.
6. Portabilidad falló — situaciónPortabilidad=Falla
Causas comunes: CI/RUC no coincide, dívida abierta en la operadora donadora, contrato en vigor (fidelidad), número no pertenece al CI/RUC informado. Cliente deve resolver con operadora antigua antes de intentar de nuevo.
7. Cadencia 60/6 vs 30/30 — confira contrato
Algunas operadoras venden con cadencia más agresiva (30/30 — cobra 30s y depois cada 30s, incluso si el cliente cuelga en 35s, cobra 60s). Verifica lo que está en el Plan antes de prometer al cliente — discrepancia gera reclamo.
Galeria de telas
Telefonia integrador
Telefonia plano
Telefonia numero
Telefonia usuario
Telefonia cartaosim
Telefonia numeromvno
Telefonia grupo
Telefonia faturamento
Documentos relacionados
Aprofunde-se nos temas conexos:
-
Cliente
— contrato do cliente, vinculación do usuário SIP/MVNO
-
Fibra e Rede
— telefonia VoIP usa la infraestructura de red do provedor (SIP sobre PPPoE/IPoE)
-
Estoque
— chips SIM físicos entran como producto de stock antes de ser vendidos
-
Suporte / OS
— atenciones relacionadas a llamada con problema, configuração SIP
-
SVA / NFeSVA
— telefonia pode venderse como SVA (servicio de valor agregado) con NFe específica
-
Painéis / Dashboards
— não tem alerta específica de telefonia hoy, pero faturaciones no cerradas poden gerar inconsistencia
-
Administração
— configuraciones, usuários, permisos (ACL), tarefas (crons) y logs de auditoria
-
Comunicação
— Email, SMS, WhatsApp y campañas masivas para clientes
-
Chat
— atención omnicanal en vivo (WhatsApp, bot, respuestas rápidas)
-
Portal / Área do Cliente
— autoatendimento do cliente final (2da vía, OS, dependientes, recomendaciones)
-
Mapa
— visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
-
Tarefas Financieras
— donde corren os crons de importación CDR + cierre faturación
FAQ
Quaza tem PABX propia? Puedo usar sin gateway externo?
Não — Quaza é o billing, não a PABX. A voz trafega pelo gateway externo (Tip, Magnus, etc.). Quaza só configura o provisionamiento e consome os CDRs pra cobrar.
Como veo o histórico de llamadas de un cliente específico?
Telefonia → Extracto CDR → use Filtros → idUsuário = ramal do cliente. Ou abra o usuário SIP → aba CDR.
Cliente cambió de plan a mitad de mes — como cobrar prorrateo?
Quaza no hace prorrateo automático de plan de voz. Geralmente el operador edita la Faturación do mes manualmente o usa el Plan nuevo a partir do próximo ciclo. Si es cobrança significativo, gerar suelta en Vendas
.
Chip MVNO desapareció da operadora — número desactivado sin aviso?
Operadoras móviles cancelan números inactivos > 90 días sin uso. Mantén chips de stock con al menos un "mantenimiento" mensual — o acepta la pérdida y retira do registro.
Existe relatório consolidado de minutos por mes?
Telefonia → Faturación → aba Relatórios. Permite agrupar por usuário, grupo, integrador, plano.
Puedo tener el mismo gateway con 2 empresas fiscales?
Sim — registra 2 integradores con mismo gateway, cada uno con idEmpresa diferente. Os planes/usuários quedan aislados por empresa para fines fiscales.
Quaza sabe quando uma llamada está en curso?
No en tempo real. Quaza recibe el CDR solo depois de terminar la llamada. Para monitoreo en tempo real, usa el portal do propio gateway (Magnus Billing tem dashboard en vivo).