Configurar catracas e dispositivos

Cadastrar o equipamento, ler os estados do Conector OctaGym, sincronizar e reenviar cadastros, resolver catraca que não registra passagem, definir áreas restritas, limpar o parque herdado e ajustar a capacidade da Unidade.

Onde fica: Configurações → Sistema → Dispositivos — cadastro, saúde do Conector e manutenção. O dia a dia (passagens, ocupação, áreas) fica em Operação → Acesso → Catracas & Logs.

Antes de cadastrar

Confira a Unidade ativa

O dispositivo nasce vinculado à Unidade selecionada no topo. Se você criar na Unidade errada, ele não poderá ser editado nem removido pela lista da Unidade certa.

Equipamentos suportados

Fabricante	Situação	O que oferece
Hikvision	Disponível	Terminais faciais e catracas com integração ISAPI completa — facial, cartão, teste de conexão e configuração remota do webhook
Control iD	Disponível	Linha de acesso (iDFace, iDBlock) por REST — facial, cartão e sincronização pelo Conector
Genérico (Webhook)	Disponível	Qualquer fabricante através de uma ponte local que traduz o protocolo para eventos HTTP
Henry, Topdata Inner, Dimep Catrax	Em breve	Integração nativa em desenvolvimento — hoje passam pelo modo genérico

Fabricantes marcados como "em breve" aparecem na lista, mas o assistente recusa avançar com eles.

Cadastrar um dispositivo

Em Dispositivos, clique em Novo Dispositivo. O assistente tem quatro passos:

Equipamento — fabricante ou protocolo.
Configuração — nome (ex.: "Catraca Entrada Principal"), tipo, direção (Entrada e saída, Apenas entrada ou Apenas saída), IP e porta na rede local, local de referência, credenciais do terminal e a área controlada.
Revisão — confere o que vai ser gravado, inclusive o que a integração usa de verdade.
Validação — testa a conexão, gera a chave de autenticação e configura o webhook no terminal, conforme o que o fabricante suporta.

Ao editar um equipamento existente são três passos: o fabricante não é reperguntado, porque trocá-lo seria outro equipamento.

A área controlada é campo do passo Configuração, e vale a partir do cadastro

Deixar vazio significa entrada da unidade: o equipamento recebe a base inteira da Unidade e a passagem vira check-in. Escolhendo uma área restrita, ele recebe só quem tem direito àquela sala e a passagem não conta como check-in. Trocar isso depois é recusado enquanto o equipamento estiver ativo — acerte no cadastro.

Duas lacunas que causam "cadastrei e a catraca não gira" e aparecem na Revisão: senha em branco e, na Control iD, grupo de acesso não definido.

Depois de criado, o dispositivo pode ser inativado sem ser removido — útil para manutenção.

O Conector OctaGym

Equipamentos em rede local não são alcançados pela nuvem. Quem faz a ponte é o Conector, um serviço instalado num computador da academia que fica sempre ligado. Ele envia as passagens em tempo real e cadastra ou bloqueia rostos sozinho.

Onde fica: o card Conector OctaGym, no fim de Configurações → Sistema → Dispositivos. Ele mostra o estado, os computadores conectados e o papel de cada um (Líder ou Espera).

Os estados

Estado	O que significa	O acesso funciona?
Online	Ativo e sincronizando	Sim
Redundante	Dois computadores ativos, um Líder e um em Espera, com troca automática	Sim
Sem redundância	Só um computador online — não há reserva se ele cair	Sim
Sem líder — acesso parado	Nenhum computador assumiu o comando	Não: liberações de diária e de parceiro não chegam, e as passagens não são registradas
Líder parado — acesso travado	O computador no comando responde, mas parou de buscar trabalho na nuvem	Não, pelo mesmo motivo acima. Verifique a internet dessa máquina ou remova-a para outra assumir
Passagens atrasadas	As catracas registram, mas os eventos demoram a chegar	Aluno matriculado entra; liberação de parceiro e de visitante falha
Cadastros não chegam à catraca	A fila de cadastros travou	Quem já estava cadastrado entra; quem acabou de se matricular, trocar de foto ou ser liberado, não
Equipamento mudo	Um equipamento parou de enviar passagens enquanto os outros seguem	Quem passar por ele não será registrado
Com falhas	O serviço está ativo com uma pendência declarada	Depende da pendência; leia a frase do card
Offline	Sem contato há tempo demais	Não. Verifique se o computador está ligado e com internet
Desatualizado	Versão anterior à recomendada	Sim. Rode o comando de instalação uma vez; daí em diante atualiza sozinho
Não instalado	O Conector ainda não foi instalado nesta Unidade	As passagens só chegam se a catraca alcançar o servidor diretamente

O card avisa ainda quando o relógio do computador ou da catraca está fora de hora — isso desalinha o horário dos registros.

Antes de mexer no cadastro de qualquer aluno

Se todo mundo passou a levar acesso negado ao mesmo tempo, ou se as passagens sumiram do histórico, olhe primeiro o estado do Conector.

Sincronizar catracas

O botão Sincronizar catracas, no card do Conector, confere o que já está gravado em cada equipamento da Unidade e acerta a validade de cada pessoa: libera quem deve entrar e fecha quem não deve. É o botão de socorro da recepção quando alguém adimplente é barrado ou alguém que não deveria passa. Fica desabilitado com o Conector offline.

Ele não serve para encher uma catraca vazia:

numa catraca de saída, ele não cadastra rosto nenhum — só reabre a validade de quem já está no equipamento;
numa catraca de entrada, cadastra no máximo 100 rostos por vez.

Para a catraca que ficou sem os cadastros, use Reenviar cadastros.

Reenviar cadastros

No menu ⋮ de cada catraca, Reenviar cadastros manda de novo para aquele equipamento todas as pessoas que deveriam estar nele, com foto:

em catraca de área restrita, todo mundo que tem direito à área;
nas demais, quem já está gravado nas outras catracas da Unidade e falta nesta.

O Conector envia nos minutos seguintes. Use depois de a catraca ter ficado fora do ar ou recusando cadastros.

	Sincronizar catracas	Reenviar cadastros
Onde	Card do Conector	Menu ⋮ da catraca
Alcance	Todas as catracas da Unidade	Uma catraca
O que resolve	Validade errada: quem deve entrar é barrado, ou o contrário	Catraca sem os cadastros: não reconhece ninguém
Cadastra rosto	Entrada: até 100 por vez. Saída: não	Sim, todos os que faltam

Corrigir o IP, a porta ou a senha de um equipamento no cadastro, ou reativá-lo, já reenvia os cadastros sozinho — a mensagem de "Dispositivo atualizado" diz quantos foram.

A catraca não registra nenhuma passagem

Sintoma: no cartão do equipamento, Alcance na rede está verde, mas Eventos mostra Nenhuma passagem registrada e ninguém consegue passar. Não aparece nem acesso negado — a catraca não reconhece ninguém, então não tem o que registrar.

Webhook não configurado, com as outras catracas funcionando: quase sempre é a senha do equipamento. Ela diferencia maiúsculas de minúsculas — AMtech e amTECH são senhas diferentes. Abra Editar, confira a senha e salve.
Depois de corrigir a senha, ainda recusa: depois de várias tentativas erradas, o terminal Hikvision bloqueia o usuário admin por cerca de 30 minutos, e nesse tempo recusa até a senha certa. Espere o bloqueio passar ou desbloqueie pelo painel web do próprio equipamento, acessando o IP dele de um computador da rede da academia.
Webhook configurado e ainda nenhuma passagem: a catraca está sem os cadastros. Use Reenviar cadastros no menu ⋮ dela e acompanhe a passagem de alguém com acesso.

Clicar em Sincronizar várias vezes não resolve este caso

A sincronização acerta a validade de quem já está no equipamento. Catraca vazia precisa de Reenviar cadastros.

Manutenção do parque herdado

Numa implantação que veio de outro sistema, a catraca chega cheia de cadastros antigos. O card do Conector mostra quantos são e oferece o desfecho:

Suspender os sem dono — fecha os cadastros da catraca que não correspondem a nenhum aluno nem funcionário do OctaGym. É reversível: o rosto continua gravado e reabre em um clique. A confirmação diz quantos serão afetados e avisa que a escolha fica ligada para a Empresa.
Quando nenhum dado do equipamento identifica essas pessoas (numeração do fornecedor antigo, nome genérico gravado no terminal), a tela explica em vez de oferecer o botão: suspender tudo trancaria alunos e funcionários junto. O caminho é cadastrar a facial de quem ainda treina; os cadastros antigos duplicados vão se fechando sozinhos.

Aluno, funcionário e homônimos nunca são tocados.

Áreas restritas

Onde fica: Operação → Acesso → Catracas & Logs → aba Áreas restritas

Use para controlar quem entra em um espaço específico — sala de Hyrox, piscina, diretoria. O terminal da área recebe só a lista de quem tem direito, e a passagem não conta como check-in da academia.

Clique em Nova área e dê nome e descrição.
Vincule os equipamentos que a controlam, no cadastro de cada dispositivo. Área sem equipamento não bloqueia nada — a lista avisa isso.
Ligue o interruptor Controlar quem entra nesta área.
Defina o direito nas três abas: Alunos (planos que liberam, aulas agendadas, convênios e visitantes com passe ativo), Colaboradores (por cargo) e Exceções (pessoa a pessoa).

A área mostra em tempo real quantas pessoas entram ali, separadas em alunos, colaboradores e visitantes.

Controle ligado sem ninguém liberado tranca a sala

Com o interruptor ligado e nenhuma regra marcada, ninguém entra. A própria tela mostra o alerta — libere ao menos um plano, um cargo ou uma pessoa.

Capacidade e ocupação

No card Ocupação Atual de Catracas & Logs, edite a capacidade máxima da Unidade (de 1 a 10.000). Atingido o limite, a catraca passa a negar com o motivo capacidade.

O que o painel de acesso mostra

Entradas Hoje, Saídas Hoje, Acessos Negados e Horário de Pico.
Fluxo por Horário e Últimos 7 Dias.
Abas Últimos Acessos, Dispositivos e Áreas restritas.

Para leitura mais profunda (permanência, frequência semanal, mapa de calor, recortes por perfil), use Análise de Acessos.