Central de Ajuda Quaza Provedores

Portal — Área do Cliente (PT)

Portal — Área do Cliente — Quaza

Portal — Área do Cliente (autoatendimento)

El Portal (o Área do Cliente, "AC") es el sitio/app que el cliente final accede para ver fatura, obtener 2da vía de boleto, abrir OS, actualizar datos, pedir cambio de plan — sin precisar llamar o enviar mensaje al provedor.

Esta wiki cobre o módulo do lado do provedor: como configurar o portal, que menus liberar, personalizar cores/logo, criar notificações, y ver o histórico do contratologin (login PPPoE/IPoE) que conecta o portal com a operação técnica.

Quién gana: la atención — uma 2da vía de boleto automatizada ahorra decenas de llamadas por mes. Un portal bien hecho cubre 70%+ de as demandas básicas.
Nesta wiki:

Visão geral — onde entra el cliente

CLIENTE FINAL (accede vía navegador / app) ↓ ┌──────────────────────────────────────────────────────────────────────┐ │ PORTAL — Área do Cliente — provedor.com.br/areacliente │ │ (hotsite separado, pero integrado a Quaza) │ ├──────────────────────────────────────────────────────────────────────┤ │ Login: CI/RUC + senha (estándar = 4 primeros dígitos do CI) │ │ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ MENÚ LATERAL (configurable por Admin de Quaza) │ │ │ │ • Mis datos • Faturas │ │ │ │ • Contratos • Notas fiscais │ │ │ │ • Financiero / Boletos • Solicitud │ │ │ │ • Ordens de Serviço • Recomendaciones │ │ │ │ • Prueba de conexión • Dependientes │ │ │ │ • Desbloqueo temporal │ │ │ └────────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────┘ ↓ acción do cliente ┌──────────────────────────────────────────────────────────────────────┐ │ BACKEND QUAZA — sincroniza con el sistema operacional │ │ • Cliente hace clic "2da vía" → gera boleto/QR do financiero │ │ • Cliente hace clic "Abrir OS" → crea registro en Suporte │ │ • Cliente solicita troca de plano → cria contratoAcao "Solicitud" │ │ • Cliente edita datos → actualiza registro (Quaza valida y aplica) │ └──────────────────────────────────────────────────────────────────────┘ ↓ Equipe operacional do provedor (atendentes ven solicitudes en Quaza)
Portal = autoservicio 24x7. Cliente accede a as 2h da madrugada, obtiene 2da vía, paga vía QR, recupera login PPPoE — sin despertar a nadie. Os atendentes quedan liberados para casos que realmente precisan humano.

Glossário

Termo Significado
Portal / Hotsite / Área do Cliente El sitio que el cliente final accede para autoatendimento. En el código aparece como "AC" (ac-hotsite, ac-menu, etc.)
ContratoLogin Registro do usuário PPPoE/IPoE — login + senha que el router/módem usa para conectar a la red. Un Contrato pode tener varios logins (TV, Fibra, etc.)
Tecnologia (do login) Tipo: Fibra (PPPoE), TV (IPTV), Radio, etc. Define como o serviço é prestado
Sesión Conexión activa do 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 do 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 Auditoria de todo lo que el cliente hace en el portal: páginas visitadas, IP, plataforma, navegador
Notificación al cliente Aviso que aparece dentro do portal cuando el cliente entra (mantenimiento, dívida, promoción)
Endpoint portal URL do portal (provedor.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 do portal (algunos provedores publican app whitelabel)

1. Configurações do Portal

Caminho: Portal → Configuração

Tela única con pestañas que controla todo el comportamiento do portal: habilitar, senha estándar, contactos, app, tema, comportamiento de cliente y técnico.

Aba Principal

Campo O que faz
Habilitado Sim = portal accesible para os clientes. Não = portal off
Senha estándar Lo que el cliente usa en el primer acesso. Estándar: 4 primeros dígitos do CI
Contacto Teléfono/WhatsApp que aparece en el pie do portal
Endpoint portal URL pública do portal (ej: areacliente.provedor.com.br)
Endpoint sistema URL interna de Quaza (consumida por la API do portal)
Endpoint Google Play / Apple Store Enlace da app móvil (si la hay) — aparece como botón "Descarga nuestra app"
Ícono do área do cliente Logo personalizado (upload) — sustituye el logo estándar

Aba Cliente — comportamiento

Campo O que faz
Período Desbloqueo Cuánto tempo el cliente bloqueado queda liberado (ej: 3 días)
Días Desbloqueo Cuántas veces por mes pode pedir desbloqueo
Días Intervalo Bono Tiempo mínimo entre solicitudes de bono de recomendación
Financiero Listagem Estándar Como mostrar deudas: solo abiertas / abiertas+pagadas / todas
Intervalo Financiero Sistema Período exhibido por defecto (ej: últimos 90 días)
Financiero Imprimir Carnê Permite imprimir carnê completo (varias boletos)
Habilitar OS — Resolución / Problema Cliente pode abrir OS vía portal (categorías seleccionables)
Verificar Fecha Activación Contrato Cliente nuevo solo accede tras contrato activo
Pedir CI/RUC Fatura Antes de mostrar boleto, cliente confirma CI/RUC
Exhibir Anexos OS Muestra fotos/PDFs adjuntados en as OS do cliente
Carteira Estándar (Boleto/QR/Cartão) O que carteira se usa en as 2das vías geradas vía portal
Considera Cobrança Existente No duplica cobrança si ya tem boleto válida
Habilitar Cartão Recurrente Permite al cliente guardar tarjeta para débito automático

Aba Técnico

Campo O que faz
Cliente/Stock/OS Filtrar Técnico Técnico solo ve clientes/productos/OS suyas (no todo)
Permitir Remover ONU Técnico pode liberar ONU para reúso
Editar Datos Router Técnico pode cambiar IP, WiFi-SSID, senha do router vía portal técnico
Obligatorio Caixa/Puerto Técnico OS técnica exige llenar Caixa óptica + Puerto (trazabilidad)
Filtro Fijo OS Técnico solo ve OS do setor suyo

Aba Tema (cores)

Color Onde aparece
Primary / Secondary Encabezado, botones principales, enlaces
Menu Text / Menu Hover Texto do menú lateral + color al pasar el mouse
Card Text / Card Bg / Card Hover Apariencia de os cards (cajas de fatura, OS, etc.)
Branding completo: con ícono personalizado + cores tema, el portal se vuelve "marca blanca" do provedor — el cliente no ve "Quaza" en ningún lado. Bueno para coherencia visual con el sitio institucional.

Caminho: Portal → Menú

Registra os ítems de menú que el cliente ve en el portal. Quaza trae ítems estándar (el cliente pode esconder) y permite criar ítems nuevos (enlaces externos, contenido institucional).

Filtros: Portal do cliente vs Portal do técnico

Quaza tem dos portales:

  • Portal do cliente — usuário final, login con CI/RUC
  • Portal do técnico — equipo de campo, fluxo de OS, ONU, señal óptica

Ítems estándar do Portal do Cliente

Ítem Descripción Quando habilitar
Mis datos Cambiar senha, datos de registro Sempre
Contratos Impresión + aceptación electrónica Recomendado
Financiero 2da vía boleto/QR/carnê Sempre (mais usado)
Notas fiscais NFe/NFSe emitidas (descarga) Sempre se provedor emite
Solicitud Cambio de plan, dirección Habilitar cuando haya fluxo definido
Ordens de Serviços Abrir y acompañar OS Sempre
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
Faturas Lista de faturas 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

Caminho: Portal → Notificación

Avisos que aparecen dentro do portal cuando el cliente entra. Útil para anuncio de mantenimiento, promoción, recordatorio de datos faltantes.

Campos

Campo O que é
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 Quando aparecer (ej: 2026-05-15 a as 6h)
Estado Borrador / Agendada / Publicada / Cerrada
Caso de uso típico: "Mantenimiento programado — 03/06/2026 de 2h a 4h" — enviar a todos os clientes da 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 acessos (Hotsite Log)

Caminho: Portal → Log

Auditoria de cada clic do cliente en el portal: que página visitó, que evento disparó, IP, plataforma, navegador.

Columnas

Columna O que mostra
Fecha/Hora Timestamp da acción
Cliente Quién hizo (registro)
Página En que tela do portal estaba (financiero, contrato, etc.)
Evento Acción: "gerar 2da vía", "abrir OS", "imprimir contrato"
Valor Parámetro relevante (ej: id da OS, valor da boleto)
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 conta y cambió mi dirección". Hotsite log muestra IP + plataforma da acción. Si fue de IP extraño, pode ser invasión — bloquea portal, fuerza cambio de senha, gera alerta.

5. Usuário/ContratoLogin

Caminho: Cliente → Usuário

Registro do 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) ├─ Tecnologia: Fibra | TV | Radio | ... ├─ Usuário + Senha PPPoE (va en el router) ├─ Grupo: define plan de velocidad (vinculado a RADIUS) ├─ Dirección IP fija (si aplica) ├─ MAC do equipamento └─ Estado: Activo | Bloqueado | Cancelado | Pre-registro

Campos principales

Campo O que é
Cliente Dueño do login
Login (usuário PPPoE) String que va en el router (ej: cliente.silva)
Senha Hash (no aparece — solo editar)
Tecnologia Fibra, TV, Radio, Hotspot
Grupo Plan de velocidad (300MB, 1GB, etc.)
Dirección IP Si el cliente tem IP fijo, queda aquí
MAC Mac address do equipamento (autenticación IPoE)
Estado Activo (conecta), Bloqueado (rechaza), Cancelado, Pre-registro
Concentrador En que BRAS/OLT vive ese login
Punto de acesso Caixa óptica / setor

6. Historial de alteraciones

Caminho: Cliente → Historial de Usuário

Audit trail completo de os cambios en el login: quién cambió senha, quién cambió grupo (plan), quién alteró MAC.

Clasificadores típicos

Clasificador Quando aparece
Alteró Cualquier cambio en campo do login
Bloqueó Bloqueo manual o automático (cron de morosidad)
Liberó Liberación (manual o vía desbloqueo temporal do portal)
Cambió senha Reset de senha (cliente o atendente)
Cambió plan Cambio de Grupo (upgrade/downgrade)
Privacidad — no expongas todo: ese histórico pode contener datos sensibles (MAC, IP, senhas antiguas hasheadas, info de equipamento). Solo usuários con permiso "Historial de Usuário" deven ver. Operador común no precisa.

7. Equipamento do login

Caminho: Cliente → Usuário Equipamento

Registro de os equipamentos da red (ONUs, routers, antenas) usados para monitorear vía SNMP.

Campos

Campo O que é
Nome 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 tem auth+privacy)
"Comunidad = public" es riesgo de seguridad. Estándar SNMP que cualquiera en la red pode leer. Configura comunidad personalizada (string aleatoria) y firewall para solo permitir acesso desde Quaza.

8. Consumo do login

Caminho: Cliente → Consumo de Usuário

Tráfico registrado por sesión PPPoE — cuánto el cliente bajó/subió en cada sesión. Viene do RADIUS accounting.

Columnas

Columna O que mostra
Login Usuário PPPoE
Fecha Período (mes o día segundo el filtro)
Upload / Download Total traficado (KB/MB/GB)
Núm. Sessões Cuántas veces el login conectó/desconectó en el período
Tecnologia Fibra / TV — separa conteo por tecnologia
Para que usar: identificar clientes que sobrepasan el paquete (si há 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").

Fluxos típicos passo-a-passo

Fluxo 1: Activar portal do cliente por primera vez

Passo Onde O que fazer
1 Portal → Configuração → pestaña Principal Habilitado=Sí, Endpoint portal=URL pública, Endpoint sistema=URL de Quaza
2 pestaña Cliente Senha estándar="4 primeiros dígitos do CPF", carteiras de boleto/PIX, comportamento de OS
3 pestaña Tema Upload do logo + cores da marca
4 Salvar "Ver área do cliente" abre el portal para probar
5 Portal → Menú Habilitar itens essenciais: Mis datos, Financiero, OS, Contratos
6 Comunicação Enviar campaña a la base avisando "portal disponible en..."

Fluxo 2: Cliente olvidó la senha do portal

Passo Onde O que fazer
1 Cliente llama / WhatsApp Pide reset de senha
2 Atendente abre ficha → Acesso Portal Resetear senha = vuelve a senha estándar (4 primeros do CI)
3 Avisar cliente "Su senha ahora son os 4 primeros dígitos de seu CI. Acceda y cámbiela inmediatamente"
4 Cliente accede Sistema fuerza cambio en el primer login tras reset

Fluxo 3: Notificar mantenimiento programado

Passo Onde O que fazer
1 Portal → Notificación → Agregar Título: "Mantenimiento programado"
2 Mensaje "Habrá mantenimiento el 03/06/2026 de 2h a 4h. El servicio pode oscilar."
3 Cliente Filtro: "todos os activos do barrio X"
4 Prioridad / Agendamiento Alta, exhibir 02/06/2026 8h-12h (24h antes)
5 Salvar Aparece en el portal automáticamente en el horario
6 Complemento Disparar campaña WhatsApp a clientes sin portal activo

Fluxo 4: Cliente reclamó que el portal está lento / no carga

Passo Onde O que chequear
1 Portal → Log Filtra IP do 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 → Configurações
5 App móvil Actualizó versión? Reinstalar si la versión es muy antigua

Pegadinhas frequentes

1. Cliente no logra entrar (senha 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 Senha 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 os clientes" disparó a os cancelados también
Filtro frouxo expõe pessoas que não são mais clientes — ruim pra imagem. Sempre filtre por Situação=Ativo antes de disparar notificação geral.
6. Desbloqueo temporal virou "permanente" — cron de bloqueio quebrou
Cliente pide desbloqueo, sistema desbloquea 3 días, devería re-bloquear. Si el cron de bloqueo está parado (Admin → Tarefas ), 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 .

Galeria de telas

Portal config
Portal config
Portal menu
Portal menu
Portal notificacao
Portal notificacao
Portal
Portal
Portal contratologin
Portal contratologin
Portal historico
Portal historico
Portal equipamento
Portal equipamento
Portal consumo
Portal consumo

Documentos relacionados

Aprofunde-se nos temas conexos:
  • Cliente — el registro do cliente proporciona el CI que se vuelve login do portal
  • Contrato — cada contrato gera 1+ ContratoLogin para la conexión
  • Suporte / OS — OS abierta por el cliente en el portal cae aquí para la atención
  • Fibra e Rede — ContratoLogin es el "perfil RADIUS" — define plan de velocidad
  • Comunicação — usar WhatsApp/email para avisar sobre portal disponible
  • Chat — atendente pode "derivar" cliente al portal para autoatendimento
  • Mapa — visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
  • Administração — Grupos ACL controlan quién do staff ve Historial de Usuário (sensible)
  • Painéis — "Conectados/Desconectados" refleja sesiones de os ContratoLogins

FAQ

Tem app móvil? Quaza desarrolla o el provedor 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 Tecnologia.

Cliente pode pagar vía tarjeta en el portal?

Sim, se "Habilitar Cartão Recurrente=Sim" + carteira de cartão configurada em Cobrança . Cliente guarda tarjeta, próximas mensalidadees van automáticamente. Reduce morosidad drásticamente.

O que 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.

Como veo quién nunca accedió al portal?

Cliente → Filtro → Último Acesso Portal = vazio. Útil para campaña "activa tu acesso y gana X".

Puedo tener portales diferentes para empresas fiscales diferentes?

Quaza tem 1 portal por instancia. Para multi-marca/multi-empresa con portales distintos, instancias separadas + endpoints separados. Suporte pode 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.

Há forma de que el cliente descargue el contrato firmado en PDF?

Sim — en "Contratos" do portal aparece botón "Imprimir contrato" que gera PDF con cláusulas + aceptación electrónica (si hay). Configura layout en Contrato Template .