Portal — Área del Cliente (autoatención)
El Portal (o Área del Cliente, "AC") es el sitio/app que el cliente final accede para ver factura, obtener 2da vía de boleta, abrir OS, actualizar datos, pedir cambio de plan — sin necesitar llamar o enviar mensaje al proveedor.
Esta wiki cubre el módulo del lado del proveedor: cómo configurar el portal, qué menús liberar, personalizar colores/logo, crear notificaciones, y ver el historial del contratologin (login PPPoE/IPoE) que conecta el portal con la operación técnica.
Quién gana: la atención — una 2da vía de boleta automatizada ahorra decenas de llamadas por mes. Un portal bien hecho cubre 70%+ de las demandas básicas.
Visión general — dónde entra el cliente
CLIENTE FINAL (accede vía navegador / app)
↓
┌──────────────────────────────────────────────────────────────────────┐
│ PORTAL — Área del Cliente — proveedor.com.br/areacliente │
│ (hotsite separado, pero integrado a Quaza) │
├──────────────────────────────────────────────────────────────────────┤
│ Login: CI/RUC + contraseña (estándar = 4 primeros dígitos del CI) │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ MENÚ LATERAL (configurable por Admin de Quaza) │ │
│ │ • Mis datos • Facturas │ │
│ │ • Contratos • Notas fiscales │ │
│ │ • Financiero / Boletas • Solicitud │ │
│ │ • Órdenes de Servicio • Recomendaciones │ │
│ │ • Prueba de conexión • Dependientes │ │
│ │ • Desbloqueo temporal │ │
│ └────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────┘
↓ acción del cliente
┌──────────────────────────────────────────────────────────────────────┐
│ BACKEND QUAZA — sincroniza con el sistema operacional │
│ • Cliente hace clic "2da vía" → genera boleta/QR del financiero │
│ • Cliente hace clic "Abrir OS" → crea registro en Soporte │
│ • Cliente solicita troca de plano → cria contratoAcao "Solicitud" │
│ • Cliente edita datos → actualiza registro (Quaza valida y aplica) │
└──────────────────────────────────────────────────────────────────────┘
↓
Equipo operacional del proveedor
(atendentes ven solicitudes en Quaza)
Portal = autoservicio 24x7. Cliente accede a las 2h de la madrugada, obtiene 2da vía, paga vía QR, recupera login PPPoE — sin despertar a nadie. Los atendentes quedan liberados para casos que realmente necesitan humano.
Glosario
| Término |
Significado |
| Portal / Hotsite / Área del Cliente |
El sitio que el cliente final accede para autoatención. En el código aparece como "AC" (ac-hotsite, ac-menu, etc.) |
| ContratoLogin |
Registro del usuario PPPoE/IPoE — login + contraseña que el router/módem usa para conectar a la red. Un Contrato puede tener varios logins (TV, Fibra, etc.) |
| Tecnología (del login) |
Tipo: Fibra (PPPoE), TV (IPTV), Radio, etc. Define cómo el servicio se presta |
| Sesión |
Conexión activa del login con el concentrador. Cuando el cliente apaga el router, la sesión cierra |
| Consumo |
Tráfico de Upload/Download contabilizado por sesión (viene del RADIUS Accounting) |
| Desbloqueo temporal |
Cliente moroso que pide "libera por 3 días hasta que yo pague" — Quaza desbloquea automático |
| Solicitud |
Pedido hecho por el cliente en el portal (cambio plan, dirección, cancelación) — entra como contratoAcao |
| Hotsite Log |
Auditoría de todo lo que el cliente hace en el portal: páginas visitadas, IP, plataforma, navegador |
| Notificación al cliente |
Aviso que aparece dentro del portal cuando el cliente entra (mantenimiento, deuda, promoción) |
| Endpoint portal |
URL del portal (proveedor.com.br/areacliente). Configurada en Hotsite |
| Endpoint sistema |
URL de Quaza donde el portal busca datos vía API |
| App (Google Play / Apple Store) |
Aplicación móvil del portal (algunos proveedores publican app whitelabel) |
1. Configuraciones del Portal
Camino: Portal → Configuración
Pantalla única con pestañas que controla todo el comportamiento del portal: habilitar, contraseña estándar, contactos, app, tema, comportamiento de cliente y técnico.
Pestaña Principal
| Campo |
Qué hace |
| Habilitado |
Sí = portal accesible para los clientes. No = portal off |
| Contraseña estándar |
Lo que el cliente usa en el primer acceso. Estándar: 4 primeros dígitos del CI |
| Contacto |
Teléfono/WhatsApp que aparece en el pie del portal |
| Endpoint portal |
URL pública del portal (ej: areacliente.proveedor.com.br) |
| Endpoint sistema |
URL interna de Quaza (consumida por la API del portal) |
| Endpoint Google Play / Apple Store |
Enlace de la app móvil (si la hay) — aparece como botón "Descarga nuestra app" |
| Ícono del área del cliente |
Logo personalizado (upload) — sustituye el logo estándar |
Pestaña Cliente — comportamiento
| Campo |
Qué hace |
| Período Desbloqueo |
Cuánto tiempo el cliente bloqueado queda liberado (ej: 3 días) |
| Días Desbloqueo |
Cuántas veces por mes puede pedir desbloqueo |
| Días Intervalo Bono |
Tiempo mínimo entre solicitudes de bono de recomendación |
| Financiero Listado Estándar |
Cómo mostrar deudas: solo abiertas / abiertas+pagadas / todas |
| Intervalo Financiero Sistema |
Período exhibido por defecto (ej: últimos 90 días) |
| Financiero Imprimir Carnet |
Permite imprimir carnet completo (varias boletas) |
| Habilitar OS — Resolución / Problema |
Cliente puede abrir OS vía portal (categorías seleccionables) |
| Verificar Fecha Activación Contrato |
Cliente nuevo solo accede tras contrato activo |
| Pedir CI/RUC Factura |
Antes de mostrar boleta, cliente confirma CI/RUC |
| Exhibir Anexos OS |
Muestra fotos/PDFs adjuntados en las OS del cliente |
| Cartera Estándar (Boleta/QR/Tarjeta) |
Qué cartera se usa en las 2das vías generadas vía portal |
| Considera Cobro Existente |
No duplica cobro si ya tiene boleta válida |
| Habilitar Tarjeta Recurrente |
Permite al cliente guardar tarjeta para débito automático |
Pestaña Técnico
| Campo |
Qué hace |
| Cliente/Stock/OS Filtrar Técnico |
Técnico solo ve clientes/productos/OS suyas (no todo) |
| Permitir Remover ONU |
Técnico puede liberar ONU para reúso |
| Editar Datos Router |
Técnico puede cambiar IP, WiFi-SSID, contraseña del router vía portal técnico |
| Obligatorio Caja/Puerto Técnico |
OS técnica exige llenar Caja óptica + Puerto (trazabilidad) |
| Filtro Fijo OS |
Técnico solo ve OS del sector suyo |
Pestaña Tema (colores)
| Color |
Dónde aparece |
| Primary / Secondary |
Encabezado, botones principales, enlaces |
| Menu Text / Menu Hover |
Texto del menú lateral + color al pasar el mouse |
| Card Text / Card Bg / Card Hover |
Apariencia de los cards (cajas de factura, OS, etc.) |
Branding completo: con ícono personalizado + colores tema, el portal se vuelve "marca blanca" del proveedor — el cliente no ve "Quaza" en ningún lado. Bueno para coherencia visual con el sitio institucional.
Camino: Portal → Menú
Registra los ítems de menú que el cliente ve en el portal. Quaza trae ítems estándar (el cliente puede esconder) y permite crear ítems nuevos (enlaces externos, contenido institucional).
Filtros: Portal del cliente vs Portal del técnico
Quaza tiene dos portales:
-
Portal del cliente — usuario final, login con CI/RUC
-
Portal del técnico — equipo de campo, flujo de OS, ONU, señal óptica
Ítems estándar del Portal del Cliente
| Ítem |
Descripción |
Cuándo habilitar |
| Mis datos |
Cambiar contraseña, datos de registro |
Siempre |
| Contratos |
Impresión + aceptación electrónica |
Recomendado |
| Financiero |
2da vía boleta/QR/carnet |
Siempre (mais usado) |
| Notas fiscales |
NFe/NFSe emitidas (descarga) |
Siempre se provedor emite |
| Solicitud |
Cambio de plan, dirección |
Habilitar cuando haya flujo definido |
| Órdenes de Servicios |
Abrir y acompañar OS |
Siempre |
| Recomendaciones |
Recomendar amigos para ganar bono |
Programa de recomendación activo |
| Prueba de conexión |
Speedtest integrado |
Reduce reclamo de "internet lenta" |
| Dependientes |
Registrar familiares/empleados |
Según contrato |
| Facturas |
Lista de facturas detalladas |
Para contratos con más de 1 financiero/mes |
| Desbloqueio |
Cliente moroso libera 3 días |
Política comercial |
"Desbloqueo temporal" pode ser abusado: cliente usa repetidamente sem pagar. Configure em Días Desbloqueo: 1 vez por mês é razoável. Quem precisa de mais, atendente humano analisa caso.
3. Notificación al Cliente
Camino: Portal → Notificación
Avisos que aparecen dentro del portal cuando el cliente entra. Útil para anuncio de mantenimiento, promoción, recordatorio de datos faltantes.
Campos
| Campo |
Qué es |
| Cliente |
¿Para quién? Vacío = todos. Específico = solo ese cliente |
| Título |
Lo que aparece arriba (llamativo, corto) |
| Mensaje |
Cuerpo (soporta HTML simple + enlaces) |
| Prioridad |
Alta = popup obligatorio; Normal = campana; Baja = solo en la sección avisos |
| Agendamiento |
Cuándo aparecer (ej: 2026-05-15 a las 6h) |
| Estado |
Borrador / Agendada / Publicada / Cerrada |
Caso de uso típico: "Mantenimiento programado — 03/06/2026 de 2h a 4h" — enviar a todos los clientes de la región afectada, prioridad Alta, agendar para aparecer 24h antes. Quien entre al portal ese día ve el aviso y no abre OS.
4. Log de accesos (Hotsite Log)
Camino: Portal → Log
Auditoría de cada clic del cliente en el portal: qué página visitó, qué evento disparó, IP, plataforma, navegador.
Columnas
| Columna |
Qué muestra |
| Fecha/Hora |
Timestamp de la acción |
| Cliente |
Quién hizo (registro) |
| Página |
En qué pantalla del portal estaba (financiero, contrato, etc.) |
| Evento |
Acción: "generar 2da vía", "abrir OS", "imprimir contrato" |
| Valor |
Parámetro relevante (ej: id de la OS, valor de la boleta) |
| IP |
IP de origen (trazabilidad jurídica) |
| Plataforma / Navegador |
Desktop/Mobile/Tablet + Chrome/Safari/Firefox |
Uso en fraude/disputa: cliente reclama "alguien entró en mi cuenta y cambió mi dirección". Hotsite log muestra IP + plataforma de la acción. Si fue de IP extraño, puede ser invasión — bloquea portal, fuerza cambio de contraseña, genera alerta.
5. Usuario/ContratoLogin
Camino: Cliente → Usuario
Registro del login de conexión — lo que el cliente usa para autenticar en el router (PPPoE / IPoE). Es el vínculo entre cliente comercial y cliente técnico (red).
Estructura
CLIENTE (registro comercial)
↓ tem N
CONTRATO (vínculo comercial)
↓ tem N
CONTRATOLOGIN (login PPPoE/IPoE)
├─ Tecnología: Fibra | TV | Radio | ...
├─ Usuario + Contraseña PPPoE (va en el router)
├─ Grupo: define plan de velocidad (vinculado a RADIUS)
├─ Dirección IP fija (si aplica)
├─ MAC del equipamiento
└─ Estado: Activo | Bloqueado | Cancelado | Pre-registro
Campos principales
| Campo |
Qué es |
| Cliente |
Dueño del login |
| Login (usuario PPPoE) |
String que va en el router (ej: cliente.silva) |
| Contraseña |
Hash (no aparece — solo editar) |
| Tecnología |
Fibra, TV, Radio, Hotspot |
| Grupo |
Plan de velocidad (300MB, 1GB, etc.) |
| Dirección IP |
Si el cliente tiene IP fijo, queda aquí |
| MAC |
Mac address del equipamiento (autenticación IPoE) |
| Estado |
Activo (conecta), Bloqueado (rechaza), Cancelado, Pre-registro |
| Concentrador |
En qué BRAS/OLT vive ese login |
| Punto de acceso |
Caja óptica / sector |
6. Historial de alteraciones
Camino: Cliente → Historial de Usuario
Audit trail completo de los cambios en el login: quién cambió contraseña, quién cambió grupo (plan), quién alteró MAC.
Clasificadores típicos
| Clasificador |
Cuándo aparece |
| Alteró |
Cualquier cambio en campo del login |
| Bloqueó |
Bloqueo manual o automático (cron de morosidad) |
| Liberó |
Liberación (manual o vía desbloqueo temporal del portal) |
| Cambió contraseña |
Reset de contraseña (cliente o atendente) |
| Cambió plan |
Cambio de Grupo (upgrade/downgrade) |
Privacidad — no expongas todo: ese historial puede contener datos sensibles (MAC, IP, contraseñas antiguas hasheadas, info de equipamiento). Solo usuarios con permiso "Historial de Usuario" deben ver. Operador común no necesita.
7. Equipamiento del login
Camino: Cliente → Usuario Equipamiento
Registro de los equipamientos de la red (ONUs, routers, antenas) usados para monitorear vía SNMP.
Campos
| Campo |
Qué es |
| Nombre |
Identificador interno (ej: UBNT-1) |
| Fabricante |
Ubiquiti, Mikrotik, Cambium, etc. |
| Comunidad SNMP |
String de autenticación SNMP v1/v2c (no uses "public" en producción) |
| SNMP versión |
1, 2c o 3 (3 tiene auth+privacy) |
"Comunidad = public" es riesgo de seguridad. Estándar SNMP que cualquiera en la red puede leer. Configura comunidad personalizada (string aleatoria) y firewall para solo permitir acceso desde Quaza.
8. Consumo del login
Camino: Cliente → Consumo de Usuario
Tráfico registrado por sesión PPPoE — cuánto el cliente bajó/subió en cada sesión. Viene del RADIUS accounting.
Columnas
| Columna |
Qué muestra |
| Login |
Usuario PPPoE |
| Fecha |
Período (mes o día según el filtro) |
| Upload / Download |
Total traficado (KB/MB/GB) |
| Núm. Sesiones |
Cuántas veces el login conectó/desconectó en el período |
| Tecnología |
Fibra / TV — separa conteo por tecnología |
Para qué usar: identificar clientes que sobrepasan el paquete (si hay franquicia), justificar upgrade de plan ("consumiste 800GB en el mes, considera plan mayor"), investigar reclamo de caída ("cliente abrió 50 sesiones en el día = router problemático").
Flujos típicos paso a paso
Flujo 1: Activar portal del cliente por primera vez
| Paso |
Dónde |
Qué hacer |
| 1 |
Portal → Configuración → pestaña Principal |
Habilitado=Sí, Endpoint portal=URL pública, Endpoint sistema=URL de Quaza |
| 2 |
pestaña Cliente |
Contraseña estándar="4 primeiros dígitos do CPF", carteiras de boleto/PIX, comportamento de OS |
| 3 |
pestaña Tema |
Upload del logo + colores de la marca |
| 4 |
Guardar |
"Ver área del cliente" abre el portal para probar |
| 5 |
Portal → Menú |
Habilitar itens essenciais: Mis datos, Financiero, OS, Contratos |
| 6 |
Comunicación |
Enviar campaña a la base avisando "portal disponible en..." |
Flujo 2: Cliente olvidó la contraseña del portal
| Paso |
Dónde |
Qué hacer |
| 1 |
Cliente llama / WhatsApp |
Pide reset de contraseña |
| 2 |
Atendente abre ficha → Acceso Portal |
Resetear contraseña = vuelve a contraseña estándar (4 primeros del CI) |
| 3 |
Avisar cliente |
"Su contraseña ahora son los 4 primeros dígitos de su CI. Acceda y cámbiela inmediatamente" |
| 4 |
Cliente accede |
Sistema fuerza cambio en el primer login tras reset |
Flujo 3: Notificar mantenimiento programado
| Paso |
Dónde |
Qué hacer |
| 1 |
Portal → Notificación → Agregar |
Título: "Mantenimiento programado" |
| 2 |
Mensaje |
"Habrá mantenimiento el 03/06/2026 de 2h a 4h. El servicio puede oscilar." |
| 3 |
Cliente |
Filtro: "todos los activos del barrio X" |
| 4 |
Prioridad / Agendamiento |
Alta, exhibir 02/06/2026 8h-12h (24h antes) |
| 5 |
Guardar |
Aparece en el portal automáticamente en el horario |
| 6 |
Complemento |
Disparar campaña WhatsApp
a clientes sin portal activo |
Flujo 4: Cliente reclamó que el portal está lento / no carga
| Paso |
Dónde |
Qué chequear |
| 1 |
Portal → Log |
Filtra IP del cliente — ¿vio error? ¿plataforma? |
| 2 |
Navegador suyo |
¿Cache antiguo? Pedir Ctrl+Shift+R (forzar reload) |
| 3 |
¿Endpoint portal está OK? |
Accede por tu propio navegador — ¿abre normal? |
| 4 |
Sistema lento |
Estado servidor
en Admin → Configuraciones |
| 5 |
App móvil |
¿Actualizó versión? Reinstalar si la versión es muy antigua |
Trampas frecuentes
1. Cliente no logra entrar (contraseña estándar errada)
Configurou senha padrão = "1234" mas no portal está pedindo "4 dígitos do CPF". Confira pestaña Cliente da Configuração — campo Contraseña Padrão. Atualize ambos (Quaza + comunicação ao cliente).
2. Cliente nuevo no logra loguear — contrato no está activo
Se "Verificar Fecha Activación Contrato = Sim", cliente em pré-cadastro não acessa. Pode confundir. Ou ative o contrato, ou troque a config pra "Não" (cliente acessa antes mesmo de ativar).
3. Endpoint portal HTTPS sin certificado válido
Cliente ve "Sitio no seguro" en Chrome. Reduce confianza e impide uso. Configura Let's Encrypt en el servidor que sirve el portal — renovación automática cada 90 días.
4. App móvil travado em versão antiga
Cliente descargó la app hace 2 años, nunca actualizó. El endpoint cambió, el sistema se trabó. Configura en la app verificación de versión mínima — fuerza update antes de loguear.
5. Notificación "todos los clientes" disparó a los cancelados también
Filtro frouxo expõe pessoas que não são mais clientes — ruim pra imagem. Siempre filtre por Situación=Ativo antes de disparar notificação geral.
6. Desbloqueo temporal virou "permanente" — cron de bloqueio quebrou
Cliente pide desbloqueo, sistema desbloquea 3 días, debería re-bloquear. Si el cron de bloqueo está parado (
Admin → Tareas
), el moroso queda liberado indefinidamente. Monitorea.
7. Historial con datos sensibles expuesto a operador común
Mensaje do histórico do login contém senha, MAC, IP, info de instalação. Operador de atendimento NÃO precisa ver isso — apenas técnico/admin. Restrinja via
Grupos ACL
.
Galería de pantallas
Portal config
Portal menu
Portal notificacao
Portal
Portal contratologin
Portal historico
Portal equipamento
Portal consumo
Documentos relacionados
Profundiza en los temas conexos:
-
Cliente
— el registro del cliente proporciona el CI que se vuelve login del portal
-
Contrato
— cada contrato genera 1+ ContratoLogin para la conexión
-
Soporte / OS
— OS abierta por el cliente en el portal cae aquí para la atención
-
Fibra y Red
— ContratoLogin es el "perfil RADIUS" — define plan de velocidad
-
Comunicación
— usar WhatsApp/email para avisar sobre portal disponible
-
Chat
— atendente puede "derivar" cliente al portal para autoatención
-
Mapa
— visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
-
Administración
— Grupos ACL controlan quién del staff ve Historial de Usuario (sensible)
-
Paneles
— "Conectados/Desconectados" refleja sesiones de los ContratoLogins
FAQ
¿Tiene app móvil? ¿Quaza desarrolla o el proveedor desarrolla?
Há app whitelabel oferecido como serviço — provedor publica na Play Store/Apple Store com sua marca, configura endpoint pra o Quaza dele. Não é incluído no produto base — consulte Quaza Tecnología.
¿Cliente puede pagar vía tarjeta en el portal?
Sim, se "Habilitar Tarjeta Recurrente=Sim" + carteira de cartão configurada em Cobro
. Cliente guarda tarjeta, próximas mensualidades van automáticamente. Reduce morosidad drásticamente.
¿Qué ve el cliente cuando el portal está deshabilitado?
Mensaje "Área do cliente temporariamente indisponível". Idealmente nunca desabilite — em manutenção, use notificação interna avisando.
¿Cómo veo quién nunca accedió al portal?
Cliente → Filtro → Último Acceso Portal = vacío. Útil para campaña "activa tu acceso y gana X".
¿Puedo tener portales diferentes para empresas fiscales diferentes?
Quaza tiene 1 portal por instancia. Para multi-marca/multi-empresa con portales distintos, instancias separadas + endpoints separados. Soporte puede ayudar.
¿Cliente bloqueado logra entrar al portal?
Sim — bloqueio é da conexão (PPPoE), não do portal. Cliente accede portal pelo celular 4G e gera 2ª via pra pagar. Sem isso a inadimplência é maior.
¿Hay forma de que el cliente descargue el contrato firmado en PDF?
Sí — en "Contratos" del portal aparece botón "Imprimir contrato" que genera PDF con cláusulas + aceptación electrónica (si hay). Configura layout en Contrato Template
.