Conectar Akiles con Boris

Akiles es el sistema de accesos más común en coworkings españoles. Boris se conecta por OAuth o con una API key clásica.

1. Obtener credenciales

Opción A — API key (la más rápida): en el panel de Akiles, Ajustes → API, generá una clave y pegala en Boris. Akiles marca este método como obsoleto pero sigue funcionando.

Opción B — OAuth (la recomendada a futuro): pedí a Akiles un client ID y client secret, registrá como redirect URI la que Boris te muestra en la pantalla de la integración, guardá y pulsá Autorizar con Akiles. Boris pide los permisos full_read_write y offline, y renueva el token solo (los access tokens de Akiles duran una hora).

2. Configurar

• Site ID (opcional): limita la importación a una sede.
• Credencial que recibe el invitado:
  • Magic link — un enlace que abre la puerta desde el navegador. Sin app, sin cuenta. Lo mejor para invitados y salas.
  • PIN — Akiles genera un código único para el teclado.
  • Nada — si el cliente ya usa la app de Akiles con su email.

Guardá → Probar conexión → Importar puertas. En Akiles, cada cosa que se abre es un gadget: verás puertas, tornos y taquillas.

Qué hace Boris dentro de Akiles

• Crea un grupo de miembros por puerta («Boris · Nombre») cuya regla de permisos apunta a ese gadget y su acción open, habilitando todos los métodos (online, bluetooth, NFC, PIN y tarjeta).
• Por reserva crea un miembro con starts_at / ends_at, lo asocia al grupo y le emite el link mágico o el PIN.
• Si el cliente tiene email, se lo añade al miembro para que también pueda usar la app.
• Al revocar, Boris borra el miembro: eso elimina de una sola vez su asociación, su PIN y su link.
• La apertura remota usa POST /gadgets/{id}/actions/open.

Registro de aperturas

Akiles expone eventos, así que Boris importa el histórico de aperturas (botón Importar eventos de puerta, y automáticamente por cron). Verás qué gadget se usó, cuándo y por quién.

Cosas a tener en cuenta

• La apertura remota necesita que el dispositivo Akiles tenga internet; los modelos solo-Bluetooth no se abren desde la nube.
• Dos miembros activos no pueden compartir el mismo PIN. Boris deja que Akiles genere el código para evitar colisiones.
• Si borrás a mano el grupo «Boris · …», Boris lo vuelve a crear en el próximo acceso, pero los accesos ya emitidos contra el grupo viejo dejan de funcionar.