Central de Ajuda Quaza Provedores

Hotsite / Área Cliente — Portal del Cliente Final (ES-PY)

Hotsite / Área Cliente — Portal del Cliente Final

Hotsite / Área Cliente — Portal del Cliente Final — Cómo Quaza configura el portal, menús, notificaciones y captação de leads

Esta wiki explica el módulo AC/Hotsite — el portal web/mobile del cliente y la landing de captação.

En esta wiki:
Pantalla "Hotsite Config"

Visión general — Área Cliente y Hotsite

El módulo AC/Hotsite (Área Cliente) es el portal que los clientes acceden para ver sus contratos, facturas, abrir tickets y configurar servicios. También cubre el Hotsite de captación de leads.

CICLO COMPLETO — VISIÓN DETALLADA ────────────────────────────────── ┌─────────────────────────────────────────────┐ │ INICIALIZACIÓN │ │ • Configuración validada │ │ • Permisos definidos por rol │ │ • Equipo entrenado en las operaciones │ │ • Procedimientos documentados │ └─────────────────────┬───────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ OPERACIÓN RECURRENTE │ │ • Input por operador, API o tarefa │ │ • Validación automática │ │ • Persistencia transaccional │ │ • Log de auditoría (timestamp + usuario) │ │ • Notificaciones por email/Slack/webhook │ └─────────────────────┬───────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ ACOMPAÑAMIENTO │ │ • Dashboard con KPIs en tiempo real │ │ • Alertas configuradas para excepciones │ │ • Reporte periódico (diario/semanal) │ │ • Análisis de tendencias │ └─────────────────────┬───────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ REVISIÓN Y MEJORA │ │ • Auditoría mensual de inconsistencias │ │ • Análisis de cuellos │ │ • Ajuste de configuración │ │ • Entrenamiento continuo del equipo │ └─────────────────────────────────────────────┘

Estrutura / fluxo (diagrama).

El portal tiene menús customizables (por empresa), notificaciones push agendadas, logs de acceso, y soporte mobile (PWA/App).

Glosario

Término Significa
AC (Área Cliente) Portal web/mobile del cliente — onde ve fatura, contrato, abre OS, hace pagamentos.
Hotsite Landing page de captação (geração de leads).
Menu Item del menu de la AC (descrição, URL, widget, ícone, imagen base64).
Notificación Alerta push enviada al cliente (título, mensaje, prioridad, agendamiento, link).
Notificación Cliente Histórico Registro persistente de notificações enviadas — leida/clicada/etc.
Hotsite Log Registro de acesso (página, evento, IP, User-Agent, mobile).
Endpoint REST URL del backend que la AC consume (configurable).
Tema / Cores Paleta customizable (paleta de cores por tenant).
Ícone AC PNG 512×512 — logo del app/portal (redimensionado al guardar).

Pantallas

Pantalla Para qué sirve
Hotsite (Config) Singleton — habilitar AC, endpoint REST, app stores, paleta, política de desbloqueio.
Menu CRUD de itens del menu (ordem, widget, ícone, imagen base64).
Notificación Criar notificações push (título, mensaje, prioridade, link, agendamiento).
Notificación Cliente Histórico Histórico de envios — clientes/lidas/clicadas.
Hotsite Log Logs de acesso al portal/hotsite.

Flujo: configurar hotsite + menús + notificaciones

1 Habilitar AC: pantalla "Hotsite (Config)" → marcar habilitação, definir endpoint REST, configurar paleta.

2 Definir menús: en "Menu", crear itens (Fatura, Suporte, Velocidade, etc.) con URL/widget asignado y ícone.

3 Subir ícone: PNG 512×512 — Quaza redimensiona al guardar.

4 Criar notificación: pantalla "Notificación" → título, mensaje, prioridade (1-5), link, fecha de envio.

5 Monitorear acessos: pantalla "Hotsite Log" muestra cada vista al portal — usuário, IP, página, mobile sí/no.

Integraciones

  • Cliente: AC autentica via Cliente (CPF/CNPJ + senha o token).
  • Contrato y Fatura: Cliente ve facturas, pagos pendentes.
  • Suporte / OS: Cliente abre tickets desde AC.
  • Carteira de Cobrança: Cliente paga via boleto/PIX/cartão direto desde AC.
  • Empresa: Configuração es por tenant — cada empresa tem su próprio AC.
PADRÓN OPERACIONAL — FLUJO COMÚN ───────────────────────────────── 1. Cadastro inicial / configuración │ ▼ 2. Permisos definidos por rol │ ▼ 3. Operación normal: ┌──────────────────────────────────┐ │ - input del operador / tarefa │ │ - validación automática │ │ - persistencia en la BD │ │ - log de auditoría │ │ - notificación (si aplica) │ └──────────────┬───────────────────┘ │ ▼ 4. Revisión / supervisión │ ┌──────┴──────┐ ▼ ▼ OK normal Desvío detectado │ │ ▼ ▼ Histórico Acción correctiva + alerta al supervisor

Estrutura / fluxo (diagrama).

CICLO OPERACIONAL — DETALLADO ──────────────────────────────── Fase 1 — Preparación ┌────────────────────────────────────┐ │ Configuración validada │ │ Permisos atribuidos │ │ Equipo entrenado │ └──────────────┬─────────────────────┘ ▼ Fase 2 — Operación ┌────────────────────────────────────┐ │ Input (operador / API / tarefa) │ │ Validación automática │ │ Persistencia │ │ Log de auditoría │ │ Notificaciones (email/webhook) │ └──────────────┬─────────────────────┘ ▼ Fase 3 — Acompañamiento ┌────────────────────────────────────┐ │ Dashboard actualizado │ │ Alertas de excepción │ │ Reporte periódico │ └──────────────┬─────────────────────┘ ▼ Fase 4 — Revisión / mejora ┌────────────────────────────────────┐ │ Análisis de KPIs │ │ Identificación de cuellos │ │ Ajuste de configuración │ └────────────────────────────────────┘

Estrutura / fluxo (diagrama).

Trampas frecuentes

Trampa 1 — Hotsite NO crea cliente automaticamente: La landing page registra logs (HotsiteLog) pero NO insert en tabla Cliente. Para captura real de leads, hay que conectar formulario al CRM.
Trampa 2 — Ícone redimensionado al guardar: Si subes PNG menor que 512×512, queda granulado. Sempre subir tamaño exacto.
Trampa 3 — Configuração es singleton: 1 registro en BD por empresa. No hay "perfis" diferentes — toda la AC usa misma config.
Trampa 4 — Notificación agendada pode no ejecutar: Existe campo de agendamiento pero la execução depende de job queue/tarefa externo. Si Tarefa no está rodando, notificación nunca sai.
Trampa 5 — Detecção mobile vía User-Agent: Campo "mobile" es heurístico. Browser desktop com user-agent customizado puede ser marcado como mobile y vice-versa.

Galería de pantallas

Hotsite
Hotsite
Menu
Menu
Notificacao
Notificacao
Hotsitelog
Hotsitelog

Preguntas frecuentes

¿Cómo empezar a usar este módulo?

Configure los pre-requisitos listados arriba, haga un teste en ambiente seguro (o con pocos registros), valide con el equipo, y solo después active en producción.

¿Necesito permiso especial para acceder?

Sí. Cada rol (operador/supervisor/admin) tiene permisos distintos. Confirme con el administrador del Quaza.

¿Puedo integrar con sistemas externos?

Vía API REST del Quaza. Webhooks notifican eventos importantes. Consulte el equipo técnico para credenciales.

¿Qué pasa si hay error?

Los logs quedan en el panel de tareas/auditoría. Configure alertas (email/Slack) para fallas críticas — no confíe en nadie mirando log manualmente.

¿Cómo acompañar cambios?

Cada registro tiene histórico (timestamp, usuario, acción). Use el filtro de auditoría para rastrear modificaciones sospechosas.

¿El módulo funciona multi-filial?

Sí — vía centro de costo (filial) atribuido al asiento. Reportes filtran por filial.

Buenas prácticas operacionales

Esta sección reúne hábitos que proveedores experimentados adoptan para evitar problemas recurrentes en este módulo. Aplicación consistente hace diferencia grande en el largo plazo — diferencia entre operación caótica y operación previsible.

Revisión periódica

Reserve 30 minutos por semana para revisar el estado del módulo: lo que corrió, lo que falló, lo que quedó pendiente. Anomalía detectada temprano cuesta 10× menos que descubierta tarde.

Documentación de procedimientos

Cree checklists internos para operaciones recurrentes — apertura/cierre del mes, procesamiento en lote, corrección de inconsistencias. No dependa de quien "sabe de memoria" — funcionario puede salir, enfermar, tener día malo.

Backup antes de operaciones masivas

Cualquier cambio que afecte 100+ registros debe ser precedido de backup o export. Restaurar una alteración masiva equivocada es caro; prevenir es simple.

Comunicación con cliente

Cambios que impactan al cliente (precio, cobranza, regla) deben comunicarse con antelación. Cliente sorprendido reclama; cliente avisado entiende.

Indicadores acompañados

Defina 2-3 indicadores que miden la salud del módulo. Acompañe semanalmente. Cuando alguno sale del rango esperado, investigue antes de volverse problema visible.

Documentos relacionados

Preguntas frecuentes

¿AC y Portal son lo mismo?
Conceptualmente similares. AC = wrapper técnico (módulo); Portal = visión funcional del cliente. Ver Portal para detalles.
¿Notificación push é por SMS/Email/App?
Diferentes canales — depende del setup de Comunicação. La notificación AC normalmente va al app/PWA.
¿Posso ter app branded?
Sí — ícone customizado, paleta de cores, app stores configurables.