Ajuda › App do assinante e PWA

App do assinante e PWA

O App do assinante é um aplicativo com a marca da sua empresa, que o cliente instala no celular sem passar pela loja de aplicativos. Tecnicamente é um PWA (aplicativo web instalável).

O que o assinante faz no app#

• Atendimento: conversa com o robô e com a equipe, envia fotos e documentos e vê quando a equipe leu.
• Faturas: 2ª via com PIX copia e cola e código de barras (precisa do ERP conectado).
• Conexão: vê se cada contrato está conectado e pede desbloqueio de confiança.
• Chamado técnico: abre direto no ERP.
• Comunicados da empresa e notificações (só para quem aceitar).

Como ativar (para a empresa)#

1. Configure o domínio com HTTPS (obrigatório: senha e dados pessoais exigem conexão segura). Sem HTTPS o app mostra Disponível após configurar domínio com HTTPS.
2. Em Canais › Adicionar canal, escolha App do assinante. Cada empresa tem um canal App. Escolha o departamento e o fluxo automático.
3. Ajuste a marca: nome, nome curto, cores, mensagem de boas-vindas, texto da tela de abertura, política de privacidade (opcional) e o logo (veja "Logo e ícone do app" abaixo). Os ícones de vários tamanhos são gerados sozinhos a partir do logo.
4. Conecte o sistema do provedor em Integrações para liberar faturas, status, desbloqueio e chamados.
5. Teste no celular: abra o link, faça o primeiro acesso, converse e peça uma 2ª via.

Como o assinante entra#

O login é só com o CPF ou CNPJ, em uma tela só, sem senha e sem código (essa é a forma padrão):

1. O assinante informa o CPF ou CNPJ (o campo tem máscara e confere os dígitos) e aceita o aviso de privacidade.
2. O NexaChat consulta o sistema do provedor (ERP) com o token da empresa. Se for um assinante ativo, ele entra direto.
3. Se não for, aparece "Não encontramos seu cadastro", com o botão Sem cadastro — falar com o atendimento.
4. O aparelho fica conectado por 90 dias. No menu Mais há o botão Sair.

O que o app mostra, sempre mascarado: CPF ***.456.789-**, telefone *****-8888, e-mail l***@gmail.com e, do endereço, só bairro e cidade. Faturas e 2ª via continuam acessíveis.

Atenção, risco conhecido: como o CPF não é segredo, quem souber o CPF de um assinante consegue abrir o app dele (dados mascarados, faturas e desbloqueio). Por isso existem as proteções abaixo, e você pode endurecer a entrada a qualquer momento em Canais › App › Como o assinante entra: exigir a data de nascimento ou voltar ao código por WhatsApp/e-mail.

Proteções#

• Limites: 300 tentativas por IP (alto para redes com CGNAT) e 10 por CPF a cada 15 minutos.
• Varredura de CPFs: só conta CPF/CNPJ não encontrado no provedor: no máximo 10 por IP por hora (ajustável de 1 a 1000 em Canais › App). Quem entra com um CPF válido não conta. Em Faixas de IP confiáveis você cadastra o CGNAT do seu provedor (ex.: 100.64.0.0/10): essas redes têm limites 10 vezes maiores.
• Auditoria de todo acesso (Canais › App › Acessos recentes): data, CPF mascarado, IP, navegador e resultado (entrou, não encontrado, bloqueado por limite…).
• Sessão de 90 dias por aparelho (cookie seguro), com Sair e o administrador pode encerrar sessões.

Opções por empresa (Canais › App › Como o assinante entra)#

• Cadastro sem WhatsApp nem e-mail (no modo por código): a tela diz "Atualize seu cadastro com o provedor" e oferece o atendimento sem cadastro. O atendente também pode gerar um código manual (Canais › App › Código de acesso manual).
• Sem ERP conectado: o cadastro simples por telefone e senha continua como antes (o telefone não é verificado, então o assinante só vê os atendimentos feitos pelo próprio app).
• Senhas criadas antes continuam valendo por um período de transição (por API e apps nativos), mas a tela do app não pede senha.

Encerrar sessões (administrador)#

Em Canais › App › Sessões do app você vê quem está conectado (nome, final do CPF e número de aparelhos) e pode encerrar as sessões de um assinante ou de todos. A pessoa precisa pedir um código novo para voltar.

Logo e ícone do app#

O app usa um logo na tela de entrada e no topo, e gera sozinho os ícones do celular (192, 512, maskable e iPhone 180, 167, 152 e 120) e as telas de abertura do iPhone. Ordem de prioridade: logo enviado para este app (Canais › App › Logo do app) → logo da empresa (Configurações › marca, só PNG) → ícone genérico.

• Enviar o logo: aceita PNG, JPG, WEBP e SVG (até 8 MB; o painel converte para PNG no seu navegador, mostra a pré-visualização e só salva quando você clicar em Usar este logo). Um logo retangular (por exemplo, 1536×1024) funciona bem.
• Ícone do celular (só o símbolo): em Ícone do app envie uma imagem quadrada (mínimo 512×512; PNG, JPG ou WEBP) só com o símbolo, sem texto. Os ícones do celular usam o símbolo em tamanho grande; o logo completo continua na tela de entrada e no topo. Prioridade do ícone: ícone do app > logo do app > logo da empresa > genérico. Quem já instalou o app precisa reinstalar para ver o ícone novo.
• Logo da empresa (Configurações › Marca da empresa, por endereço): pode ser PNG, JPG ou WEBP; o NexaChat converte para PNG sozinho.
• Como o ícone é montado: o logo inteiro, sem distorcer, centralizado sobre a cor de fundo do app, com margem de 10%. O ícone maskable deixa o logo dentro da área segura (círculo central de 80%), e o do iPhone (180) não tem transparência.
• Atualização nos aparelhos: o endereço dos ícones leva uma versão (?v=…) que muda quando o logo ou as cores mudam, então os aparelhos pegam o ícone novo. Quem já instalou o app pode precisar reinstalar para ver o ícone novo na tela inicial.
• A tela Canais › App mostra os ícones gerados (clique para abrir em tamanho real).

Divulgar#

O endereço do app é https://SEU-DOMINIO/app/SEU-ENDERECO/ (com a barra no final). Em Canais › App você vê o link e o QR code. Imprima o QR na fatura e na loja, envie o link por WhatsApp e coloque um botão "Central do assinante" no site. Se alguém abrir o endereço sem a barra final, o NexaChat corrige sozinho.

Use Comunicados para avisar manutenções e campanhas: quem aceitou notificações recebe no celular.

Instalar no celular#

Android (Chrome): abra o link, toque em Instalar (aparece na tela ou no menu Mais do app) e confirme.

iPhone (Safari):

1. Abra o link no Safari (não funciona por outro navegador para instalar).
2. Toque no botão Compartilhar.
3. Escolha Adicionar à Tela de Início e confirme.
4. As notificações no iPhone só funcionam depois de instalar o app na tela de início.
5. Já tinha instalado antes e o ícone ficou sem o logo (ou com o logo antigo)? O iPhone guarda o ícone na hora da instalação e não o atualiza sozinho. Apague o atalho antigo (segure o ícone na tela de início › Remover app › Apagar da Tela de Início) e adicione de novo pelo Safari: abra o link do app, toque em Compartilhar e depois em Adicionar à Tela de Início. O NexaChat entrega o ícone, o nome e as cores da marca já na página, e o iPhone os lê na instalação. Se o logo da empresa mudar depois, repita este passo.

Para as notificações, o servidor precisa das chaves de envio (VAPID). Sem elas o app funciona normalmente, só sem notificações. Quem cuida do servidor encontra o passo a passo em docs/APP-ASSINANTE.md.

Privacidade do assinante#

No primeiro acesso ele aceita o aviso de privacidade. Os dados aparecem mascarados na tela e há um botão para excluir os dados do app. O histórico de atendimento fica com a empresa, como base legal de guarda.

Painel da equipe no celular (/atendimento/)#

A equipe também pode instalar o painel como aplicativo:

1. No celular, abra https://SEU-DOMINIO/atendimento/ (entre com o seu usuário).
2. No Android, toque em Instalar. No iPhone, use Compartilhar › Adicionar à Tela de Início.

Esse aplicativo não guarda conversas nem dados pessoais no aparelho: tudo é buscado na hora, pela internet.

A Central do assinante, tela por tela#

O app é simples e tem só o essencial: quatro abas (Início, Faturas, Atendimento e Perfil), além do sino de notificações no topo. Não há teste de velocidade nem painel de ferramentas para o cliente.

Início#

• Saudação com o primeiro nome, o plano e a situação do contrato (e o dia de vencimento).
• Fatura em aberto: valor, vencimento e o botão Pagar, que mostra o PIX copia e cola, o QR code e o boleto (linha digitável e PDF). Sem fatura, aparece “Tudo em dia ✓” (o texto é seu, em Canais › App).
• Aviso de rede quando há incidente ou manutenção na região do cliente.
• Acesso rápido: Minhas faturas, Promessa de pagamento, Central de atendimento, Nossos planos, Termos e contratos e Status da rede. Você escolhe quais aparecem e a ordem em Canais › App › Início e acesso rápido.
• Destaques: carrossel de banners.

Promessa de pagamento#

É o desbloqueio de confiança do ERP. O cliente confirma, e vale só com contrato bloqueado ou fatura vencida, uma vez a cada 30 dias por contrato. O ERP pode recusar pelos limites dele, e a mensagem aparece para o cliente. Em testes (Simulador) ela é simulada.

Faturas#

Abas Abertas, Pagas e Todas, com 2ª via, PIX e link do boleto/comprovante.

PIX com baixa automática (opção por empresa, desligada)#

Em Canais › App › Início e acesso rápido, ligue PIX com baixa automática somente se o seu ERP dá baixa automática nos PIX. Com ela ligada, o pagamento mostra “Pagou com PIX? A liberação é automática em poucos minutos.”; depois que o cliente copia o PIX ou abre o QR, o NexaChat acompanha a fatura no ERP (consultas com espera crescente, por até 24 horas) e, quando a baixa chegar, envia “Pagamento confirmado! Sua conexão já está liberada.” (push e sino) e atualiza o início. Tudo fica na auditoria, sem dados sensíveis.

Destaques (banners)#

Em Canais › App › Destaques você envia imagens (PNG, JPG ou WEBP) com título, link, período de exibição e ordem. Só aparece o que você cadastrar: o NexaChat não coloca banners de terceiros.

Nossos planos#

Cadastre os planos (nome, velocidade, preço, descrição) em Canais › App › Nossos planos. Ao tocar em Quero mudar, o cliente abre um atendimento já com o plano escolhido.

Status da rede#

Em Canais › App › Status da rede você cadastra incidentes e manutenções (região/bairro, início e previsão). Eles aparecem como aviso no Início, na tela Status da rede (item do Acesso rápido) e geram notificação para os clientes da região (o endereço do contrato é comparado com as regiões informadas; vazio = todos). Ao marcar como resolvido, os clientes recebem “Normalizado”.

Recursos opcionais (desligados por padrão)#

Em Canais › App › Início e acesso rápido, cada empresa pode ligar Minha Wi-Fi (nome e senha da rede, com confirmação e registro) e Consumo de internet. Quando ligados, aparecem na aba Perfil. Exigem um ERP com essas funções (SGP/IXC).

Notificações (sino)#

Histórico de tudo o que o app enviou, com marcação de lidas (funciona mesmo sem permitir push).

Perfil#

Plano e dia de vencimento, tema (automático, claro ou escuro), notificações e instalação do app, e “Solicitar exclusão dos meus dados” (LGPD): cria um pedido com protocolo e prazo (padrão de 15 dias, configurável). O provedor atende em Canais › App › Pedidos de privacidade. Nada é apagado automaticamente, e os dados fiscais e de cobrança são mantidos por obrigação legal.

Personalização#

Cores (destaque e fundo), logo, ícone, nome, mensagem de boas-vindas, saudação do início e o texto de “sem fatura” são por empresa e aparecem em todo o app.