Pular para o conteúdo
BQuadra·Ajuda

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

  1. Entre no Hik-Connect Teams (isa.hik-connect.com) com o Super User da Team.
  2. Vá em Team Management › API Integration e copie a Account (API Key) e a Password (API Secret).

Configurar no BQuadra

  1. Abra Configurações › Acesso › Senha / Portão.
  2. Cole a App Key (Account no Hik) e a Secret Key (Password no Hik).
  3. Confira a URL base da API.
  4. Clique em Salvar.
  5. Clique em Testar conexão. O resultado lista os dispositivos e os níveis de acesso da conta.
  6. Copie o número do nível de acesso com cronograma 24 h e cole em ID do nível de acesso (24 h).
  7. Escolha a Entrega ao cliente: Senha (PIN), QR Code ou Senha + QR.
  8. Ajuste Min. antes, Min. depois e Aberturas por portão.
  9. Clique em Salvar e depois clique em Integração até ficar Ligada.

Depois de ligar

  1. Confirme que Exigir pagamento antecipado está ligado em Configurar reservas.
  2. Se o bot do WhatsApp informava uma senha fixa, apague essa linha do texto do bot em WhatsApp.

Acompanhar os leitores

  1. Em Histórico dos leitores, veja cada leitor online ou OFFLINE e desde quando.
  2. A tabela mostra quando cada leitor caiu, quando voltou e quanto tempo ficou fora.
  3. 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.
  4. 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.

Esta página ajudou?