Salto KS (la plataforma cloud de Salto, antes Clay) se integra por su Connect API. Es la integración con más burocracia de las seis: las credenciales no se generan solas.

1. Pedir credenciales

El client ID y el client secret los emite tu Salto Business Unit local (el distribuidor/partner que te vendió el sistema). Pediles acceso a la Connect API indicando que vas a integrar un software de gestión de espacios. Te darán credenciales para el entorno accept (sandbox real, muy recomendable para probar) y luego para producción.

Necesitás también el Site ID: es el UUID de tu sede dentro de Salto KS.

2. Configurar en Boris

  • Client ID y Client secret.
  • Entorno: Accept/sandbox para pruebas, Producción EU cuando pases a real.
  • Site ID: obligatorio. Boris administra únicamente cerraduras y usuarios de ese site.
  • Identity server / API base URL: solo si tu Business Unit te asignó hosts distintos a los estándar.

Boris pide un token con client credentials al identity server y lo envía como Authorization: Bearer. Guardá → Probar conexión → Importar puertas.

Qué hace Boris dentro de Salto KS

Salto no permite poner fecha de validez a un usuario dentro de un grupo compartido: la vigencia vive en el time schedule del grupo de acceso. Por eso Boris crea un grupo de acceso por reserva:

  1. POST /v1.2/sites/{site}/access_groups con el nombre «Boris · BK-123».
  2. Le añade la cerradura de la reserva (POST …/access_groups/{id}/locks).
  3. Le pone un time schedule con la fecha y hora de inicio y fin de la reserva (POST /v1.1/…/time_schedules).
  4. Busca al usuario por email o lo crea (POST /v1.2/sites/{site}/users) y lo mete en el grupo.

Revocar significa borrar ese grupo: el usuario se conserva, así que un cliente recurrente no recibe una invitación nueva cada vez.

La apertura remota usa PATCH /v1.2/sites/{site}/locks/{id}/locking con locked_state: open, y requiere que el token tenga el permiso REMOTE_LOCKING.

Cosas a tener en cuenta

  • Los usuarios nuevos reciben una invitación por email de Salto para crear su perfil y activar la llave digital. Sin ese paso, no pueden abrir.
  • Se crea un grupo de acceso por reserva: si tenés cientos de reservas diarias, hablá con tu Business Unit sobre los límites de tu plan.
  • Las cerraduras Salto offline (sin IQ/gateway) actualizan permisos cuando el usuario pasa por un punto de actualización; el acceso no es instantáneo.
  1. Open the relevant screen Go to the section where this feature is configured.
  2. Review the required fields Fill in the data that Boris asks for in that screen.
  3. Save and verify Save the changes and check that the feature works as expected.