Central de Ajuda Quaza Provedores

Hotsite / Área do Cliente — Portal do Cliente Final (PT)

Hotsite / Área do Cliente — Portal do Cliente Final

Hotsite / Área do Cliente — Portal do Cliente Final — Como o Quaza configura el portal, menús, notificações e captação de leads

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

Nesta wiki:
Tela "Hotsite Config"

Visão geral — Área Cliente e Hotsite

El módulo AC/Hotsite (Área Cliente) es el portal que os clientes acceden para ver sus contratos, faturas, abrir tickets e configurar serviços. Também cubre el Hotsite de captación de leads.

CICLO COMPLETO — VISÃO DETALHADA ────────────────────────────────── ┌─────────────────────────────────────────────┐ │ INICIALIZAÇÃO │ │ • Configuração validada │ │ • Permissões definidas por papel │ │ • Equipe treinada nas operações │ │ • Procedimentos documentados │ └─────────────────────┬───────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ OPERAÇÃO RECORRENTE │ │ • Input pelo operador, API ou tarefa │ │ • Validação automática │ │ • Persistência transacional │ │ • Log de auditoria (timestamp + usuário) │ │ • Notificações por email/Slack/webhook │ └─────────────────────┬───────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ ACOMPANHAMENTO │ │ • Dashboard com KPIs em tempo real │ │ • Alertas configurados pra exceções │ │ • Relatório periódico (diário/semanal) │ │ • Análise de tendências │ └─────────────────────┬───────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ REVISÃO E MELHORIA │ │ • Auditoria mensal de inconsistências │ │ • Análise de gargalos │ │ • Ajuste de configuração │ │ • Treinamento contínuo da equipe │ └─────────────────────────────────────────────┘

Estrutura / fluxo (diagrama).

El portal tem menús customizables (por empresa), notificações push agendadas, logs de acesso, e soporte mobile (PWA/App).

Glossário

Termo Significado
AC (Área Cliente) Portal web/mobile do cliente — onde ve fatura, contrato, abre OS, hace pagamentos.
Hotsite Landing page de captação (geração de leads).
Menu Item do menu da AC (descrição, URL, widget, ícone, imagen base64).
Notificação Alerta push enviada al cliente (título, mensagem, prioridade, agendamento, link).
Notificação 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 do backend que la AC consume (configurável).
Tema / Cores Paleta customizable (paleta de cores por tenant).
Ícone AC PNG 512×512 — logo do app/portal (redimensionado ao salvar).

Telas

Tela Para que serve
Hotsite (Config) Singleton — habilitar AC, endpoint REST, app stores, paleta, política de desbloqueio.
Menu CRUD de itens do menu (ordem, widget, ícone, imagen base64).
Notificação Criar notificações push (título, mensagem, prioridadee, link, agendamento).
Notificação Cliente Histórico Histórico de envios — clientes/lidas/clicadas.
Hotsite Log Logs de acesso al portal/hotsite.

Fluxo: configurar hotsite + menús + notificações

1 Habilitar AC: tela "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 e ícone.

3 Subir ícone: PNG 512×512 — Quaza redimensiona ao salvar.

4 Criar notificação: tela "Notificação" → título, mensagem, prioridadee (1-5), link, fecha de envio.

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

Integrações

  • Cliente: AC autentica via Cliente (CPF/CNPJ + senha o token).
  • Contrato e Fatura: Cliente ve faturas, 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 seu próprio AC.
PADRÃO OPERACIONAL — FLUXO COMUM ────────────────────────────────── 1. Cadastro inicial / configuração │ ▼ 2. Permissões definidas por papel │ ▼ 3. Operação normal: ┌──────────────────────────────────┐ │ - input do operador / tarefa │ │ - validação automática │ │ - persistência no banco │ │ - log de auditoria │ │ - notificação (se aplicável) │ └──────────────┬───────────────────┘ │ ▼ 4. Revisão / supervisão │ ┌──────┴──────┐ ▼ ▼ OK normal Desvio detectado │ │ ▼ ▼ Histórico Ação corretiva + alerta ao supervisor

Estrutura / fluxo (diagrama).

CICLO OPERACIONAL — DETALHADO ──────────────────────────────── Fase 1 — Preparação ┌────────────────────────────────────┐ │ Configuração validada │ │ Permissões atribuídas │ │ Equipe treinada │ └──────────────┬─────────────────────┘ ▼ Fase 2 — Operação ┌────────────────────────────────────┐ │ Input (operador / API / tarefa) │ │ Validação automática │ │ Persistência │ │ Log de auditoria │ │ Notificações (email/webhook) │ └──────────────┬─────────────────────┘ ▼ Fase 3 — Acompanhamento ┌────────────────────────────────────┐ │ Dashboard atualizado │ │ Alertas de exceção │ │ Relatório periódico │ └──────────────┬─────────────────────┘ ▼ Fase 4 — Revisão / melhoria ┌────────────────────────────────────┐ │ Análise de KPIs │ │ Identificação de gargalos │ │ Ajuste de configuração │ └────────────────────────────────────┘

Estrutura / fluxo (diagrama).

Pegadinhas frequentes

Pegadinha 1 — Hotsite NO crea cliente automaticamente: La landing page registra logs (HotsiteLog) pero NO insert en tabla Cliente. Para captura real de leads, hae que conectar formulario al CRM.
Pegadinha 2 — Ícone redimensionado ao salvar: Se subir PNG menor que 512×512, fica pixelado. Sempre subir tamanho exacto.
Pegadinha 3 — Configuração es singleton: 1 registro en BD por empresa. No hae "perfis" diferentes — toda la AC usa mesma config.
Pegadinha 4 — Notificação agendada pode no ejecutar: Existe campo de agendamento pero la execução depende de job queue/tarefa externo. Se Tarefa no está rodando, notificação nunca sai.
Pegadinha 5 — Detecção mobile vía User-Agent: Campo "mobile" es heurístico. Browser desktop com user-agent customizado pode ser marcado como mobile e vice-versa.

Galeria de telas

Hotsite
Hotsite
Menu
Menu
Notificacao
Notificacao
Hotsitelog
Hotsitelog

FAQ

Como começar a usar este módulo?

Configure os pré-requisitos listados acima, faça um teste em ambiente seguro (ou com poucos registros), valide com a equipe, e só então ative em produção.

Preciso de permissão especial pra acessar?

Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com o administrador do Quaza.

Posso integrar com sistemas externos?

Via API REST do Quaza. Webhooks notificam eventos importantes. Consulte a equipe técnica para credenciais.

O que acontece se houver erro?

Os logs ficam no painel de tarefas/auditoria. Configure alertas (email/Slack) para falhas críticas — não confie em ninguém olhar log manualmente.

Como acompanhar mudanças?

Cada registro tem histórico (timestamp, usuário, ação). Use o filtro de auditoria pra rastrear modificações suspeitas.

O módulo funciona multi-filial?

Sim — via centro de custo (filial) atribuído ao lançamento. Relatórios filtram por filial.

Boas práticas operacionais

Esta seção reúne hábitos que provedores experientes adotam pra evitar problemas recorrentes neste módulo. Aplicação consistente faz diferença grande no longo prazo — diferença entre operação caótica e operação previsível.

Revisão periódica

Reserve 30 minutos por semana pra revisar o estado do módulo: o que rodou, o que falhou, o que ficou pendente. Anomalia detectada cedo custa 10x menos que descoberta tarde.

Documentação de procedimentos

Crie checklists internos pra operações recorrentes — abertura/fechamento do mês, processamento em lote, correção de inconsistências. Não dependa de quem "sabe de cabeça" — funcionário pode sair, ficar doente, ter dia ruim.

Backup antes de operações em massa

Qualquer mudança que afete 100+ registros deve ser precedida de backup ou export. Restaurar uma alteração massiva equivocada é caro; prevenir é simples.

Comunicação com cliente

Mudanças que impactam o cliente (preço, cobrança, regra) devem ser comunicadas com antecedência. Cliente surpreendido reclama; cliente avisado entende.

Indicadores acompanhados

Defina 2-3 indicadores que medem a saúde do módulo. Acompanhe semanalmente. Quando algum sai do range esperado, investigue antes de virar problema visível.

Documentos relacionados

Perguntas frequentes

¿AC e Portal son lo mesmo?
Conceptualmente similares. AC = wrapper técnico (módulo); Portal = visión funcional do cliente. Ver Portal para detalles.
¿Notificação push é por SMS/Email/App?
Diferentes canales — depende do setup de Comunicação. La notificação AC normalmente va al app/PWA.
¿Posso ter app branded?
Sim — ícone customizado, paleta de cores, app stores configurávels.