Senha / Portão
Integração com o Hik-Connect: cada reserva confirmada ganha uma senha de 6 dígitos e/ou QR Code própria, válida só no horário do jogo e enviada pelo WhatsApp.
- Menu: Configurações › Acesso › Senha / Portão
- Plano: Avançado+
- Quem usa: Administrador
Nesta página (7)
Para que serve
Com o portão ligado ao Hik-Connect, cada reserva confirmada recebe uma senha própria de 6 dígitos e/ou um QR Code. A senha vale só perto do horário do jogo e é apagada quando a reserva é cancelada. Assim você não precisa mais divulgar uma senha fixa do portão.
Disponível nos planos Avançado e Completo.
Quem usa
Somente Administrador.
Passo a passo
Pegar as chaves no Hik-Connect
- Entre no Hik-Connect Teams (isa.hik-connect.com) com o Super User da Team.
- Vá em Team Management › API Integration e copie a Account (API Key) e a Password (API Secret).
Configurar no BQuadra
- Abra Configurações › Acesso › Senha / Portão.
- Cole a App Key (Account no Hik) e a Secret Key (Password no Hik).
- Confira a URL base da API.
- Clique em Salvar.
- Clique em Testar conexão. O resultado lista os dispositivos e os níveis de acesso da conta.
- Copie o número do nível de acesso com cronograma 24 h e cole em ID do nível de acesso (24 h).
- Escolha a Entrega ao cliente: Senha (PIN), QR Code ou Senha + QR.
- Ajuste Min. antes, Min. depois e Aberturas por portão.
- Clique em Salvar e depois clique em Integração até ficar Ligada.
Depois de ligar
- Confirme que Exigir pagamento antecipado está ligado em Configurar reservas.
- Se o bot do WhatsApp informava uma senha fixa, apague essa linha do texto do bot em WhatsApp.
Acompanhar os leitores
- Em Histórico dos leitores, veja cada leitor online ou OFFLINE e desde quando.
- A tabela mostra quando cada leitor caiu, quando voltou e quanto tempo ficou fora.
- Câmeras da mesma conta Hik-Connect também aparecem na lista. Quando uma câmera cai, o aviso é de câmera e não fala de senha: só o leitor decide se as senhas chegam ao portão.
- Clique em Atualizar para recarregar.
Campos importantes
- Integração — Ligada ou Desligada. Desligada, nada muda: vale a senha fixa de sempre.
- App Key / Secret Key — chaves da API do Hik-Connect. Ficam escondidas depois de salvas.
- ID do nível de acesso (24 h) — nível com os portões da academia e cronograma 24 h.
- Entrega ao cliente — o que o cliente recebe: senha, QR Code ou os dois.
- Min. antes — quantos minutos antes do início a senha passa a valer (padrão 20).
- Min. depois — quantos minutos depois do fim a senha ainda vale (padrão 15).
- Aberturas por portão — quantas vezes a senha abre cada portão (1 a 200, padrão 4).
Regras do sistema
- A senha só é emitida com a integração ligada, as chaves e o nível de acesso preenchidos e Exigir pagamento antecipado ligado. Sem pagamento antecipado, a tela mostra o aviso Senha do portão inativa.
- Recebem senha as reservas confirmadas e 100% pagas com cliente, as periódicas (mesmo sem pagamento) e as cortesias (valor zero). Bloqueios não recebem.
- Locação avulsa paga parcialmente não recebe senha. Quando a recepção dá baixa no restante, a senha é emitida e enviada em até 10 minutos.
- A senha é criada antes da mensagem de confirmação da reserva e enviada logo depois dela, pelo WhatsApp, só para o celular do cliente da reserva. A mensagem traz o horário em que a senha vale. Na reserva feita pela página de reserva, isso acontece logo após o pagamento, qualquer que seja a data do jogo.
- Reserva periódica (mensalista): criar a série não manda senha. Cada jogo recebe a sua senha 48 horas antes do horário, uma mensagem por semana.
- Reservas confirmadas sem mensagem (baixa manual na recepção, Marcar como Pago) e emissões que falharam são tentadas de novo a cada 10 minutos.
- Se o Hik-Connect der erro, a reserva continua confirmada. Os administradores recebem o aviso Falha ao emitir senha do portão e o sistema tenta de novo.
- Cancelar a reserva (pelo painel, pelo cliente ou ao gerar crédito) revoga a senha. Cancelar a série periódica ou encurtar a data final dela também revoga a senha que já tinha sido enviada.
- O cliente não consegue cancelar pelo portal depois que a senha começou a valer.
- A senha aparece para o cliente em Minha conta e para você ao abrir a reserva na Grade de Horários, com o horário de validade e o botão Reenviar, que manda de novo a mesma senha pelo WhatsApp do cliente (aparece Senha reenviada).
- Cliente sem celular cadastrado: a senha é emitida normalmente e fica na reserva, mas a mensagem não sai. Os administradores recebem o aviso Senha do portão sem WhatsApp (“cliente sem celular cadastrado; a senha está na reserva, envie manualmente”). Cadastre o celular do cliente e clique em Reenviar na reserva, ou passe a senha por outro meio.
- A cada 5 minutos o sistema consulta os leitores. Quando um leitor cai ou volta, os administradores são avisados no painel e pelo WhatsApp (quem tem número cadastrado nas notificações). O aviso de queda traz o dia e a hora em que a queda foi detectada. Com o leitor online, o sistema reenvia uma vez as senhas das reservas futuras.
- Câmera offline gera aviso próprio, de câmera, e não impede o reenvio das senhas: para o sistema, o portão está no ar quando pelo menos um leitor está online.
- O aviso de leitor ou câmera aos administradores vale 1 hora na fila de comunicação. Se o WhatsApp da academia estiver desconectado por mais tempo, ele expira e não sai depois; o painel continua mostrando a situação.
- Senhas vencidas há mais de um dia são apagadas do Hik-Connect de madrugada.
- Com a integração ligada, o bot do WhatsApp passa a orientar o cliente a procurar a senha na mensagem de confirmação (para mensalista, na mensagem que chega 48 horas antes de cada jogo) e não informa senha fixa.
Erros comuns e como resolver
- “Salve as chaves antes de ligar” → preencha App Key e Secret Key, clique em Salvar e depois ligue.
- “Salve App Key e Secret Key antes de testar” → salve as chaves antes de Testar conexão.
- “⚠️ ID do nível de acesso não encontrado na conta” → copie o ID certo da lista que aparece no teste.
- “Falha na conexão” → confira as chaves e a URL base da API. As chaves só aparecem para o Super User da Team.
- Na reserva aparece “A senha foi criada, mas a aplicação no leitor ainda precisa ser confirmada.” → o leitor ainda não recebeu a senha. Confira se ele está online em Histórico dos leitores.
- Leitor OFFLINE → verifique internet e energia do aparelho. Enquanto estiver offline, as senhas novas não chegam ao portão.
- Aviso Senha do portão sem WhatsApp → o cliente da reserva não tem celular cadastrado. Cadastre em Clientes e use Reenviar na reserva da Grade de Horários.
Dúvidas comuns
Liguei a integração e ninguém recebeu senha. Por quê?
A senha só funciona com Exigir pagamento antecipado ligado em Configurações › Reservas e locação › Formas de pagamento. Sem isso, nenhuma reserva recebe senha.
Quanto tempo a senha vale?
De Min. antes do início até Min. depois do fim do horário reservado. Com os valores padrão, 20 minutos antes até 15 minutos depois. Fora disso o portão recusa.
O que acontece se a reserva for cancelada?
A senha é revogada no Hik-Connect na hora do cancelamento. Vale também ao cancelar uma série periódica inteira ou encurtar a data final dela.
O cliente pode cancelar depois de receber a senha?
Pelo portal, só até a senha começar a valer. Depois disso, o cancelamento tem que ser feito pela academia.
O cliente pagou só uma parte da reserva. Ele recebe a senha?
Não. Na locação avulsa, a senha só é enviada quando a reserva fica 100% paga. Ao dar baixa no restante, a senha sai em até 10 minutos.
Mensalista recebe a senha de todas as semanas quando a série é criada?
Não. Na reserva periódica, cada jogo recebe a sua senha 48 horas antes do horário, uma mensagem por vez. Criar a série não manda senha nenhuma.
Reserva paga na recepção recebe senha?
Sim. O sistema verifica a cada 10 minutos as reservas confirmadas sem senha, emite a senha e manda pelo WhatsApp, sem esperar a data do jogo.
O cliente não tem celular cadastrado. A senha é emitida?
Sim. A senha é criada e fica na reserva, mas não há para quem mandar o WhatsApp. Os administradores recebem o aviso Senha do portão sem WhatsApp. Cadastre o celular no cliente e, na reserva aberta pela Grade de Horários, clique em Reenviar.
O cliente apagou a mensagem com a senha. Preciso cancelar e refazer a reserva?
Não. Abra a reserva na Grade de Horários e clique em Reenviar, ao lado da senha. A mesma senha vai de novo pelo WhatsApp do cliente.
O leitor do portão ficou sem internet. E as senhas?
Enquanto o leitor está offline as senhas não chegam ao portão. Os administradores são avisados, e quando o leitor volta o sistema reenvia as senhas das próximas reservas.
Obrigado! Que bom que ajudou.
Obrigado por avisar. Conte pelo WhatsApp o que faltou.