Conectar Tapkey con Boris

Tapkey es de las integraciones más limpias: su modelo de grants encaja exactamente con una reserva.

1. Crear el cliente OAuth

1. Entrá al portal de Tapkey como propietario de la cuenta.
2. Creá una aplicación / cliente OAuth de tipo client credentials.
3. Asegurate de que tenga los scopes read:core:entities, write:core:entities, read:core:grants, write:core:grants y read:core:logs.
4. Copiá el client ID y el client secret.

2. Configurar en Boris

• Client ID y Client secret.
• Owner account ID (opcional): si lo dejás vacío, Boris usa la primera cuenta propietaria que el cliente pueda administrar.
• Identity provider ID: por defecto tapkey.com, que identifica a los contactos por email.

Boris pide el token a login.tapkey.com/connect/token y llama a my.tapkey.com/api/v1. Guardá → Probar conexión → Importar puertas (las bound locks de tu cuenta).

Qué hace Boris dentro de Tapkey

• Busca o crea un contacto con el email del cliente (POST /owners/{id}/contacts). El contacto se reutiliza entre reservas.
• Crea un grant por puerta con validFrom y validBefore (POST /owners/{id}/grants).
• Al cancelar, borra el grant. El contacto se conserva.
• Importa el registro de aperturas desde /owners/{id}/logEntries.

Cosas a tener en cuenta

• El email del cliente es obligatorio. Sin email no hay contacto y el acceso queda en «falló».
• Tapkey es Bluetooth: no hay apertura remota desde Boris. El cliente abre con la app de Tapkey (o tu propia app hecha con su SDK) estando frente a la puerta.
• El cliente tiene que instalar la app y aceptar la invitación antes de poder abrir; conviene avisarlo en el email de confirmación de la reserva.
• Cada cerradura consume licencia en tu plan de Tapkey; los grants no, pero revisá los límites de tu contrato.