Ir al contenido principal

Guía para Configurar la Llave Virtual en CrossHero

Escrito por Pablo Cantero

La Llave Virtual de CrossHero permite a los centros gestionar el acceso a sus instalaciones de forma eficiente y segura, sin lectores de códigos ni dispositivos adicionales. Con esta funcionalidad puedes controlar puertas o torniquetes mediante dispositivos conectados que funcionan con relés, simplificando el acceso tanto para los administradores como para los clientes.

Con dispositivos como el Shelly Pro 1, que funciona por conexión LAN, la conexión es más estable incluso en lugares con poca señal Wi-Fi. Además, desde CrossHero puedes configurar y administrar cada puerta o torniquete directamente, con un control centralizado y sin hardware costoso o complejo.

En las siguientes secciones te explicamos cómo activar y configurar la Llave Virtual y vincular tus dispositivos.

¿Cómo activar y desactivar la Llave Virtual en tu centro?

  1. Ve a Admin → Configuraciones → Cuenta → Configuraciones y activa la casilla Activar Llave Virtual.

  2. Aparecerá un submenú Llave Virtual. Al pulsar cualquiera de sus opciones irás directamente a las opciones de activación.

La cuota mensual o anual del servicio se cobra junto con la suscripción de CrossHero.

Para cambiar de paquete o desactivarlo, ve a Admin → Llave Virtual → Configuración, pulsa los tres puntos y elige Activa la Llave Virtual.

Una vez dentro, puedes cambiar de paquete con el botón Activar o desactivarlo con el botón Cancelar.

Detalles importantes sobre el cobro de este servicio

  • Cobro adelantado: la cuota mensual de la Llave Virtual se cobra por adelantado, en la moneda local de tu región. Es decir, cada mes se paga el mes siguiente.

  • Proporcionalidad en el primer mes: si activas el servicio a mitad de tu periodo de facturación, puedes recibir un cargo proporcional al tiempo transcurrido desde la activación hasta tu próxima fecha de facturación habitual. Por ejemplo, si normalmente pagas el día 10 de cada mes y activas el servicio el día 20, se te cobrará el periodo entre el día 20 y el 10, junto con el siguiente mes completo.

  • Renovación automática: el servicio se renueva automáticamente cada mes mientras esté activo. Si decides no continuar, desactívalo antes de la fecha de facturación para evitar cobros adicionales.

  • Factores externos: CrossHero no controla los cambios en tasas de cambio, impuestos locales o tarifas de entidades bancarias o tarjetas de crédito. Es responsabilidad del administrador del centro conocer y gestionar estas condiciones.

Importante: cancelar el servicio es responsabilidad del centro. Si no se cancela, los cobros se seguirán realizando de forma automática.

¿Dónde comprar el dispositivo Shelly compatible?

Configurar el dispositivo Shelly

  1. Descarga la app de Shelly.

  2. Añade el dispositivo en la app siguiendo las instrucciones hasta conectarlo a internet (LAN o Wi-Fi).

Acceder a la configuración del dispositivo

  1. Abre la IP del dispositivo en tu navegador (en el ejemplo de arriba: http://192.168.1.110). Desde esa dirección configurarás el dispositivo para conectarlo con CrossHero.

  2. Copia el Device Channel (en el ejemplo de arriba: "0"). Lo necesitarás más adelante.

Actualizar el firmware del Shelly

  1. Con la IP del dispositivo abierta en el navegador, ve a Settings → Firmware.

  2. Comprueba que el firmware sea la versión 1.4.4. Si no lo es, actualízalo hasta llegar a esa versión. Puede que tengas que actualizarlo más de una vez.

Configurar MQTT

Activa la configuración MQTT con estos valores:

  • Connection type: Default TLS.

  • MQTT prefix y Client ID: déjalos como están y cópialos. Los necesitarás más adelante.

  • Server: a2msj3wg09ukd6-ats.iot.us-east-1.amazonaws.com

Configurar TLS

  1. En TLS, sube los siguientes certificados:

    • Custom certificate authority (CA) PEM bundle: ca.pem

    • Custom client certificate: certificate.pem.crt

    • Custom client key: client.pem.key

  2. Reinicia el dispositivo.

Puedes descargar estos certificados desde CrossHero: ve a Admin → Llave Virtual → Configuración, pulsa los tres puntos y elige Nuevo.

Configurar la Llave Virtual en CrossHero

  1. Ve a Admin → Llave Virtual (CrossHero Llave Virtual) y pulsa el icono [+] para añadir una nueva llave.

  2. Completa los campos:

    • Nombre: identifica la puerta (por ejemplo, "Recepción" o el nombre de la calle).

    • Client ID: el valor copiado del Shelly.

    • Channel ID: el Device Channel (por ejemplo, "0").

    • Permitir abrir puerta para: elige quién puede abrir la puerta.

  3. Prueba los botones Abrir puerta y Cerrar puerta.

  4. Guarda la llave virtual.

Client ID:

Channel ID:

La Llave Virtual también permite limitar el acceso a través de check-ins. Consulta cómo configurarlo en ¿Cómo limitar el acceso a tu centro deportivo a través de check-ins?

Filtrado por programa

Puedes configurar cada puerta para que solo la abran los clientes con una suscripción activa o una reserva vigente en determinados programas de tu centro.

Así puedes dividir los espacios físicos según el tipo de actividad, de modo que cada cliente acceda únicamente a las zonas de su programa.

¿Cómo se configura?

En la configuración de la puerta encontrarás la sección Programas habilitados. Allí puedes:

  • Seleccionar uno o más programas en un menú desplegable con búsqueda.

  • Aplicar esta condición como un filtro adicional que se suma a las demás reglas ya configuradas (horario, reserva o geolocalización).

¿Cómo funciona?

Según la opción elegida en Permitir abrir puerta para, se aplica una lógica distinta:

  • Todos los clientes + programas seleccionados: solo abren la puerta los clientes con una suscripción activa en alguno de los programas seleccionados.

  • Solo clientes con reserva + programas seleccionados: solo abren la puerta los clientes con una reserva vigente en alguno de los programas seleccionados.

  • Clientes dentro de un horario + programas seleccionados: solo abren la puerta los clientes que están dentro del horario configurado y tienen una suscripción activa en los programas seleccionados.

En todos los casos esta condición es opcional y complementaria a las demás configuraciones. Los perfiles de administrador, staff y coach no están limitados por esta regla: siguen teniendo acceso completo.

Activar la apertura por geolocalización (beta)

CrossHero permite restringir el uso de la Llave Virtual según la ubicación del cliente: configuras una distancia máxima desde la cual el cliente puede abrir la puerta.

Para activarla, sigue estos pasos en la configuración de cada llave virtual:

  1. Marca la casilla Activar geolocalización (Beta).

  2. Comprueba que la dirección cargada sea correcta y que la ubicación en el mapa coincida con la posición real de la puerta.

  3. Si hace falta, mueve el marcador en el mapa para ajustar la ubicación con más precisión.

  4. Establece una distancia máxima para apertura (en metros). Recomendamos un mínimo de 50 metros, ya que la precisión varía según el móvil del cliente.

Importante: prueba esta funcionalidad desde un móvil, ya que la geolocalización en ordenadores de escritorio es muy imprecisa. Los perfiles de administrador no están sujetos a restricciones geográficas, así que la prueba debe hacerse con un perfil de cliente real o de prueba.

Probar la Llave Virtual como cliente

  1. Abre CrossHero Llave Virtual o ve al menú Llave Virtual.

  2. Selecciona la puerta configurada y prueba a abrir y cerrar. En esta vista también puedes ver tus últimos 5 check-ins.

¿Ha quedado contestada tu pregunta?