Manual do Sistema
Portaria Digital

O Portaria Digital v4 é um sistema completo de gestão de acesso para condomínios. Permite que visitantes se identifiquem na portaria (pelo quiosque físico ou QR Code) e que moradores autorizem ou recusem a entrada remotamente pelo celular — via Telegram, WhatsApp ou App próprio (PWA).

Canais de Notificação

Endereço de acesso

O painel administrativo está disponível em:

Navegação principal

Cadastrar um novo condomínio

1. 1
   Acesse o menu CondomíniosClique em "Condomínios" no menu lateral esquerdo
2. 2
   Clique em "+ Novo condomínio"Botão azul no canto superior direito da lista
3. 3
   Preencha o nomeEx: "Residencial Solar" ou "Edifício Central"
4. 4
   SalveClique em "Salvar". O condomínio aparecerá na lista.

Cadastrar unidades

1. 1
   Selecione o condomínioUse o seletor no topo da tela de Unidades
2. 2
   Clique em "+ Nova unidade"Preencha o número (ex: 101, 224B) e o tipo (apartamento ou casa)
3. 3
   Associe ao bloco (opcional)Se o condomínio tem blocos, selecione o bloco correspondente

Moradores são as pessoas que recebem as notificações de visita e podem autorizar ou recusar o acesso remotamente.

Cadastrar morador

1. 1
   Acesse Moradores e selecione o condomínioUse o seletor no topo
2. 2
   Clique em "+ Novo morador"Botão azul no canto superior direito
3. 3
   Preencha os dadosNome, telefone, unidade, canal preferido e ordem de chamada
4. 4
   SalveUm token PWA é gerado automaticamente para o morador

Configurações do morador

Enviar link do App PWA ao morador

O App PWA permite que o morador receba notificações e autorize visitas sem precisar do Telegram.

1. 1
   Na lista de moradores, clique em "📱 PWA"Botão ao lado do botão Editar de cada morador
2. 2
   O link é copiado automaticamenteUma confirmação verde aparece no botão: "✅ Copiado!"
3. 3
   Envie o link para o morador via WhatsAppCole o link copiado e envie pelo seu WhatsApp pessoal
4. 4
   O morador instala o appAbre o link, segue as instruções de instalação e ativa as notificações

Vincular Telegram ao morador

1. 1
   Edite o morador e clique em "Gerar link Telegram"Botão verde no rodapé do modal de edição
2. 2
   Copie o link geradoClique em "📋 Copiar link"
3. 3
   Envie o link ao moradorO morador abre o link no Telegram e clica em "Iniciar"
4. 4
   Vinculado!O status muda de "Pendente" para "Vinculado" na lista de moradores

Cascata de notificação

Quando há múltiplos moradores em uma unidade, o sistema notifica em sequência (cascata) conforme a ordem configurada:

Portões são os pontos de acesso que podem ser acionados remotamente quando um morador autoriza uma visita.

Cadastrar portão

1. 1
   Acesse Portões e selecione o condomínio
2. 2
   Clique em "+ Novo portão"
3. 3
   Preencha nome, ícone e URL do webhookO webhook é o endereço que o sistema chama para abrir o portão
4. 4
   Configure os tipos de visitaQuais tipos de visita podem acionar este portão (visita, entrega, serviço)

Dispositivos são os quiosques físicos instalados na portaria do condomínio.

Cadastrar dispositivo

1. 1
   Acesse Dispositivos e clique em "+ Novo dispositivo"
2. 2
   Dê um nome e selecione o condomínioEx: "Portaria Principal", "Entrada Lateral"
3. 3
   Salve e anote o token geradoO token é necessário para configurar o quiosque

Configurar o quiosque

1. 1
   Abra o quiosque emhttps://portariaapp.com.br
2. 2
   Clique em "⚙️ Configurar"Uma senha será solicitada (fornecida pelo administrador do sistema)
3. 3
   Preencha os camposURL do servidor, Token do dispositivo e ID do condomínio
4. 4
   Salve e aguarde reiniciarO quiosque carrega as informações do condomínio automaticamente

Modo QR Code

No modo QR Code, um código é exibido na tela da portaria. O visitante escaneia com o celular e realiza a identificação pelo próprio aparelho.

Fluxo pelo Quiosque Físico

Tipos de visita

O que o morador pode fazer ao receber a notificação

O App do Morador é um aplicativo instalável no celular que permite receber notificações e responder visitas sem precisar do Telegram ou WhatsApp.

Como o morador instala o app

No Android (Chrome)

1. 1
   Morador recebe o link via WhatsAppAdmin copia o link pelo botão 📱 PWA e envia
2. 2
   Abre o link no ChromeA página de instalação aparece com instruções
3. 3
   Toca em "📲 Instalar app"O Chrome mostra uma janela de confirmação
4. 4
   Confirma a instalaçãoO ícone "Portaria Digital" aparece na tela inicial do celular
5. 5
   Ativa as notificaçõesNa tela de Config do app, ativa o toggle de notificações push

No iPhone (Safari)

1. 1
   Abre o link no SafariObrigatório usar o Safari — outros navegadores não permitem instalação no iOS
2. 2
   Toca no ícone de compartilharÍcone de quadrado com seta ↑ na barra inferior
3. 3
   Seleciona "Adicionar à Tela de Início"Role a lista de opções para baixo se não aparecer
4. 4
   Confirma tocando em "Adicionar"O ícone aparece na tela inicial
5. 5
   Sempre abrir pelo ícone instaladoAs notificações funcionam apenas quando o app é aberto pelo ícone, não pelo Safari

Funcionalidades do app

O módulo de guarda-volumes permite receber encomendas mesmo quando o morador não está em casa.

Fluxo de entrega

Retirada pelo morador

1. 1
   Morador recebe código de retiradaEnviado via Telegram, WhatsApp ou App PWA
2. 2
   Acessa a portariaSeleciona "📦 Retirar encomenda do guarda-volumes" na tela inicial
3. 3
   Digita o código de retiradaCódigo pessoal e intransferível recebido na notificação
4. 4
   Compartimento é indicadoO número do compartimento aparece na tela para retirar a encomenda

Cadastrar guarda-volumes no admin

1. 1
   Acesse "Guarda Volumes" no menu
2. 2
   Clique em "+ Novo guarda-volumes"Informe o nome e o número de compartimentos
3. 3
   Os compartimentos são criados automaticamenteCada compartimento tem número e status (livre/ocupado)

Configurar plano de pagamento

1. 1
   Acesse Financeiro e selecione o condomínio
2. 2
   Defina o valor e a data de vencimentoPor unidade, mensal
3. 3
   Gere as cobrançasO sistema cria cobranças PIX individuais por unidade

Consultar histórico

1. 1
   Acesse "Visitas" no menu
2. 2
   Selecione o condomínio e aplique filtrosFiltros por data, tipo de visita e status
3. 3
   Clique em uma visita para ver os detalhesIncluindo foto do visitante, horário e como foi respondida

Status possíveis

O sistema usa a Evolution API para enviar mensagens via WhatsApp. A conexão deve estar ativa para que as notificações sejam enviadas.

Verificar status da conexão

1. 1
   Acesse "WhatsApp" no menu lateral
2. 2
   Verifique o statusDeve aparecer "✅ Conectado". Se aparecer "Desconectado", siga os passos abaixo.

Reconectar WhatsApp

1. 1
   Clique em "Reconectar" ou "Ver QR Code"
2. 2
   Abra o WhatsApp no celularConfigurações → Aparelhos conectados → Conectar aparelho
3. 3
   Escaneie o QR Code exibido na tela
4. 4
   Aguarde a conexão ser estabelecidaO status muda para "Conectado" em alguns segundos

O morador não está recebendo notificações

1. 1
   Verifique o canal preferidoNo admin, edite o morador e confirme o canal configurado
2. 2
   Para Telegram: verifique se está vinculadoStatus deve ser "Vinculado" na lista de moradores
3. 3
   Para PWA: peça para renovar a subscriptionApp → Config → desativar e reativar notificações
4. 4
   Para WhatsApp: verifique a conexãoMenu WhatsApp no admin

O portão não está abrindo

1. 1
   Verifique se o webhook está configuradoMenu Portões → edite o portão → URL do webhook
2. 2
   Verifique se o controlador do portão está onlineO dispositivo que controla o portão deve estar ligado e conectado

A visita ficou "Expirada" sem que ninguém respondesse

Isso acontece quando todos os moradores da unidade foram notificados mas não responderam no tempo limite (45 segundos cada). Verifique se os moradores estão recebendo as notificações e se os dados de contato estão corretos.

Como adicionar mais de um morador por unidade?

Cadastre múltiplos moradores vinculados à mesma unidade. Configure a ordem de chamada (1º, 2º, 3º...) para definir a sequência de notificação em cascata.

O quiosque está mostrando erro de conexão

1. 1
   Verifique a internet do dispositivo
2. 2
   Confirme se o servidor está onlineAcesse portariaapp.com.br no browser
3. 3
   Recarregue a página do quiosqueF5 ou Ctrl+R