Requisitos Magikey

É necessário que você já tenha uma conta Magikey cadastrada e que os dispositivos estejam instalados e configurados em seus respectivos ambientes.

  • Grupos de Acesso: O Conexa utiliza os grupos de acesso cadastrados na plataforma Magikey para realizar a liberação/bloqueio dos clientes. Cada grupo irá representar um ambiente a ser gerenciado pelo Conexa. É necessário que estes grupos já estejam devidamente cadastrados no painel da Magikey (aconselhamos nomear o grupo de acesso no Magikey com o mesmo nome do ambiente que deseja controlar).

Como funciona

A integração do Conexa com dispositivos de controle de acesso disponibiliza diversas funcionalidades.

  • Cadastro automático no dispositivo ao cadastrar uma pessoa no Conexa: Após o cadastro da pessoa no Conexa, seu e-mail e cpf será enviado para a plataforma do Magikey que enviará um e-mail solicitando para a pessoa a conclusão de cadastro diretamente na plataforma da empresa. Para que a notificação de cadastro seja enviada para a Magikey é necessário que a pessoa possua pelo menos 1 e-mail cadastrado no sistema. É necessário também que durante o cadastro da pessoa, seja solicitado seu CPF. a Magikey utiliza essas informações para a identificação dentro da plataforma

  • Log de acessos: No Conexa você poderá consultar o histórico de acesso dos seus clientes no dispositivo;

  • Gerenciamento de acesso à salas de reunião/salas rotativas: O Conexa irá liberar automaticamente o acesso à sala de reunião apenas para a pessoas vinculadas ao cliente da reserva. Após o horário da reserva, ou ao realizar o check-out da reserva, o sistema automaticamente irá bloquear o acesso desse cliente;

  • Restrição de acesso à salas privativas: Apenas as pessoas do cliente que possuem a sala privativa em seu contrato terão acesso a esta sala;

  • Registro de check-in automático no coworking;

  • Registro de check-out automático no coworking: Caso seu dispositivo seja uma catraca, você também poderá registar o check-out automático em seu coworking;

Para mais detalhes sobre como funciona a integração, recomendamos a leitura no artigo Como integrar um dispositivo de Controle de Acesso com o Conexa?

Token de Acesso

Para gerar um novo token de acesso, vá até o menu Configurações do painel de controle do Magikey e selecione a aba API. Clique no botão Novo Token e preencha o campo com o nome para identificação do mesmo.

Gerando novo token no Painel Magikey


Em seguida, clique em Criar e seu token será gerado. Copie o token gerado e guarde-o em segurança, pois ele não poderá ser visualizado novamente. Caso você o perca, não se preocupe, um novo token pode ser gerado a qualquer momento, seguindo os mesmos passos descritos até agora.

Token Magikey

Configuração

Para configurar um dispositivo Magikey acesse: Configurações → Dispositivos de Acesso e clique no botão Cadastrar Dispositivo de Controle de Acesso. No formulário, escolha a unidade e o ambiente onde o dispositivo está instalado. Caso seja um ambiente comum que não esteja listado (por exemplo, um dispositivo que esteja na portaria), marque a opção "Informar nome do ambiente" e no campo "Nome do Ambiente" digite um nome para identificá-lo.

  • Ambientes disponíveis: Você poderá escolher entre três tipos de ambiente: salas, coworkings ou outros. Cada uma destas opções é detalhada no artigo Como integrar um dispositivo de Controle de Acesso com o Conexa?

  • Marca do dispositivo: selecione Magikey;

  • Modelo do dispositivo: Escolha o modelo de integração utilizado no ambiente que você deseja controlar. Caso o ambiente possua apenas um leitor, selecione "leitor único", porém caso o ambiente possua um dois leitores (geralmente utilizado para identificar entrada e saída), selecione o modelo "dois leitores";

  • Tipo de Registro: escolha qual tipo de registro esse dispositivo irá realizar (entrada ou saída). Caso o dispositivo esteja instalado para registrar as pessoas que acessam o ambiente selecione entrada. Caso seja para registrar saídas, selecione a opção saída. Caso queira que o mesmo aparelho registre tanto a entrada quanto a saída das pessoas, selecione a opção 'Ambos (Entrada & Saída)'. Ao selecionar a opção Ambos é necessário um cuidado no registro correto de acesso daquela pessoa, pois a falta de um registro pode comprometer todo o comportamento daquela pessoa em um determinado dia. Caso o modelo do dispositivo escolhido seja o "dois leitores" o tipo de registro é definido automaticamente como "Ambos";

  • Nome do Dispositivo: insira um nome para o seu dispositivo para facilitar a identificação do dispositivo nos relatórios;

  • Token: informe o token gerado na plataforma Magikey para a integração com o conexa;

  • Fazer check-in automático: marque essa opção caso queira que o dispositivo realize os check-ins das pessoas de maneira automática com base nos registros de acesso do dispositivo. Caso queira que o dispositivo registe check-ins para clientes que possua reserva ou sala privativa, marque a opção "Registrar check-in mesmo que o cliente possua reserva ou sala privativa na unidade".


Configurando um dispositivo Magikey
  • Criar vínculo ao Grupo e Área de Acesso: após preencher as informações para cadastro do dispositivo, é feita uma conexão com o aparelho para buscar a lista de grupos e áreas cadastrados. Cada grupo e área de acesso representam um ambiente a ser controlado pelo Conexa. Selecione o grupo e a área a serem vinculados ao dispositivo que está sendo cadastrado.

Áreas de Acesso para Modelo com dois Leitores: Caso a você esteja cadastrando um dispositivo Magikey que utilize dois leitores (um para identificar entrada e outro para saída) você deverá selecionar duas áreas vinculadas. A "Área Entrada (Check-in)" será a área onde seu cliente estará entrando (ambiente sobre o qual o check-in é realizado, por exemplo, Sala 401). Já em "Área Saída (Check-out)" você deverá selecionar a área cadastrada na plataforma Magikey que indica a saída do ambiente.

Importante!

  • Ao vincular um dispositivo a um grupo de acesso as liberações ou bloqueios serão feitos com base nessa configuração. A EXCLUSÃO ou ALTERAÇÃO dos grupos de acesso irá interferir no funcionamento da integração do Conexa com seu dispositivo;


Após informar todas os dados necessários e clicar no botão "Cadastrar Dispositivo", caso não ocorra nenhuma falha, será exibida uma mensagem de sucesso e o dispositivo será cadastrado no Conexa.

Também existe a possibilidade de cadastrar um grupo e uma área individualmente em algum outro momento que desejar. Para isso, basta ir até Configurações > Integrações > Dispositivos de acesso.

Lá, você pode localizar seu dispositivo Magikey e clicar na coluna de Ações, para vincular a uma área ou a um grupo.

Teste de Conexão: Ao cadastrar ou editar um dispositivo, o Conexa tentará se realizar uma conexão com o mesmo. Caso esteja com problemas de conexão acesse nosso artigo Falha no Teste de Conexão do Módulo de Controle de Acesso.

Configuração Webhook

Os registros de acesso dos dispositivos Magikey são realizados através do envio de mensagens do dispositivo para o servidor do Conexa através de um 'webhook'. Para configurá-la, acesse Configurações -> Dispositivos de Acesso e selecione a ação Configurar Webhook no dispositivo de acesso que você configurou anteriormente. O modal exibido contém as informações de URL e Token que você deverá utilizar no próximo passo.

Em seguida, vá até o menu Configurações do painel de controle do Magikey e selecione a aba INTEGRAÇÕES. Role a página até encontrar o card Webhook de histórico e clique em Adicionar Webhook.

Webhook-add.png

Insira a URL e o Token que são exibidos no modal que você acabou de abrir no Conexa. Depois é só clicar em Salvar.

Pronto! Finalizadas essas etapas, a integração entre os dispositivos Magikey e o Conexa já deverá estar funcionando corretamente.

Encontrou a sua resposta?