Como usar este manual
Pense nesta wiki como um guia turístico do painel. Cada seção traz uma visão leiga do que o módulo faz, exemplos do dia a dia e um mini passo a passo para executar as tarefas mais comuns. Sempre que tiver dúvida sobre um termo, consulte o glossário ao final.
1. Entenda o cenário
Leia a descrição "O que é" para saber, em palavras simples, qual problema o módulo resolve.
2. Siga o passo a passo
Use a coluna "Como fazer" para executar as ações principais sem medo de esquecer etapas.
3. Explore conexões
Veja as tags finais para entender quais outros módulos se relacionam com o atual.
Clientes
Base principal de cadastro. Tudo começa aqui: dados pessoais, contatos e endereços dos assinantes.
O que é
Lista de todas as pessoas físicas ou jurídicas atendidas pelo provedor. Cada cliente pode ter uma ou mais assinaturas.
Quando usar
- Cadastro de um novo assinante.
- Atualizar telefone ou e-mail para cobranças.
- Consultar endereços para visitas técnicas.
Como fazer
- Clique em “Adicionar Cliente”.
- Preencha dados básicos (Nome, CPF/CNPJ, contatos).
- Adicione endereço de instalação e observações úteis.
- Salve e, se necessário, já crie a assinatura pelo atalho.
Dicas rápidas
- Use observações para registrar histórico de atendimentos.
- Manter CPF/CNPJ correto evita problemas fiscais.
- Verifique se o cliente está vinculado ao tenant certo.
Assinaturas
Gerencia o contrato ativo de cada cliente: plano, status financeiro, autenticação e equipamentos.
O que é
O coração do provedor. Cada assinatura representa um serviço entregue ao cliente, com informações de rede, cobrança e histórico de status.
Quando usar
- Ativar um novo cliente e definir plano/servidor.
- Verificar status (adimplente, inadimplente, bloqueado).
- Migrar várias assinaturas para outro servidor.
Como fazer
- Localize a assinatura pelo nome do cliente ou status.
- Edite para atualizar plano, autenticação ou endereço.
- Use as ações do canto direito: Ativar, Desativar ou Alterar Plano em massa.
- Salve e verifique alertas de conflito (login/IP duplicados).
Dicas rápidas
- O filtro “Vencimento (de/até)” ajuda a prever bloqueios.
- Isentos aparecem com destaque azul no valor e vencimento.
- Use o widget AssinaturaStatsOverview para visão geral.
Contratos
Armazena os documentos que formalizam o serviço. Ideal para acompanhar vigência e anexos assinados.
O que é
Um repositório de contratos vinculados aos clientes, com status (ativo, renovado, encerrado) e possibilidade de anexos.
Quando usar
- Registrar um novo contrato assinado.
- Consultar cláusulas antes de renegociar.
- Garantir que o contrato está alinhado à assinatura ativa.
Como fazer
- Crie o contrato a partir do cliente ou da assinatura.
- Selecione o modelo padrão (se existir) e ajuste dados.
- Anexe o PDF assinado e informe vigência.
- Salve e acompanhe o status na lista.
Dicas rápidas
- Use Modelos de Contrato para padronizar textos.
- Registrar data de renovação evita caducidade.
- Inclua observações sobre garantias ou multa.
Chamados
Central de atendimento. Controla solicitações, problemas e tarefas internas para cada cliente.
O que é
Uma fila de tickets com status, setor responsável e histórico de mensagens. Ajuda a garantir SLA.
Quando usar
- Registrar chamado de suporte técnico.
- Acompanhar tratativas de cobrança.
- Distribuir tarefas entre setores (técnico, financeiro, comercial).
Como fazer
- Abra o módulo e filtre por status (Aberto, Em andamento, Finalizado).
- Clique no chamado para ver detalhes e anotações.
- Atualize o responsável ou setor quando necessário.
- Finalize com o status correto e registre a solução.
Dicas rápidas
- Adicionar tags ajuda a priorizar temas críticos.
- Relatórios de tempo médio dependem de status atualizados.
- Integre com API WhatsApp para avisar o cliente automaticamente.
Categorias de Conta a Receber
Organiza as receitas por tipo. Ajuda o financeiro a entender de onde vem o dinheiro.
O que é
Uma tabela de etiquetas usadas ao lançar contas a receber. Exemplo: Mensalidade, Instalação, Multa.
Quando usar
- Criar uma nova categoria para um serviço recém-oferecido.
- Padronizar lançamentos feitos pela equipe de cobrança.
- Filtrar relatórios por centro de receita.
Como fazer
- Clique em “Adicionar Categoria”.
- Informe nome amigável e descrição.
- Salve e informe à equipe a nova categoria disponível.
Dicas rápidas
- Use nomes curtos para facilitar filtros.
- Revise categorias inativas a cada trimestre.
Categorias Financeiro
Classificação geral de entradas e saídas. Funciona como um plano de contas simplificado.
O que é
Lista de categorias usadas em todos os lançamentos financeiros (receitas e despesas).
Quando usar
- Mapear despesas recorrentes (Energia, Folha, Marketing).
- Preparar relatórios contábeis.
- Comparar gastos por área nos dashboards.
Como fazer
- Criar a categoria com nome e tipo (receita ou despesa).
- Adicionar uma descrição simples para orientar a equipe.
- Salvar e usar nas telas de contas a pagar/receber.
Dicas rápidas
- Combine com o contador para alinhar plano de contas.
- Evite criar categorias duplicadas com grafia diferente.
Plataformas de Recebimento
Onde você configura os meios de pagamento (PIX, boleto, cartão) e integrações com gateways.
O que é
Cadastro das contas ou gateways utilizados para cobrar clientes. Define taxas e credenciais.
Quando usar
- Adicionar uma nova conta bancária para PIX.
- Configurar integração com EFI Bank ou Lytex.
- Alterar taxas repassadas ao cliente.
Como fazer
- Clique em “Adicionar plataforma”.
- Preencha nome, tipo (PIX, boleto, cartão) e credenciais.
- Teste o envio de uma cobrança antes de liberar para produção.
Dicas rápidas
- Proteja tokens de API (evite expor em canais abertos).
- Documente em Config Sistema quais plataformas estão ativas.
Contas a Receber
Controle das receitas do provedor: lançamentos, baixas e comprovantes.
O que é
Tela onde ficam os títulos que o cliente precisa pagar. Cada linha mostra valor, vencimento e status.
Quando usar
- Lançar cobranças avulsas (instalação, multa).
- Registrar baixa manual de um recebimento.
- Anexar comprovantes enviados pelo cliente.
Como fazer
- Clique em “Criar conta a receber”.
- Informe cliente, valor, vencimento e categoria.
- Ao receber o pagamento, edite e marque como “Pago”, registrando data e forma.
Dicas rápidas
- Integrações (EFI, Lytex) podem dar baixa automática.
- Use filtros por atraso para direcionar cobranças.
Contas a Pagar
Acompanhamento das despesas do provedor: quem devemos, quanto e quando vence.
O que é
Tela para lançar despesas (fornecedor, conta, tributo) e controlar se já foram pagas.
Quando usar
- Lançar nota fiscal de um fornecedor.
- Controlar vencimentos de aluguel, energia, serviços.
- Anexar comprovante após a quitação.
Como fazer
- Clique em “Criar conta a pagar”.
- Selecione o fornecedor, informe valor e vencimento.
- Quando pagar, edite e marque status como “Pago”, registrando dados do pagamento.
Dicas rápidas
- Organize anexos para facilitar auditorias.
- Use categorias financeiras para relatórios de despesas.
Planos
Catálogo das ofertas do provedor: velocidade, preço, servidor e autenticação.
O que é
Cadastro que define quanto cobrar, qual largura de banda entregar e onde o cliente será autenticado.
Quando usar
- Lançar um novo plano comercial.
- Ajustar preço ou franquia de um plano existente.
- Marcar quais métodos de autenticação (PPPoE, hotspot, IP).
Como fazer
- Crie o plano informando nome, velocidade e valor.
- Associe a um servidor e marque os métodos disponíveis.
- Salve e comunique a equipe comercial.
Dicas rápidas
- Planos com hotspot ou PPPoE precisam de configuração no servidor.
- Use descrições para orientar vendedores sobre benefícios.
Faturas (Geral)
Centraliza todas as faturas geradas, independente do gateway. Mostra status, valores e ações.
O que é
Uma lista com as faturas emitidas para os clientes, permitindo reenviar boletos e verificar pagamentos.
Quando usar
- Reenviar boleto ou link de pagamento.
- Verificar faturas atrasadas ou com erro.
- Sincronizar status com o módulo de Contas a Receber.
Como fazer
- Filtre por cliente ou status (Em aberto, Pago, Cancelado).
- Clique na fatura para ver detalhes e histórico de notificações.
- Use ações disponíveis para reenviar ou cancelar.
Dicas rápidas
- Integrações específicas têm módulos dedicados (EFI, Lytex).
- Registre justificativas ao cancelar faturas.
Faturas EFI Bank
Módulo dedicado às faturas enviadas via Gerencianet/EFI. Mostra callbacks e status em tempo real.
O que é
Visão detalhada das cobranças emitidas pelo gateway EFI, com logs das respostas da API.
Quando usar
- Conferir se o pagamento foi confirmado pela EFI.
- Gerar segunda via diretamente pelo painel.
- Investigar falhas de comunicação entre sistemas.
Como fazer
- Filtre por status (Pago, Pendente, Cancelado).
- Acesse o detalhe para ver logs e webhooks recebidos.
- Utilize ações para reenviar notificações ou atualizar status manualmente.
Dicas rápidas
- Verifique Config Sistema para garantir que os tokens estão corretos.
- Mantenha o webhook configurado na conta EFI.
Faturas Lytex
Controle das cobranças processadas pela Lytex, com logs específicos dessa integração.
O que é
Tela especializada que mostra status, retorno da API Lytex e possíveis erros.
Quando usar
- Verificar se houve falha na geração de boleto.
- Acompanhar faturas com status pendente de retorno.
- Refazer um envio que ficou em erro.
Como fazer
- Use filtros por data ou status para localizar faturas.
- Abra o detalhe para ver mensagem de erro ou comprovante.
- Se necessário, reenvie ou entre em contato com o gateway.
Dicas rápidas
- Confira as credenciais no módulo Config Sistema.
- Documente erros recorrentes para suporte Lytex.
Relatório Financeiro
Dashboards e exportações que mostram a saúde financeira: receitas, despesas e inadimplência.
O que é
Painel visual com gráficos, indicadores e filtros por período. Facilita reuniões gerenciais.
Quando usar
- Preparar relatório mensal de diretoria.
- Comparar receitas versus despesas.
- Monitorar inadimplência por faixa de atraso.
Como fazer
- Abra o relatório e selecione o período desejado.
- Use filtros (categoria, plataforma) para refinar a visão.
- Exporte para Excel/PDF se precisar compartilhar.
Dicas rápidas
- Verifique se lançamentos estão categorizados corretamente.
- Inclua notas explicando picos atípicos (ex: campanhas).
Servidores
Cadastro dos equipamentos de autenticação (PPPoE, Hotspot, IP) usados para entregar internet.
O que é
Banco de dados com os servidores (RouterOS, Radius, etc.) que o provedor utiliza.
Quando usar
- Cadastrar um novo concentrador de clientes.
- Atualizar IP ou credenciais após manutenção.
- Definir quais métodos de autenticação cada servidor suporta.
Como fazer
- Clique em “Adicionar servidor”.
- Informe nome, IP, porta, usuário e senha (com segurança).
- Associe planos e interfaces relevantes.
Dicas rápidas
- Mantenha histórico de alterações para auditoria.
- Combine com a equipe de rede antes de excluir um servidor.
Interfaces
Tabela de portas, VLANs ou bridges disponíveis nos servidores para autenticação IP Address.
O que é
Cadastro auxiliar que dá nomes amigáveis às interfaces de rede dos servidores.
Quando usar
- Ao instalar uma nova VLAN para clientes corporativos.
- Quando precisa identificar rapidamente a interface correta para IP fixo.
- Para evitar erros ao selecionar interface no cadastro da assinatura.
Como fazer
- Selecione o servidor relacionado.
- Cadastre o nome da interface (ex: VLAN 200 - Centro).
- Salve e utilize nas assinaturas IP Address.
Dicas rápidas
- Use padrão de nomenclatura (servidor + finalidade).
- Revise sempre que alterar configuração no Mikrotik.
IP Pool
Gerencia as faixas de IP disponíveis para autenticação PPPoE ou IP Address.
O que é
Cadastro das redes (ex: 192.168.100.0/24) com observações para uso interno.
Quando usar
- Adicionar nova faixa de IP comprada ou liberada.
- Atualizar descrição para indicar qual bairro ela atende.
- Verificar rapidamente qual pool está ligado a um plano.
Como fazer
- Clique em “Adicionar pool”.
- Informe faixa, máscara e observação.
- Associe ao servidor/plano correto.
Dicas rápidas
- Evite sobreposição de redes entre servidores.
- Mantenha documentado no campo observação.
Classe IP
Organiza faixas de IP em grupos lógicos (clientes, backbone, corporativos) para facilitar automações.
O que é
Uma classificação macro das faixas de IP. Ajuda a aplicar políticas ou filtros por grupo.
Quando usar
- Criar grupos de IP para relatórios.
- Organizar pools por finalidade (Residencial, Corporativo).
- Planejar migração de rede.
Como fazer
- Defina o nome da classe (ex: Empresas Premium).
- Cadastre faixa ou referência aos pools.
- Utilize nos relatórios ou automações.
Dicas rápidas
- Padronize nomenclatura para facilitar busca.
- Revise quando expandir rede para novas cidades.
Equipamentos
Inventário de modems, ONUs, roteadores e aparelhos instalados nos clientes.
O que é
Registro dos equipamentos com número de série, MAC e status (instalado, estoque, manutenção).
Quando usar
- Vincular um equipamento à assinatura do cliente.
- Rastrear onde cada aparelho está instalado.
- Controlar estoque e movimentações.
Como fazer
- Clique em “Adicionar equipamento”.
- Informe modelo, MAC address e status.
- Associe a um cliente/assinatura quando instalado.
Dicas rápidas
- Use o campo observação para registrar garantia.
- Combine com Assinaturas para saber quem está sem ONU.
Tenant
Administra provedores dentro da plataforma. Cada tenant possui configurações e limites próprios.
O que é
Cadastro mestre de cada empresa atendida. Define logotipo, dados fiscais, planos permitidos.
Quando usar
- Criar um novo provedor dentro do sistema.
- Atualizar dados de contato ou endereço fiscal.
- Definir limites de usuários, assinaturas e integrações.
Como fazer
- Abra a tela Tenant e clique em “Adicionar”.
- Preencha informações comerciais, fiscais e técnicas.
- Associe domínios, parâmetros padrões e recursos ativos.
Dicas rápidas
- Restrinja o acesso deste módulo a administradores.
- Documente alterações significativas em Activity Log.
Usuários
Gerencia quem pode acessar o painel, qual tenant pertence e quais permissões possui.
O que é
Cadastro de contas de acesso internas. Inclui nome, e-mail, senha, setor e nível de permissão.
Quando usar
- Dar acesso a um novo colaborador.
- Bloquear usuário desligado.
- Redefinir senha para alguém que esqueceu.
Como fazer
- Clique em “Adicionar usuário”.
- Informe nome, e-mail e selecione o tenant.
- Associe cargo ou permissões específicas.
- Envie instruções de acesso seguro.
Dicas rápidas
- Ative a opção “Trocar senha no primeiro acesso” quando necessário.
- Revise permissões semestrais ou após promoções.
Cargos
Conjuntos de permissões que você atribui aos usuários para definir o que cada um pode acessar.
O que é
Perfis prontos (ex: Financeiro, Suporte, Comercial) com permissões agrupadas.
Quando usar
- Criar um cargo para um novo departamento.
- Padronizar permissões para todos os analistas financeiros.
- Revisar acessos após mudança organizacional.
Como fazer
- Clique em “Adicionar cargo”.
- Defina nome e descrição simples.
- Selecione as funcionalidades (permissões) que o cargo terá.
Dicas rápidas
- Crie cargos por nível de acesso (Básico, Intermediário, Admin).
- Documente quais cargos exigem aprovação gerencial.
Funcionalidades
Lista completa de permissões individuais (ver, criar, editar, excluir) aplicáveis aos recursos.
O que é
A base granular de permissões que alimenta cargos e usuários. Ex: “Assinaturas - Editar”.
Quando usar
- Criar uma permissão específica para uma nova funcionalidade do sistema.
- Ajustar texto das permissões exibidas na interface.
- Controlar acesso quando não quer criar um novo cargo.
Como fazer
- Cadastre o nome da funcionalidade e descrição.
- Defina agrupamento (Clientes, Financeiro, etc.).
- Associe aos cargos e usuários conforme necessário.
Dicas rápidas
- Mantenha uma planilha com o mapeamento de permissões e cargos.
- Evite remover permissões sem checar cargos ligados.
Setores
Mapa dos departamentos internos. Ajuda a organizar chamados, usuários e relatórios.
O que é
Cadastro de setores como Suporte, Financeiro, Comercial. Usado em chamados e perfis de usuário.
Quando usar
- Criar um setor para uma nova equipe.
- Ajustar responsáveis por atendimento.
- Filtrar relatórios por setor.
Como fazer
- Clique em “Adicionar setor”.
- Informe nome e descrição.
- Associe usuários ou defina responsáveis direto em Chamados.
Dicas rápidas
- Mantenha os nomes alinhados com o organograma da empresa.
- Revise quando houver fusões ou alterações de equipe.
Configurações Gerais
Parâmetros básicos do sistema: logo, e-mail, notificações e preferências gerais.
O que é
Formulário central com ajustes de branding, comunicação e integrações gerais.
Quando usar
- Ao trocar a identidade visual ou dados de contato.
- Para configurar textos padrão de e-mail e WhatsApp.
- Quando ativar novas funcionalidades no painel.
Como fazer
- Acesse “Configurações Gerais”.
- Edite cada aba (Marca, Comunicação, Integrações) conforme necessário.
- Salve e teste os envios automáticos.
Dicas rápidas
- Documente alterações relevantes (ex: mudança de remetente de e-mail).
- Revise após migrações de domínio.
Config Sistema
Painel de ajustes avançados. Mexa aqui somente com autorização e registrando tudo.
O que é
Configurações técnicas que afetam integrações, limites, segurança e rotinas automáticas.
Quando usar
- Integrar com novos serviços externos (API).
- Ajustar limites de uso para tenants.
- Ativar funcionalidades beta do sistema.
Como fazer
- Revise a documentação da funcionalidade a ser ativada.
- Aplique alterações e registre o motivo no campo observação.
- Teste o comportamento em ambiente controlado antes de liberar.
Dicas rápidas
- Apenas administradores devem ter acesso.
- Após ajustes, monitore Activity Log para detectar anomalias.
API WhatsApp
Integração para envio automático de mensagens (cobrança, avisos de manutenção, chamados).
O que é
Tela onde você cadastra tokens, remetentes e templates utilizados nas notificações via WhatsApp.
Quando usar
- Configurar a API após contratar o serviço de mensageria.
- Atualizar token expirado ou telefone remetente.
- Testar novo template de mensagem (ex: cobrança amigável).
Como fazer
- Cadastre o token fornecido pelo parceiro de WhatsApp.
- Informe número remetente e nome exibido.
- Crie ou edite templates e faça um envio de teste.
Dicas rápidas
- Guarde tokens em local seguro (gestor de senhas).
- Integre com Chamados e Faturas para mensagens automáticas.
Modelos de Contrato
Biblioteca de textos padronizados utilizados na geração de contratos.
O que é
Armazena templates com placeholders (ex: {{cliente_nome}}) usados para gerar contratos rapidamente.
Quando usar
- Atualizar cláusulas conforme legislação.
- Criar versões diferentes (Residencial, Corporativo, Temporário).
- Padronizar idioma antes de disponibilizar ao time comercial.
Como fazer
- Clique em “Adicionar modelo”.
- Defina nome e cole o texto com placeholders.
- Salve, teste a geração e associe ao módulo Contratos.
Dicas rápidas
- Versão as alterações (ex: v1.2 - 2025).
- Peça validação do departamento jurídico.