—
Condomínios
—
Unidades
—
Moradores
—
Visitas hoje
Últimas visitas
Carregando...
Carregando...
Selecione um condomínio
Selecione um condomínio
Selecione um condomínio
Selecione um condomínio
Selecione um condomínio
Selecione um condomínio
Selecione um condomínio
💬
Selecione um condomínio
Cada condomínio tem seu próprio número de WhatsApp
🔑 Alterar Admin Secret
O Admin Secret é a senha mestra do sistema. Altere periodicamente por segurança.
📋 Admins cadastrados
Administrador Master
Acesso total ao sistema
🔒 Segurança
Secret atual
Sessão atual
—
Arquivo de credenciais
/root/portaria-v4-instalacao.txt
⚙️ Gerar configuração do dispositivo
Selecione o condomínio e gere um arquivo de configuração pronto para instalar no tablet.
📱 Como instalar no tablet Android
1
Instalar o Fully Kiosk Browser
Baixe na Google Play Store: Fully Kiosk Browser
Custo: ~R$ 75 (pagamento único por dispositivo)
Custo: ~R$ 75 (pagamento único por dispositivo)
2
Configurar a URL de início
No Fully Kiosk, defina a URL:
https://portariaapp.com.br3
Habilitar no Fully Kiosk
✓ Kiosk Mode (bloquear navegação)
✓ Camera Access (câmera frontal)
✓ Keep Screen On (tela sempre ligada)
✓ Start on Boot (iniciar com o tablet)
✓ Camera Access (câmera frontal)
✓ Keep Screen On (tela sempre ligada)
✓ Start on Boot (iniciar com o tablet)
4
Configurar o quiosque
Na tela inicial do app, toque em Configurar e insira os dados gerados ao lado ou importe o arquivo .json
✓
Pronto para usar!
O tablet está configurado. Teste chamando um morador antes de instalar na portaria.
🏢 Portaria Digital v4
Sistema completo de portaria inteligente com notificações via Telegram e WhatsApp
📥 Downloads e Manuais
📖
Abrir →
✈️
Abrir →
📄
Baixar PDF →
🔌
Abrir →
📄
Baixar PDF →
📱
Abrir →
📄
Baixar PDF →
Manual do Sistema
Guia completo para administradores
Ativar Telegram — Guia do Morador
Passo a passo para o morador ativar as notificações
Ativar Telegram — PDF
Versao para imprimir e entregar ao morador
Automacao de Portoes
Arduino ESP8266 e Sonoff com Tasmota
Automacao de Portoes — PDF
Guia completo com instrucoes tecnicas para download
Configurar Tablet Quiosque
Kiosk Browser Lockdown e modo nativo Android
Configurar Tablet — PDF
Guia para download e impressao
1. Primeiros passos — configuração inicial
Antes de colocar o sistema em funcionamento, siga esta ordem:
- Cadastrar o condomínio — vá em Condomínios → + Novo condomínio. Preencha nome, endereço e cor.
- Criar os blocos — dentro do condomínio, adicione os blocos (A, B, C...) se houver.
- Cadastrar as unidades — vá em Unidades, selecione o condomínio e adicione cada apartamento ou casa.
- Cadastrar os moradores — vá em Moradores, selecione condomínio e unidade, preencha os dados e salve para gerar o link do Telegram.
- Enviar o link do Telegram — copie o link gerado e envie para o morador pelo WhatsApp ou e-mail. O morador clica e o Telegram fica vinculado automaticamente.
- Cadastrar os portões — vá em Portões e cadastre cada portão com sua URL de webhook (endereço do controlador da fechadura).
- Configurar o tablet — vá em Download Quiosque, gere o token e siga as instruções de instalação.
2. Fluxo de uma visita
1️⃣
Visitante chega na portaria
Toca no tablet do quiosque e seleciona o tipo de visita (pessoal, entrega ou correspondência).
Toca no tablet do quiosque e seleciona o tipo de visita (pessoal, entrega ou correspondência).
2️⃣
Seleciona bloco e unidade
Navega pelos blocos e toca no número do apartamento ou casa desejado.
Navega pelos blocos e toca no número do apartamento ou casa desejado.
3️⃣
Câmera captura a foto
A câmera frontal do tablet fotografa o visitante automaticamente.
A câmera frontal do tablet fotografa o visitante automaticamente.
4️⃣
Morador recebe o alerta
Chega uma notificação no Telegram e/ou WhatsApp com a foto e botões: portão principal, garagem, recusar.
Chega uma notificação no Telegram e/ou WhatsApp com a foto e botões: portão principal, garagem, recusar.
5️⃣
Morador decide
Toca em um portão para abrir, ou em Recusar. O quiosque exibe o resultado em tempo real.
Toca em um portão para abrir, ou em Recusar. O quiosque exibe o resultado em tempo real.
✅
Visita registrada
Tudo fica no histórico em Visitas, com foto, horário, portão acionado e resposta do morador.
Tudo fica no histórico em Visitas, com foto, horário, portão acionado e resposta do morador.
3. Fluxo de entrega com guarda volumes
- Entregador seleciona Entrega no quiosque e escolhe a unidade.
- Morador recebe o alerta e toca em 📦 Usar guarda volumes.
- O sistema gera dois códigos: um para o entregador depositar e um para o morador retirar.
- O código do entregador aparece no quiosque. Ele digita no painel do guarda volumes e deposita.
- O morador recebe o código de retirada pelo Telegram/WhatsApp e retira quando quiser.
4. Financeiro e cobranças PIX
- Vá em Financeiro, selecione o condomínio e clique no botão Editar de uma unidade.
- Cadastre o valor da mensalidade, dia de vencimento e chave PIX do condomínio.
- Para cobrar um morador: botão 💳 Cobrar — envia mensagem com QR Code e código copia-e-cola pelo Telegram e WhatsApp.
- Para cobrar todos os inadimplentes de uma vez: botão 📨 Cobrar inadimplentes.
- Unidades bloqueadas não conseguem chamar visitantes pelo quiosque até regularizar o pagamento.
- O status atualiza automaticamente todo dia às 8h com base no vencimento cadastrado.
5. Configuração dos portões
Cada portão tem seu próprio webhook (endereço HTTP do controlador da fechadura).
- Tipo "Visita" — aparece para visitantes pessoais e prestadores de serviço.
- Tipo "Entrega" — aparece para entregas e correspondências.
- Tipo "Todos" — aparece em qualquer tipo de chamada.
- O botão Testar envia um disparo de teste para o webhook sem registrar visita.
- Compatível com: ESP32, ESP8266, Home Assistant, Node-RED, Shelly, e qualquer controlador com HTTP.
⚠️ Payload enviado ao webhook:
{"acao":"abrir_portao","portao_nome":"...","unidade":"101","visitante":"João","timestamp":"..."}
6. WhatsApp — conectar número por condomínio
- Vá em WhatsApp no menu.
- Selecione o condomínio no seletor do topo.
- Clique em 🔄 Gerar QR Code.
- Abra o WhatsApp no celular dedicado daquele condomínio.
- Toque em ⋮ → Aparelhos conectados → Conectar um aparelho.
- Escaneie o QR Code. A conexão fica ativa permanentemente no servidor.
💡 Use um número de WhatsApp dedicado para cada condomínio — não o número pessoal do síndico.
7. Perguntas frequentes
❓ O morador não recebe notificações
Verifique se o link do Telegram foi clicado e o bot respondeu. Para WhatsApp, veja se o número está correto com DDI (55 + DDD + número). Certifique-se que o canal preferido está configurado.
❓ O quiosque mostra "Sem conexão"
Verifique o Wi-Fi do tablet. Acesse https://portariaapp.com.br/health no navegador do tablet para confirmar que o servidor responde.
❓ O portão não abre ao acionar
Vá em Portões → Testar. Se o teste falhar, verifique a URL do webhook e se o controlador da fechadura está online.
❓ Como trocar o Admin Secret
Vá em Administradores → Alterar Admin Secret. O novo secret entra em vigor imediatamente e deve ser atualizado no .env do servidor.
❓ O QR Code do WhatsApp expirou
Clique em Gerar QR Code novamente. O sistema gera um novo automaticamente. O QR expira em ~60 segundos.
❓ Como adicionar um segundo tablet em uma portaria
Vá em Dispositivos → + Novo dispositivo, selecione o condomínio e gere um novo token. Cada tablet tem seu próprio token.
8. Comandos de manutenção do servidor
# Ver status geral
portaria-status.sh# Reiniciar a aplicação
pm2 restart portaria# Ver logs em tempo real
pm2 logs portaria# Fazer backup manual do banco
portaria-backup.sh# Ver status do WhatsApp (Docker)
docker psdocker logs evolution-api --tail 20